Reports
This chapter discusses reports you can prepare with CUBE Analyst. Topics include:
The Analyst reports described in this chapter are saved in a print (*.prn) file during program execution. The reports include:
- A listing of input parameters and options, and input binary header information.
- Mean, minimum, and maximum confidence levels set by the user for each type of input data are given.
- Memory requirements.
- A report of each iteration of the optimization process, during execution in interactive mode. This shows the current value of the objective function, the gradient tolerance, and the sum of all the estimated matrix elements. These values for the last five iterations are always reported.
- On completion, CUBE Analyst provides summary reports on the comparison between sets of input data and the corresponding estimated values, with the confidence levels that apply. Where relevant data is input to CUBE Analyst, these reports are produced giving comparisons for prior and estimated:
- Finally, Analyst provides a
return code indicating problems during execution, or a successful completion.
The codes are:
- 0 = Normal Termination
- 4 = Warning. Review the print file and find the (W) tag for information on the warning(s).
- 8 = Fatal Error, Non Immediate Termination. Review the print file for information on the error(s).
- 16 = Fatal Error, Immediate Termination. Review the print file for information on the error(s).
Further information may be obtained by using CUBE programs to report on the estimated matrix file.
For an estimation using part-trip data, the output network file contains detailed information on estimated part-trip link flows (equivalent to an assignment of the estimated Part Trip matrix).
CUBE Analyst reporting for hierarchic estimations
CUBE Analyst reporting for a hierarchic estimation varies according to whether the estimation is for a district or a local matrix. The reports for district estimation are the same as for other levels, except, of course, the results apply to districts rather than zones.
For local matrices, CUBE Analyst additionally provides summaries of the row and column side constraints from the district matrix, and equivalent values from the prior matrix. The first reported zone corresponds to the Rest-of-the-World (RoW), while the other reported zones are the set of zones relevant to that local matrix. No screenline reports are produced for local matrices.
The execution log file is output by the optimization step of CUBE Analyst, and three levels of report may be produced. These are controlled by the IREP parameter. The contents of the log file will not normally be of interest to general users, but are of assistance in summarizing the progress of the calculation should investigation be required.
This section contains examples of reports:
- Average confidence level
- Final five iterations
- Matrix totals and zone generation
- Zone attractions
- Average confidence level (part trip data)
- Part trip totals
- District matrix
- Local matrix
AVERAGE CONFIDENCE LEVELS (EXCLUDING ZERO VALUES) ------------------------------------------------- Average Maximum Minimum Number of Elements Trip matrix confidence levels 20.0 20.0 20.0 6724 Screen line confidence levels 95.0 200.0 80.0 16 Trip end (dest) confidence levels 47.8 80.0 40.0 82 Trip end (orig) confidence levels 47.8 80.0 40.0 82
SUMMARY OF FINAL FIVE ITERATIONS -------------------------------- Iteration Stepsize Objective Matrix (Tolerance= 0.0001) Value Total 149 0.0004152 -4735264.48 239547.4 150 0.0005055 -4735264.48 239548.6 151 0.0003342 -4735264.49 239550.3 152 0.0002368 -4735264.49 239551.0 153 0.0000781 -4735264.49 239551.0 Optimization halted after 153 iterations because: Convergence detected Final Value of Maximum Search Step, UMAX = 0.01
Matrix totals and zone generation
REPORTING PRIOR/ESTIMATED MATRIX TOTALS CONFIDENCE PRIOR ESTIMATED ESTM-PRIOR (ESTM-PRIOR)/PRIOR(%) 20.0 238498.0 239551.2 1053.2 0.4% REPORTING OBSERVED/ESTIMATED GENERATIONS AND ATTRACTIONS GENERATIONS ZONE NO CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 1 40.0 4869.0 4387.9 -481.1 -9.9% 2 40.0 3825.0 3763.3 -61.7 -1.6% 3 40.0 1798.0 2562.3 764.3 42.5% 4 40.0 419.0 386.7 -32.3 -7.7% 5 40.0 1256.0 1574.9 318.9 25.4% 6 40.0 2045.0 1743.0 -302.0 -14.8% 7 40.0 1935.0 1827.1 -107.9 -5.6% 8 40.0 1794.0 1904.4 110.4 6.2% 9 40.0 3662.0 3288.3 -373.7 -10.2% 10 40.0 430.0 381.3 -48.7 -11.3% 11 80.0 9200.0 9347.4 147.4 1.6% <continued>
ATTRACTIONS ZONE NO CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 1 40.0 3657.0 3586.4 -70.6 -1.9% 2 40.0 2984.0 3500.3 516.3 17.3% 3 40.0 5715.0 5556.7 -158.3 -2.8% 4 40.0 558.0 518.4 -39.6 -7.1% 5 40.0 2018.0 2162.9 144.9 7.2% 6 40.0 2084.0 1948.0 -136.0 -6.5% 7 40.0 2112.0 2129.7 17.7 0.8% 8 80.0 976.0 1030.0 54.0 5.5% 9 40.0 2673.0 2804.5 131.5 4.9% 10 40.0 0.0 0.0 0.0 n/a% 11 80.0 5665.0 5549.3 -115.7 -2.0% <continued> The trip end summaries can also be produced with the zone labels. Short zone labels are printed if NODLAB=T, LNGLAB=F: ATTRACTIONS ZONE NO,NAME CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 1 <Beaumont> 40.0 3777.0 3382.2 -394.8 -10.5% 2 <Cross_Ro> 40.0 3482.0 3441.1 -400.9 -10.4% 3 <Binley_S> 40.0 5815.0 5220.2 -594.8 -10.2% <continued> Long zone labels are printed if NODLAB=T and LNGLAB=T. The example below shows hierarchic zone numbers and long zone labels in the report: ZONE CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) NUMBER & NAME 28480 <Beaumont Avenue> 40.0 5069.0 5544.5 475.5 9.4% 28172 <Cross Roads, town centre> 40.0 4025.0 4392.2 367.2 9.1% 27848 <Binley Street> 40.0 1898.0 2076.7 178.7 9.4% <continued>
Average confidence level (part trip data)
AVERAGE CONFIDENCE LEVELS (EXCLUDING ZERO VALUES) ------------------------------------------------- Average Maximum Minimum Number of Elements Trip matrix confidence levels 10.0 10.0 10.0 1083 Screen line confidence levels 80.0 80.0 80.0 2 Trip end (dest) confidence levels 46.7 80.0 40.0 95 Trip end (orig) confidence levels 46.7 80.0 40.0 95 Part Trip confidence levels 7.0 7.0 7.0 594
This report is produced if option PRTTRP=T. For Public Transport data, the report is as follows: REPORTING OBSERVED/ESTIMATED PART TRIP FLOW TOTALS GROUP CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV (%) ALL 7.0 1386723.0 1232440.0 -154283.0 -11.1% 1 Local 7.0 624295.0 597702.1 -26592.9 -4.3% 2 Express 7.0 521925.0 532005.7 10080.7 1.9% For Highways data, the report is as follows: REPORTING OBSERVED/ESTIMATED PART TRIP FLOW TOTALS CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 20.0 1590478.0 1606103.8 15625.8 1.0%
REPORTING PRIOR/ESTIMATED MATRIX TOTALS CONFIDENCE PRIOR ESTIMATED ESTM-PRIOR (ESTM-PRIOR)/PRIOR(%) 20.0 238498.0 240291.2 1793.2 0.8% REPORTING OBSERVED/ESTIMATED GENERATIONS AND ATTRACTIONS GENERATIONS DISTRICT CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 1 40.0 14616.0 13368.5 -1247.5 -8.5% 2 40.0 48050.0 47995.1 -54.9 -0.1% 3 40.0 7855.0 7711.1 -143.9 -1.8% 4 40.0 40478.0 42008.8 1530.8 3.8% 5 40.0 62530.0 59877.4 -2652.6 -4.2% 6 40.0 15462.0 16832.4 1370.4 8.9% 7 40.0 18734.0 19158.2 424.2 2.3% 8 40.0 6744.0 6707.7 -36.3 -0.5% 9 40.0 26890.0 26631.9 -258.1 -1.0% ATTRACTIONS DISTRICT CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) 1 40.0 21562.0 22434.0 872.0 4.0% 2 40.0 43850.0 43476.7 -373.3 -0.9% 3 40.0 43963.0 44217.7 254.7 0.6% 4 40.0 21627.0 20809.8 -817.2 -3.8% 5 40.0 30926.0 30638.1 -242.9 -0.8% 6 40.0 37198.0 39445.7 2247.7 6.0% 7 40.0 8070.0 7973.4 -96.6 -1.2% 8 40.0 15332.0 16906.5 1574.5 10.3% 9 40.0 14423.0 14344.4 -78.6 -0.5% REPORTING OBSERVED/ESTIMATED SCREEN LINE COUNTS SCREENLINE CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV OBSV(%) NO OF ODs NO & NAME 1 A'shot Rd W-E 80.0 11677.0 11303.8 -373.2 -3.2% 244 2 A'shot Rd E-W 80.0 11677.0 11947.6 270.6 2.3% 244 <continued>
REPORTING SIDE CONSTRAINTS ON MATRIX TOTALS DISTRICT IN-PRIOR ESTIMATED ESTM-DISTRICT (ESTM-DISTRICT) CONSTRAINT /ZONAL(%) WITHIN DISTRICT 1506.2 958.0 1456.7 -49.5 -3.3% FROM DISTRICT 6204.9 6276.0 5966.2 -238.7 -3.8% TO DISTRICT 19303.5 16610.0 19181.9 -121.6 -0.6% NOT IN DISTRICT 213276.5 214654.0 214338.2 1061.7 0.5% MATRIX TOTAL 240291.2 238498.0 240943.0 REPORTING OBSERVED/ESTIMATED GENERATIONS AND ATTRACTIONS GENERATIONS ZONE NO CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) R-o-W 40.0 233504.0 233520.1 16.1 -0.0% 25 40.0 1557.0 1625.1 68.1 -4.4% 26 40.0 1753.0 1654.5 -98.5 -5.6% 27 40.0 378.0 338.8 -44.2 -11.7% 28 40.0 1535.0 1339.8 -195.2 -12.7% 55 40.0 211.0 232.5 21.5 10.2% 56 40.0 875.0 878.7 3.7 0.4% 60 40.0 268.0 296.6 28.6 10.7% 61 40.0 1278.0 1061.8 -216.2 -16.9% ATTRACTIONS ZONE NO CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV (ESTM-OBSV)/OBSV(%) R-o-W 40.0 215324.0 220304.4 4980.4 2.3% 30 40.0 2370.0 2431.7 91.7 3.9% 44 40.0 12392.0 11794.8 -597.2 -4.8% 48 80.0 1708.0 1757.0 49.0 2.9% 53 40.0 209.0 273.1 64.1 30.7% 72 80.0 4226.0 3691.0 -535.0 -12.7% 77 80.0 722.0 661.0 -61.0 -8.5% REPORTING OBSERVED/ESTIMATED SCREEN LINE COUNTS SCREENLINE CONFIDENCE OBSERVED ESTIMATED ESTM-OBSV OBSV(%) NO OF ODs NO & NAME 1 A'shot Rd W-E 80.0 11677.0 11459.1 -217.9 -1.9% 244 2 A'shot Rd E-W 80.0 11677.0 12580.3 903.3 7.7% 244
Note that as for standard estimations, short and long zone labels can be shown in the trip end reports. The label for the R-O-W (Rest-of-the World) will be left blank.