Overview of editing mode

After logging into Conveyal Analysis and selecting a project, you will arrive at the screen below. Each project has an expandable list of numbered scenarios followed by a list of modifications. To prevent data conflicts, the system does not allow multiple users or browser tabs to edit the same project simultaneously. If you expect multiple people in your organization to be using Conveyal Analysis at the same time, you may want to create projects for each of them, as suggested below.

Initial view in editing mode

Each modification represents a single operation on the baseline transport network (for example adding a line, or adjusting the speed of an existing line) and can be activated in multiple scenarios. To add a modification, click
Create a modification

This will open a window allowing you to select the modification type and enter a name. After confirming these details, you will be taken to a modification detail panel that varies by modification type.

Basic example

To create a sample modification, follow this quick-start guide:

  1. If you are not at the initial view in editing mode, with your project name at the top of the side panel, click this icon on the sidebar:
  2. Select a project or add a new one
  3. Click:
    Create a modification
  4. Leave “Add Trip” selected as the Modification Type, type “New Route Example” as the Modification Name, and confirm these options by clicking on the green button, which will create a modification and open the modification details panel for it
  5. In the modification details panel, click
    Edit route geometry
  6. On the map, click to add stops for the new route. More details on editing route alignments are here.
  7. In the modifications details panel, click:
    Add timetable
  8. Optionally, edit the default timetable parameters (e.g. set 5-minute headways for weekdays between 7 and 9 AM) and add additional timetables
  9. To save your changes and return to the main list of Modifications, click this icon at the top of the modification details panel:
  10. Add more modifications or proceed to analyze your scenario.

Usage suggestions and details

Modifications can be grouped by project and scenario, and different projects and scenarios can be compared against each other in analysis mode, giving you flexibility on how to use them. Depending on your use cases, different approaches may make sense.

If one user will be responsible for analyses in your region, involving a relatively small number of modifications, we recommend doing your work in one project and assessing the impact of different combinations of modifications by creating and using scenarios within that project.

If multiple users will be involved in editing scenarios, or if you want to assess more than 10 different combinations of modifications, which would make the list of scenarios annoyingly long, we recommend dividing the modifications among different projects. For example, one team member could code rail scenarios in Project A, another team member could code bus scenarios in Project B. Modifications can be imported between projects that use the same baseline GTFS bundle; in this example, modifications from the two projects could combined in a third Project C.

Toggling display of modifications on the map

In the list of modifications on the initial view in editing mode, clicking the title of a modification will open it and allow you to edit it. To control whether each modification is displayed on the map, click the visibility icon next to it ( / )

Stops and segments representing modifications are displayed on the map, using different colors to indicate their state relative to the baseline GTFS:

  • Blue: Added
  • Red: Removed
  • Purple: Changed (e.g. modified frequency, speed, or dwell time)
  • Gray: Unchanged

Projects start with only a Default scenario (plus a locked Baseline in which no modifications can be active). You can create additional scenarios expanding the list of scenarios, clicking the create button, and entering a name.

When the Scenario list is expanded, options next to each scenario allow you to:
Show on the map the modifications active in the scenario
Rename the scenario
Delete the scenario (not available for baseline or default scenario)

Activating modifications in scenarios

By default, each modification is active in all scenarios that exist when the modification is created. You can change which scenarios a modification is active in by using the checkboxes corresponding to scenario numbers at the bottom of the modification detail panel.

Choosing the scenarios in which a modification is active

Importing modifications

To import modifications from another project or a shapefile, click
Upload/import modifications

From another project

Occasionally, you may want to copy all of the modifications from one project into another. This may be useful to make a copy of a project, or to combine modifications developed by different team members into a single project (for instance, one team member working on rail changes and another on bus changes).

To do so, select a project in the upload/import panel and click

If you choose a project associated with the same GTFS bundle, all modifications will be imported; when there are multiple scenarios, the scenarios in the project being imported will be mapped directly to the scenarios in the receiving project (i.e. modifications in the first scenario will remain in the first scenario in the new project).

If you choose a project associated with a different GTFS, bundle, only add-trip modifications will be imported.

From Shapefiles

In general, it is best to create all modifications directly in Conveyal Analysis as it allows full control over all aspects of transit network design. However, on occasion, it may be desirable to import modifications from a GIS Shapefile. If you have a Shapefile containing lines, you can upload it to Conveyal Analysis and have it turned into a set of Add Trips modifications.

To do so from the upload/import panel, click

Then, after selecting and importing a zipped Shapefile, you will see the following:

Importing modifications from a Shapefile

There are several fields that must be filled in, corresponding to attributes (columns) in the Shapefile:

  • Name of each modification (e.g. route id).
  • Speed (in km/h)
  • Headway (in minutes)

Finally, as Shapefiles only contain the route geometry and not the stop locations, stops can be created automatically at a specified spacing. The generated stop positions may be individually edited after import, for example to place a stop at a major transfer point.

Manually edit raw modifications (beta)

By clicking on “Customize modification” in the details pane for any modification, advanced users can copy, paste, and edit its raw JSON data.