5.1 DaySim Input Preparation - Using Manual Methods

From NFTPO Model
Revision as of 13:42, 18 October 2016 by Gwineman (talk | contribs)

Jump to: navigation, search


This section describes the process of running programs and scripts to prepare various inputs required by DaySim, as well as the process of executing a model run.

Allocate TAZ Data to Parcels

A key data preparation step involved allocating TAZ-level controls to the parcels. A flexible tool has been developed in order to allow users to systematically and easily perform this allocation.

The figure below illustrates the allocation tool user interface.

FIGURE 5-1 ALLOCATION TOOL INTERFACE

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-1.png?version=1&modificationDate=1433180702207&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-1.png?version=1&modificationDate=1433180702207&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179736" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-1.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

If the user has a pre-generated xml input file, that can be used to populate inputs to the tool. To read an xml file, click on “Read XML Input File” button:

FIGURE 5-2 ALLOCATION TOOL INPUT

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-2.png?version=1&modificationDate=1433180702196&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-2.png?version=1&modificationDate=1433180702196&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179737" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-2.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

And navigate to the file:

FIGURE 5-3 ALLOCATION TOOL INPUT XML FILE DIALOG

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-3.png?version=1&modificationDate=1433180702160&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-3.png?version=1&modificationDate=1433180702160&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179738" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-3.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

After choosing a file, click “Open” and the input fields will be populated automatically. The inputs can be changed if required.

FIGURE 5-4 ALLOCATION TOOL INPUT SNAPSHOT

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-4.png?version=1&modificationDate=1433181166517&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-4.png?version=1&modificationDate=1433181166517&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179741" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-4.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

ALTERNATIVELY, the inputs can be entered manually as following:

First, choose a TAZ file

FIGURE 5-5 ALLOCATION TOOL INPUT TAZ FILE DIALOG

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-5.png?version=1&modificationDate=1433181256652&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-5.png?version=1&modificationDate=1433181256652&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179742" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-5.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

Once a TAZ file is chosen, data fields (columns) in the file would be displayed in the check box.

FIGURE 5-6 ALLOCATION TOOL TAZ SELECTION INTERFACE

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-6.png?version=1&modificationDate=1433181335442&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-6.png?version=1&modificationDate=1433181335442&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179743" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-6.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

The user then checks the boxes for the employment categories. In addition, the user selects the employment classification system that was used while creating the employment categories. The default is set to NAICS.

FIGURE 5-7 ALLOCATION TOOL TAZ COLUMN SELECTION INTERFACE

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-7.png?version=1&modificationDate=1433181454282&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-7.png?version=1&modificationDate=1433181454282&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179744" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-7.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

Once done, click OK button. This would open a new form asking the user to select associated NAICS/SIC codes (whichever is chosen before).

FIGURE 5-8 ALLOCATION TOOL INDUSTRY CODE MAPPING

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-8.png?version=1&modificationDate=1433181529713&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-8.png?version=1&modificationDate=1433181529713&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179745" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-8.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

After this, choose other input files (block file, MAZ geometry file, and school file) appropriately. All four input files are space delimited text files.

FIGURE 5-9 ALLOCATION TOOL INPUT SNAPSHOT

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-9.png?version=1&modificationDate=1433181679658&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-9.png?version=1&modificationDate=1433181679658&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179746" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-9.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

In the output section, in addition to pointing to output file, the user can also provide output employment categories and indicate associated NAICS codes.

FIGURE 5-10 ALLOCATION TOOL DAYSIM INDUSTRY CATEGORIES

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-10.png?version=1&modificationDate=1433181768526&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-10.png?version=1&modificationDate=1433181768526&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179747" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-10.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

By default, it is assumed that an input file has a header. If not then uncheck the header option. Once, the input and output files are selected, hit RUN to start the distribution process.

Prepare Buffered Parcel File

As mentioned previously, the executable for bringing up the buffering tool is “DSBuffTool.exe” and can be found in the “\User.prg\DaySim_Inputs\1_Parcel\Buffering\” folder of the master model directory. Double-clicking the executable will bring up a GUI as shown in the following figure. The use of this tool is straightforward. The user just needs to specify all the inputs and click on the “Run” button at the bottom of the GUI.

FIGURE 5-11 DAYSIM BUFFERING TOOL GUI

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-11.png?version=1&modificationDate=1433181867205&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-11.png?version=1&modificationDate=1433181867205&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179748" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-11.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

In the “INPUT” section of the GUI, distance calculation and buffer type are set to “Euclidean” and “Logistic decay” respectively. These are the recommended settings for running this tool. If node-to-node distances obtained from an all streets network are available, distance calculation may be set to “Node-to-Node”. The default recommended parameters for logistic decay weights (described in the model design chapter) such as buffer decay slope, offset etc., are also automatically populated in the appropriate fields in the GUI.

All other inputs are to specify file paths that can be done by clicking on the “Browse” button. This pops a file dialog as show in the figure below. The user may also enter full file paths manually using keyboard.

FIGURE 5-12 BUFFER TOOL FILE SELECTION DIALOG

<img class="confluence-embedded-image" src="/wiki/download/attachments/1179739/Figure%205-12.png?version=1&modificationDate=1433181952130&api=v2" data-image-src="/wiki/download/attachments/1179739/Figure%205-12.png?version=1&modificationDate=1433181952130&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="1179749" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="Figure 5-12.png" data-base-url="https://rsginc.atlassian.net/wiki" data-linked-resource-content-type="image/png" data-linked-resource-container-id="1179739" data-linked-resource-container-version="4">

All file specification fields for the tool are described below. Details about formats for the input files can be found in the directory and data structures chapter.

  • Parcel Data File: This is the base parcel file. It is obtained by running the disaggregation tool.
  • Intersection Data File: This file has the coordinates of intersections and the number of links intersecting at each one of them.
  • Transit Stops File: This file has the transit stop location coordinates by transit sub-mode.
  • Open Spaces File: This file has the locations and area of parks/open spaces in the model region.
  • Circuity Data File: This is only required for “Circuity” distance calculation that is now an obsolete method.

The following files are only needed for “Node-to-Node” distance calculation method.

  • Node Data File: This file contains the coordinates of node from an all streets network.
  • Node to Node Distance File: This file contains the network shortest path distances between a list of node pairs that are within 3 miles of each other. It is output from DTALite.
  • Extended Node File: This is an intermediate file created during the buffering process and contains base parcel data aggregated to the network node level. This is created after each parcel/microzone has been associated with the nearest network node.
  • Parcel-Node Correspondence File: This is an intermediate file created during the buffering process and contains the correspondence between parcels and nodes.
  • Intersection-Node Correspondence File: This is an intermediate file created during the buffering process and contains the correspondence between intersections and nodes.
  • Stop-Node Correspondence File: This is an intermediate file created during the buffering process and contains the correspondence between transit stops and nodes.
  • Open spaces-Node Correspondence File: This is an intermediate file created during the buffering process and contains the correspondence between open spaces and nodes.
  • Specification of the following XML files is optional. However, they store the input configuration of a buffering tool run and make it convenient to use the tool.

Output XML File: If a file is specified in this field, an XML file containing all the input information specified by the user is stored upon clicking on “Run” button that initiated the buffer process.

XML Input File: Once an XML file has been stored as described above, it can be selected to automatically populate all the input fields required for a buffer run. This can be used to re-run a buffer process with the same inputs or modify a few inputs to generate a different buffered parcel file.

Finally, Buffered Output File field is used to specify the location and name of the buffered parcel/microzone output file that needs to go into DaySim inputs folder.