Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Specify grid limits #86

Merged
merged 4 commits into from
Mar 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/analysis/regional.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ If you select a freeform (non-grid) origin pointset, results can be downloadable
### Select destinations and run analysis

Select at least one Destination opportunity layer:
* When using grid spatial datasets as destinations, you may specify several grids. They may be of different sizes and shapes (but must all be at the same zoom level).
* When using grid spatial datasets as destinations, you may specify several grids. They may be of different sizes and shapes (but must all be at the same zoom level). In each grid, the number of cells is limited to a maximum of 5 million, and the number of opportunities is limited to a maximum of 2 billion.
* When using freeform spatial datasets as destinations in a regional analysis, you can specify only a single layer for now. The maximum number of freeform destination points is 4 million (and the maximum number of freeform origin-destination pairs is 16 million). Grid and freeform destinations cannot yet be mixed.

Ensure the list of travel time cutoffs and percentiles will cover the results you want. For example, if you want a travel time matrix to include trips up to 120 minutes, ensure that 120 is included as a cutoff; any travel times exceeding the maximum cutoff will be clipped and recorded as -1.
Expand Down Expand Up @@ -133,4 +133,4 @@ In the example below, the baseline scenario is shown in blue and an alternative

In the baseline, the 10th percentile household (marked by the leftmost vertical line) has access to fewer than 50 thousand jobs, while in the alternative scenario, the 10th percentile household (the second vertical line) has access to more than 141 thousand jobs. The large increase at the lower end of the distribution suggests the alternative scenario could help advance more equitable access to jobs.

Finally, Conveyal displays weighted mean accessibility, which represents the average accessibility experienced by residents (or whatever unit you have weighted by) in the aggregation area. Aggregate accessibility is often bimodal or skewed with a long right tail. In such cases, a substantial majority of the population may experience accessibility values well below the mean, so we generally recommend reporting different percentiles of aggregate accessibility rather than the mean.
Finally, Conveyal displays weighted mean accessibility, which represents the average accessibility experienced by residents (or whatever unit you have weighted by) in the aggregation area. Aggregate accessibility is often bimodal or skewed with a long right tail. In such cases, a substantial majority of the population may experience accessibility values well below the mean, so we generally recommend reporting different percentiles of aggregate accessibility rather than the mean.
4 changes: 2 additions & 2 deletions docs/edit-scenario/modifications.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -255,12 +255,12 @@ Custom modification types allow experimenting with certain features that are not
This modification type allows modeling on-street modes that serve defined zones with specified service levels, such as shared scooters or ridehail services. It requires an uploaded geojson polygon [data source](/prepare-data) with `id` and `wait` (in minutes) attributes for each feature. For example, within a polygon with `id: "Downtown"` and `wait: 10`, the routing engine would allow people starting journeys in the "Downtown" polygon to wait 10 minutes then proceed by car. Custom JSON settings allow setting different modes, default wait times, designated transit stops for pickup/dropoff, etc. For example, if your uploaded data source has a pickup/drop-off zone polygon (`ArtesiaZone`) and two station zone polygons that are buffers around fixed-route transit stops (`AvalonStation` and `ComptonStation`), you can add this to the custom JSON:

```
"stopsForZones":{"ArtesiaZone":["AvalonStation","ComptonStation"]}
"stopsForZone":{"ArtesiaZone":["AvalonStation","ComptonStation"]}
```

This setting will prevent point-to-point travel in the Artesia zone, and only allow on-demand rides as first-/last-mile connections to fixed-route transit at the stops in the two specified station zones.

For more details and other custom configuration options, see the [R5 source code](https://github.com/conveyal/r5/blob/v6.6/src/main/java/com/conveyal/r5/analyst/scenario/PickupDelay.java) or contact your support team.
For more details and other custom configuration options, see the [R5 source code](https://github.com/conveyal/r5/blob/v7.1/src/main/java/com/conveyal/r5/analyst/scenario/PickupDelay.java) or contact your support team.

#### Road congestion
This modification type lets you set a scale factor for car speed within features of a geojson polygon [data source](/prepare-data). It requires an uploaded geojson polygon data source with `scale` and `priority` attributes for each feature. For example, within a polygon with `name: "Downtown"`, `scale: 0.60`, and `priority: 1`, default car speeds in the "Downtown" polygon would be multiplied by 0.60. Custom JSON settings allow overriding the default attribute names, setting a default scaling value to be applied outside of the supplied polygons, etc. For more details, see the [R5 source code](https://github.com/conveyal/r5/blob/v6.6/src/main/java/com/conveyal/r5/analyst/scenario/RoadCongestion.java) or contact your support team.
Expand Down
1 change: 1 addition & 0 deletions docs/prepare-inputs/upload-spatial-data.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ Saved datasets can be displayed as a dot-density map. These maps represent relat
### Troubleshooting
Certain limits on spatial uploads help ensure reasonable computation:
- The maximum number of grid cells is 5 million. If you encounter this limit, consider cropping the dataset to the region of interest or using a lower zoom level (see the table of approximate geodetic distances and size limits for different zoom levels [here](/analysis/methodology#zoom-levels)).
- The maximum number of opportunities in a layer is 2 billion.
- The maximum size of any single feature in the dataset source is 2 square degrees (roughly 20k sq. km. at the latitude of Melbourne or 25k sq. km. at the equator).

If you encounter other errors, additional troubleshooting suggestions are [here](/troubleshooting#problems-with-uploaded-files).
Expand Down