Skip to content

Modeling with Macroscopic Tools

Note about licenses: These exercises require a license for Aimsun Next Advanced, Expert, or Pro TDM Editions.


In these exercises, we will become familiar with some of Aimsun Next's macroscopic modeling tools. We will begin by assigning an OD matrix to a network to see how the flow distribution is assigned and how results are obtained. Next we will adjust the OD matrix by using real data from detectors. Then we will define a subnetwork for which we will obtain a traversal OD matrix. Finally, we will study an example of how to balance an OD matrix using the Furness method.

The backup copies of the files related to this exercise are in [Aimsun_Next_Installation_Folder]/docs/tutorials/6_Macroscopic_Modelling.

Exercise 1. Assigning an OD Matrix to a Network

1.1 Setting up the scenario and experiment

For this exercise, the traffic demand Traffic Demand – Mat is already defined and contains two OD matrices, one for cars and another for trucks. We will add this demand to the scenario.

To set up the scenario and experiment:

  1. Open Initial_Macroscopic_Modelling.ang.

  2. In the Project folder, right-click Scenarios > New > Static Assignment Scenario.

  3. Open the new scenario.

  4. For Traffic Demand, select Traffic Demand – Mat.

  5. For Transit Plan, select Transit-Plan Work Day. This means that the additional fixed volume that Transit vehicles represent will be included in the assignment calculations.

  6. Right-click the scenario and select New Experiment, select the Frank and Wolfe Assignment type, and click OK.

  7. Open the experiment and for Maximum Iteration, enter 50, and for Relative Gap, enter 0.1000.

  8. To create a path assignment object to save the paths from the static assignment, right-click Demand Data > New > Path Assignment.

    We might want to use the saved paths later in other dynamic scenarios (see for example the exercises in the Integrating tutorial).

  9. Rename the new object Path Assignment Static.

  10. To link the path assignment object to the static assignment experiment, open the experiment, tick Path Assignment and, from the Path Assignment drop-down list, select Path Assignment Static.

  11. To run the simulation, right-click the experiment and select Run Static Traffic Assignment.

1.2 Viewing the outputs

When the simulation finishes, the results dialog is displayed.

The first results are assigned vehicle volumes and they are displayed in the 2D view, as shown below.

The values displayed on each section for the vehicle type All are the assigned section volumes in PCUs (passenger car units), where different sizes of vehicles are assigned different equivalent car weightings.

For example, 1596 PCUs are assigned to exit the network at the Sants centroid. In the matrices, there are 1300 cars and 140 trucks:

1300 * 1 PCU + 140 * 1.9 PCU = 1566 PCU

The assigned volume is 1596 and not 1566 because there are 12 buses in this section, which are weighted at 2.5 PCUs each. This accounts for the extra 30 PCUs.

The PCU weighting of each vehicle type is defined, and can be changed, in the Vehicle Type dialog on the Static Models tab.

The width of the colored bars in the 2D view also indicates the volume assigned to sections. The color scaling indicates the ratio of volume:capacity for each section. The more congested sections are those with darker colors.

To view more results:

  1. To view the volume and travel times per section and per vehicle type, click the Outputs tab and then the Sections subtab.

  2. Click the Turns subtab to view section-to-section turn percentages and volumes.

  3. Change the User Class from All to Cars or Trucks to filter the results.

  4. Click the Path Assignment tab to view all the paths used in the assignment by vehicle type.

  5. To view specific paths, for Origin Centroid, select Sants and for Destination Centroid, select BCN-N.

  6. Tick List Paths to display the paths in the 2D view.

  7. Double-click on a path to display more information.

    Instead of single centroids, you can use groups of centroids to analyze the paths. These groups are already defined in the network.

  8. For Destination Centroid, select BCN Center – Grouping as shown below.

  9. Select a road section from the Sections drop-down list.

  10. Click Link Analysis to display a map that shows the paths of vehicles that pass through this particular section. The 2D view shows the routes leading to and from that link.

  11. Try other selections, filtering by centroid and by user class to better understand the paths chosen by vehicles.

  12. To add multiple sections, click the plus (+) button.

  13. Select AND or OR to specify how to combine the sections:

    • AND analyzes paths which use a stream of sections
    • OR has the effect of analyzing with a screenline.
  14. To remove sections, click the minus () button.

Exercise 2. Adjusting an OD Matrix

In this exercise we will adjust an OD matrix based on real data for the time period. We will use a CSV file that contains detection data for a period of one hour, collected every half hour.

The file contains data from the detectors in the model named d1 to d7. The screenshot below shows the location of the seven detectors.

2.1 Loading the real data set

First, we will load the CSV file as our real data set and view its time series. The file is detectorsMM.csv and uses the format: name, time, vehicle, count.

To load the real data set:

  1. In the Project folder, right-click Data Analysis > New > Real Data Set to create a new Real Data Set object.

  2. Open the real data set and click Add. The following dialog is displayed.

  3. Click OK to accept the Real Data Simple File Reader.

  4. In the Real Data Set dialog, double-click Real Data Simple File Reader in the Retrievers group box. The data reader dialog is displayed. Use the screenshot below as a guide for the next steps.

  5. In File, locate the file detectorsMM.csv.

  6. Choose the ID to be the Name and set the Object Type to Detector.

  7. Input an Initial Date of 16/04/2015 and Initial Time 08:00:00.

  8. Click Add four times to add four new items to the Columns group box.

  9. For items 3 and 4, double-click in Type and select Vehicle and Count respectively.

  10. Click OK to return to the Real Data Set dialog.

  11. Click Retrieve to load the data.

  12. To check that the detection data has been correctly loaded, double-click on detector d1 in the 2D view.

  13. Click the Time Series tab folder and click Variables.

  14. For the Y axis, select Count and Real Data Set.

  15. Click Graph to view the plot as shown below.

    To return to the tabulated figures, click the table icon .

2.2 Creating the static OD adjustment scenario and experiment

With the real data loaded, we can create the scenario and experiment.

To create the static OD adjustment scenario and experiment:

  1. In the Project folder, right-click Scenarios > New Static OD Adjustment Scenario.

  2. Open the new scenario and input the parameters shown below.

  3. Create a new experiment for the scenario and select the Frank and Wolfe assignment method when prompted.

  4. Enter the iteration parameters, using the screenshot below as a guide, and click OK.

  5. Right-click the experiment and select Run Static OD Adjustment.

2.3 Viewing the results

When the experiment is completed, the results will be available in the Static OD Adjustment Experiment dialog.

To view the results:

  1. Click the Outputs tab and then the Trips subtab to see original demand vs adjusted demand, as shown below.

  2. Click the Validation tab to compare the observed counts with the assignment of the adjusted matrices, as shown below (use the nearby icons to view line graph, regression graph, and table).

  3. If the validation is satisfactory, generate the matrices and corresponding demand by clicking Create Demand and Matrices. This creates a new traffic demand that contains the adjusted matrices.

  4. To use these new matrices, create a new static assignment scenario and assign the new traffic demand to it.

  5. Create a new experiment for this scenario.

  6. Run the experiment and observe the new flows.

Exercise 3. Calculating Traversal Matrices

In this exercise, we will calculate traversal matrices (car and truck) for a subnetwork, using, initially, the matrix we generated for the whole model. We will then add traffic demand to the subnetwork, using the newly generated matrices.

3.1 Creating the subnetwork

The first step is to create the subnetwork as shown in the screenshot below.

To create the subnetwork:

  1. Click .

  2. Draw the polygon by clicking its vertices at the required points. To finish and close the polygon, double-click to add the final point.

  3. Click on the polygon in the 2D view to highlight it and then right-click Convert to > Subnetwork. A subnetwork object is added to the Subnetworks folder.

    After creating a subnetwork it is helpful to add a filter so that the area outside the subnetwork is drawn in semi-transparent mode.

  4. Right-clicking on the 2D view and select Filters > Subnetwork.

3.2 Generating the traversal matrix

To generate the traversal matrix:

  1. In the Subnetworks folder, right-click on the new subnetwork and select Generate Static Traversal. The Generate Static Traversal dialog is displayed.

  2. For Assignment Experiment, select an available pre-run experiment. This will provided the flow information used to generate the traversal matrix.

  3. Click OK. The traversal matrix (or matrices) will be added to the subnetwork in the Projects folder, inside the Centroid Configurations folder.

The centroid configuration of the subnetwork is now the active one. An active centroid configuration always appears with its icon highlighted in blue .

All non-graphical objects belonging to this subnetwork (Scenario, Traffic Demand, Path Assignment, etc.) can now be created from its context (right-click) menu. We will do so in Exercise 4. Some objects have already been created and added to the subnetwork, as shown below.

3.3 Running a static assignment scenario

Now we will create and run a static assignment scenario using the new traversal matrices.

To run a static assignment scenario:

  1. In the Project folder, right-click on the subnetwork and select New > Scenarios > Static Assignment Scenario.

  2. Open the new scenario and, for Traffic Demand, select the subnetwork's Traffic Demand object. This contains the traversal matrices.

  3. Add a new experiment to the scenario.

  4. Run the experiment. The visual results of the assignment are shown below.

Exercise 4. Balancing the Matrices

In this concluding exercise, we will use the Furness method to balance the traversal matrices for cars and trucks we generated in Exercise 3. Depending on the source, age, and quality of your demand data in a project, you might need to balance matrices to produce more accurate counts.

Note: Exercise 4.1 relates to the car matrix only. Repeat the same steps for the truck matrix also, so that you have two balanced matrices at the end.

4.1 Copying and balancing the matrix

Because all operations performed on a matrix ‘rewrite’ it when we click OK, we will make a copy of the matrix first.

To copy and balance the matrix:

  1. Right-click on Traversal: Car and select Duplicate.

  2. Rename the copy Balanced Traversal: Car – 08:00:00 01:00:00.

  3. Open the copied matrix and, in the Operation drop-down list, select Furness.

  4. Edit the new totals for the Hospi centroid as shown below. Make sure that the attraction and generation totals match.

  5. Click Execute to run the operation. A pop-up confirmation will be displayed when the process is complete. As you can see in the screenshot below, the cells of the matrix have changed so that the F Totals by origins and destinations match the totals we provided.

4.2 Running a simulation with the balanced matrices

To finish this exercise, we will run a simulation of the subnetwork using a new traffic demand with the balanced matrices.

To run a simulation with the balanced matrices:

  1. Right-click the subnetwork and select New > Traffic Demand.

  2. Open the new Traffic Demand object.

  3. Click Add Demand Item and select the balanced car and truck traversal matrices.

  4. Click OK.

  5. Right-click on the subnetwork and select New > Scenarios > Dynamic Scenario.

  6. Open the new scenario and, for Traffic Demand, select the newly created demand.

  7. Add a new experiment and a new replication to the scenario.

  8. Right-click on the replication and select Run Animated Simulation (Autorun).

Check the simulation to see the results, using the adjusted traversal matrices.