Web App Operation Manual
1. Introduction
1.1 Purpose of this manual
Learn how to use the Optimal Shared Mobility Deployment demo application.
1.2 Prerequisites
- Have a FUJITSU Research Portal account
- Internet access
1.3 System Requirements
- Recommended browser: Chrome
- Caution
- Not available in environments where WebGL does not work (such as virtual desktops)
2. Procedure
Log in to the demo screen
From the FUJITSU Research Portal, select Technology Browser - Optimal Shared Mobility Deployment.
You can use the Service by clicking the Try Demo App button at the bottom of the page. The top screen of Optimal Shared Mobility Deployment is shown below.
Running the simulation
Click the Run New Digital Rehearsal button.
The simulation setting screen is displayed. Set the parameters you want to customize and click Run Digital Rehearsal.
The screen changes to the simulation list screen, the simulation you just ran is added to the list, and an hourglass icon appears to indicate that it is running.
When the simulation is complete, the hourglass icon is disappeared.
Click anywhere in the simulation list other than the trash can icon and the check box to switch to the simulation results screen.
Move the slider at the bottom of the map to see how people move over time.
Click the three-line icon in the upper left, and then click Digital Rehearsals to return to the simulation list screen.
Now let's change the parameters of the simulation and run it. Click the Run New Digital Rehearsal button. Run Digital Rehearsal was performed with purpose2 set as shown.
Wait for completion.
Let's compare the results of the two simulations. Check the check box in the simulation list.
Click the Compare 2 digital rehearsals button.
The results of the two simulations are displayed side by side. Drag the slider in the lower Timeline to see how people move over time in both simulations. You can return to the simulation list screen from the three-line icon in the upper left.
3. Procedure - Using File Upload to Change the Target City for Digital Rehearsal
PREPARATION
To change a city, you need to create the following files and information for that city: For details on how to create them, refer to Data Generation Manual
- SUMO net file (map.net.xml.gz)
- OD file that defines the movement of people (od.csv.gz)
- File of the station where the scooter is to be lent/returned (stations.csv)
- Parameter list (precondition.json)
- Map center coordinates (latitude and longitude)
- Currency symbol
- Currency conversion rate from £
File Registration
Log in to the demo app in your browser.
Click the Upload Data Files button to enter the data upload screen.
In the Select File to Upload dialog box, click Select and upload all map.net.xml.gz, od.csv.gz, stations.csv, and precondition.json.
precondition.json format
The precondition.json has the following format.
If you select all files and upload at the same time, simdataId beginning with simdata-your-simdataId will be replaced by the simdataId of the corresponding file to be uploaded at the same time.
{
"USECASE": "dynamic-discount",
"ASSIMIL_PERSON_FILE": "simdata-272c8229-5a50-48c1-b0db-771c46e3b5d3/od.csv.gz",
"SOARS_STATIONS_FILE": "simdata-33a299f3-5c00-4361-847e-346f3ede6abf/stations.csv",
"SUMO_NET_FILE": "simdata-4467079a-fbd0-440e-8505-a8c518e94562/map.net.xml.gz",
"DMM_MODEL_INFO_FILE": "simdata-feaf5067-43c2-4673-a229-43e0d7d5dc6d/model.json",
"MAP_CENTER_LATITUDE": "35.58",
"MAP_CENTER_LONGITUDE": "139.64",
"CURRENCY_SYMBOL": "￥",
"CURRENCY_RATE": "186.0",
"START_HOUR": "5",
"END_HOUR": "6"
}
| Key | Value example | Description |
|---|---|---|
| USECASE | "dynamic-discount" | Specifies the use case for which you want to digitally rehearse. You can specify "dynamic-discount". |
| ASSIMIL_PERSON_FILE | "simdata-272c8229-5a50-48c1-b0db-771c46e3b5d3/od.csv.gz" | Specify the registered OD file by simdataId/filename. |
| "simdata-your-simdataId-of-od/od.csv.gz" | If you upload a file that name starts with od at the same time, this value will be replaced with simdataId/filename of that file. |
|
| SOARS_STATIONS_FILE | "simdata-33a299f3-5c00-4361-847e-346f3ede6abf/stations.csv" | Specify the initial deployment file of the E-scooter for the registered station by simdataId/filename. |
| "simdata-your-simdataId-of-stations-csv/stations.csv" | If you upload a file that name starts with stations at the same time, this value will be replaced with simdataId/filename of that file. |
|
| SUMO_NET_FILE | "simdata-4467079a-fbd0-440e-8505-a8c518e94562/map.net.xml.gz" | Specify the registered SUMO net file by simdataId/filename. |
| "simdata-your-simdataId-of-net-file/map.net.xml.gz" | If you upload a file that name starts with map at the same time, this value will be replaced with simdataId/filename of that file. |
|
| DMM_MODEL_INFO_FILE | "simdata-feaf5067-43c2-4673-a229-43e0d7d5dc6d/model.json" | Specify simdataId/filename if you want to use a registered arbitrary behavior selection model file. |
| "simdata-your-simdataId-of-model-file/model.json" | If you upload a file that name starts with model at the same time, this value will be replaced with simdataId/filename of that file. |
|
| MAP_CENTER_LATITUDE | "35.584" | Specifies the latitude of the center when the map is displayed. Optional. If omitted, 35.584 is assumed. |
| MAP_CENTER_LONGITUDE | "139.645" | Specifies the longitude of the center when the map is displayed. Optional. If omitted, 139.645 is assumed. |
| MAP_ZOOM | "10" | Specifies the zoom when the map is displayed. When digital rehearsal results are displayed, the zoom is MAP_ZOOM * 0.95. Optional. The default value is 16 for road-closure or road-pricing and 10 otherwise. |
| CURRENCY_SYMBOL | "￥" | Specifies the currency unit notation. Optional. The default is "￥". |
| CURRENCY_RATE | "186.0" | Specifies the currency rate from £. If omitted, 186.0 is assumed. |
| START_HOUR | "5" | Specifies the start time of the digital rehearsal (in hours). Minimum 5, maximum 23. If omitted, 5 is assumed. The start time can be changed on the digital rehearsal creation screen. |
| END_HOUR | "6" | Specifies the end time of the digital rehearsal (in hours). Minimum 6, maximum 24. If omitted, START_HOUR+1 is assumed. The end time can be changed on the digital rehearsal creation screen. |
Digital rehearsal execution
Click the play icon on the far right of precondition.json to go to the digital rehearsal creation screen.
You can change parameters, etc.
Click the Run Digital Rehearsal button to start the digital rehearsal.
Digital rehearsal by changing only some input files
This example shows how to perform a digital rehearsal by modifying only stations.csv.
Download the precondition.json registered above from the digital rehearsal input data screen. You can download by using the icon to the left of the trash can icon.
Edit SOARS_STATIONS_FILE in precondition.json as follows:
{
"USECASE": "dynamic-discount",
"ASSIMIL_PERSON_FILE": "simdata-272c8229-5a50-48c1-b0db-771c46e3b5d3/od.csv.gz",
"SOARS_STATIONS_FILE": "simdata-your-simdataId-of-stations-csv/stations.csv",
"SUMO_NET_FILE": "simdata-4467079a-fbd0-440e-8505-a8c518e94562/map.net.xml.gz",
"MAP_CENTER_LATITUDE": "35.58",
"MAP_CENTER_LONGITUDE": "139.64",
"CURRENCY_SYMBOL": "￥",
"CURRENCY_RATE": "186.0",
"START_HOUR": "10",
"END_HOUR": "12"
}
Nothing else needs to be changed. The above is an example, so it differs from the actual simdataId.
Register two files at the same time: precondition.json and stations.csv. By clicking the play icon of the registered precondition.json, you can perform digital rehearsal with only stations.csv changed.
Note that if the file name in stations.csv starts with station and csv is the extension, simdataId will be replaced. The file name conditions for the simdataId substitution are shown in the following table.
| File | Condition |
|---|---|
| od.csv.gz | Must begin with od and have extension csv.gz or csv |
| stations.csv | Must begin with station and have csv extension |
| map.net.xml.gz | Must begin with map and have an extension of xml.gz or xml |
| model.json | Must begin with model and have json extension |
4.Procedure - Run a simulation of each Usecase
4.1 Use Case: Dynamic Discount
Overview
It is a use case where people have the option of driving, walking, or scooter to get to a destination, and each person chooses the means of transportation depending on the cost and time, and then rehearses digitally. When renting an scooter, discounts based on the status of the scooter station will impact costs and change people's transportation choices. That way, you can see what the changes to scooter utilization and user fee revenue are. You can also modify the initial deployment of the scooter.
Log in to the demo screen
From the FUJITSU Research Portal, select Technology Browser - Optimal Shared Mobility Deployment.
Running the simulation
Click the "..." button.
Select the Usecase simulation you want to run.
The simulation setting screen is displayed. Set the parameters you want to customize and click Run Digital Rehearsal.
4.2 Use Case: Road Closure
Summary
It is a use case in which a person has the option of driving, walking, biking, or scooter to get to a destination, and each person chooses the means of transportation depending on the cost and time, and rehearses it digitally. By closing roads by time of day for each mode of travel, travel routes change, affecting travel times and changing people's choice of mode of travel.
As with the dynamic discount and initial deployment use cases, you can also see the impact of:
- When renting an scooter, discounts based on the status of the escooter's station will impact costs and change people's transportation choices. That way, you can see what the changes to scooter utilization and user fee revenue are.
- You can also modify the initial deployment of the scooter, similar to the initial deployment use case.
Trucks also exist as a means of transportation. However, the truck will always appear in the digital rehearsal as someone who travels by truck, rather than as a mode of transportation of choice.
Running the simulation
Click the "..." button.
Select the Usecase simulation you want to run.
The simulation setting screen is displayed. Set the parameters you want to customize and click Run Digital Rehearsal.
How to set the polygon (road closures)
Click the icon displayed in the tooltip to enter Polygon Settings mode. On the map, click a vertex in the range you want to specify as a polygon, and then double-click to set the polygon and set the polygon to the Road Closure Parameters.
You can change the duration of the closure by changing the Start and End. Prohibited modes of travel change Type. Polygon can be moved by clicking and selecting polygon on the map. You can edit the polygon by clicking it again and dragging or deleting vertices and midpoints.
To delete a polygon, select the polygon on the map and click the trash can icon below the polygon settings icon.
To add a polygon, click the Polygon Settings icon to set the polygon.
4.3 Use Case: Road Pricing
Summary
It is a use case in which a person has the option of driving, walking, biking, or scooter to get to a destination, and each person chooses the means of transportation depending on the cost and time, and rehearses it digitally. By charging roads by time of day for each mode of travel, costs are affected, and when detours are made, travel times are affected, and people's choice of mode of travel is changed.
As with road closures, dynamic discounts, and initial deployment use cases, the following impacts can also be observed:
- By closing roads by time zone for each mode of travel, travel routes change, affecting travel times and changing people's choice of mode of travel.
- When renting an scooter, discounts based on the status of the scooter's station will impact costs and change people's transportation choices. That way, you can see what the changes to scooter utilization and user fee revenue are.
- You can also modify the initial deployment of the scooter, similar to the initial deployment use case.
Trucks also exist as a means of transportation. However, the truck will always appear in the digital rehearsal as someone who travels by truck, rather than as a mode of transportation of choice.
Running the simulation
Click the "..." button.
Select the Usecase simulation you want to run.
The simulation setting screen is displayed. Set the parameters you want to customize and click Run Digital Rehearsal.
How to set the polygon (road closures, road pricing)
Click the icon displayed in the tooltip to enter Polygon Settings mode. On the map, click a vertex in the range you want to specify as a polygon, and then double-click to set the polygon and set the polygon to the Road Pricing Parameters.
You can change the billing period by changing Start and End. The transportation to be charged is set by Type. The charge is set by Price. If Price is 0, the road is closed. Polygon can be moved by clicking and selecting polygon on the map. You can edit the polygon by clicking it again and dragging or deleting vertices and midpoints.
To delete a polygon, select the polygon on the map and click the trash can icon below the Polygon Settings icon.
To add a polygon, click the Polygon Settings icon to set the polygon.
4.4 Use Case: Park and Ride
Summary
This is a use case where people can choose to travel to a destination by car, by foot, by escooter, by bicycle, or by a public common authority, and then digital rehearsal each person's choice of transportation based on cost and time.
By installing a parking lot, transferring to public transport becomes an option, affecting costs and travel times, and changing people's choice of transportation.
As with the dynamic discount and initial deployment use cases, you can also see the impact of:
- When renting an scooter, discounts based on the status of the escooter's station will impact costs and change people's transportation choices. That way, you can see what the changes to scooter utilization and user fee revenue are.
- You can also modify the initial deployment of the scooter, similar to the initial deployment use case.
As for public transportation, some of the trains and buses that operate in Kawasaki City support it.
The demo use case corresponds to the area around Nakahara Ward(Kawasaki-City, Kanagawa).
Running the simulation
Click the "..." button.
Select the Usecase simulation you want to run.
The simulation setting screen is displayed. Set the parameters you want to customize and click Run Digital Rehearsal.
Setting method of parking lot (Use Case: Park and Ride)
You can place a parking lot by clicking where you want to place it. You can also drag to change the location. You can also click x to cancel placement.
To set up the parking area, go to "Placement of parking area" in the upper left corner.
You can set the type of parking allowed (car or bicycle), the price, and the number of parking allowed.
If you set the number of cars that can be parked to 0, the parking lot will not be used.