Changeset 20908 in osm for applications/editors/josm/plugins/public_transport
- Timestamp:
- 2010-04-14T18:21:45+02:00 (15 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
applications/editors/josm/plugins/public_transport/resources/public_transport.html
r20897 r20908 24 24 <p> 25 25 <a href="#chapter.introduction">Introduction</a><br/> 26 <a href="#section.installation">How to Install</a><br/> 27 <a href="#chapter.tutorial">Examples how to Use</a><br/> 28 <a href="#section.scratch">Map a Bus Line from Scratch</a><br/> 29 <a href="#section.parallel">Reuse a partly parallel line</a><br/> 30 <a href="#section.legacy">Reuse an Old Relation</a><br/> 31 <a href="#chapter.notions">Used Notions</a><br/> <a href="#chapter.stops_from_gpx">Create Stops from GPX</a><br/> 26 <a href="#section.installation">How to Install</a><br/> 27 <a href="#chapter.tutorial">Examples how to Use</a><br/> 28 <a href="#section.map_waypoints">Map Stops from Waypoints</a><br/> 29 <a href="#section.map_stopwatch">Map Stops with a Tracklog and a Stopwatch</a><br/> 30 <a href="#section.map_tracklog">Map Stops with a Tracklog only</a><br/> 31 <a href="#section.scratch">Map a Bus Line from Scratch</a><br/> 32 <a href="#section.parallel">Reuse a partly parallel line</a><br/> 33 <a href="#section.legacy">Reuse an Old Relation</a><br/> 34 <a href="#chapter.notions">Used Notions</a><br/> 35 <a href="#notion.clipboard">clipboard</a><br/> 36 <a href="#notion.entry">entry</a><br/> 37 <a href="#notion.gpx_file">GPX file</a><br/> 38 <a href="#notion.itinerary">itinerary</a><br/> 39 <a href="#notion.line">line</a><br/> 40 <a href="#notion.mark">mark</a><br/> 41 <a href="#notion.network">network</a><br/> 42 <a href="#notion.node">node</a><br/> 43 <a href="#notion.oxmoa">Oxmoa scheme</a><br/> 44 <a href="#notion.bus_route">public transport route</a><br/> 45 <a href="#notion.relation">relation</a><br/> 46 <a href="#notion.route_type">route type</a><br/> 47 <a href="#notion.select">select</a><br/> 48 <a href="#notion.stop">stop</a><br/> 49 <a href="#notion.track">track</a><br/> 50 <a href="#notion.way">way</a><br/> 51 <a href="#chapter.stops_from_gpx">Create Stops from GPX</a><br/> 32 52 <a href="#section.tracks">Tab <em>Tracks</em></a><br/> 53 <a href="#subsection.tracks.list">List <em>Tracks in this GPX file</em></a><br/> 33 54 <a href="#section.settings">Tab <em>Settings</em></a><br/> 55 <a href="#subsection.settings.type">Combo box <em>Type of stops to add</em></a><br/> 56 <a href="#subsection.settings.gps">Text field <em>Time on your GPS device</em></a><br/> 57 <a href="#subsection.settings.stopwatch">Text field <em>Time on your stopwatch</em></a><br/> 58 <a href="#subsection.settings.time_window">Text field <em>Time window</em></a><br/> 59 <a href="#subsection.settings.threshold">Text field <em>Move Threshold</em></a><br/> 60 <a href="#subsection.settings.suggest_stops">Button <em>Suggest Stops</em></a><br/> 34 61 <a href="#section.trackstops">Tab <em>Stops</em></a><br/> 62 <a href="#subsection.trackstops.list">List of created stops</a><br/> 63 <a href="#subsection.trackstops.find">Button <em>Find</em></a><br/> 64 <a href="#subsection.trackstops.show">Button <em>Show</em></a><br/> 65 <a href="#subsection.trackstops.mark">Button <em>Mark</em></a><br/> 66 <a href="#subsection.trackstops.detach">Button <em>Detach</em></a><br/> 67 <a href="#subsection.trackstops.add">Button <em>Add</em></a><br/> 68 <a href="#subsection.trackstops.delete">Button <em>Delete</em></a><br/> 69 <a href="#subsection.trackstops.sort">Button <em>Sort</em></a><br/> 35 70 <a href="#section.waypoints">Tab <em>Waypoints</em></a><br/> 71 <a href="#subsection.waypoints.list">List of waypoints in the file</a><br/> 72 <a href="#subsection.waypoints.find">Button <em>Find</em></a><br/> 73 <a href="#subsection.waypoints.show">Button <em>Show</em></a><br/> 74 <a href="#subsection.waypoints.mark">Button <em>Mark</em></a><br/> 75 <a href="#subsection.waypoints.detach">Button <em>Detach</em></a><br/> 76 <a href="#subsection.waypoints.add">Button <em>Enable</em></a><br/> 77 <a href="#subsection.waypoints.delete">Button <em>Disable</em></a><br/> 36 78 <a href="#chapter.route_patterns">Route patterns</a><br/> 37 79 <a href="#section.overview">Tab <em>Overview</em></a><br/> 80 <a href="#subsection.overview.list">List <em>Existing route patterns</em></a><br/> 81 <a href="#subsection.overview.refresh">Button <em>Refresh</em></a><br/> 82 <a href="#subsection.overview.new">Button <em>New</em></a><br/> 83 <a href="#subsection.overview.delete">Button <em>Delete</em></a><br/> 84 <a href="#subsection.overview.duplicate">Button <em>Duplicate</em></a><br/> 85 <a href="#subsection.overview.reflect">Button <em>Reflect</em></a><br/> 38 86 <a href="#section.tags">Tab <em>Tags</em></a><br/> 87 <a href="#subsection.tags.required">List <em>Required tags</em></a><br/> 88 <a href="#subsection.tags.common">List <em>Common tags</em></a><br/> 89 <a href="#subsection.tags.additional">List <em>Additional tags</em></a><br/> 90 <a href="#subsection.tags.add">Button <em>Add a new Tag</em></a><br/> 39 91 <a href="#section.itinerary">Tab <em>Itinerary</em></a><br/> 92 <a href="#subsection.itinerary.list">List of member ways</a><br/> 93 <a href="#subsection.itinerary.find">Button <em>Find</em></a><br/> 94 <a href="#subsection.itinerary.show">Button <em>Show</em></a><br/> 95 <a href="#subsection.itinerary.mark">Button <em>Mark</em></a><br/> 96 <a href="#subsection.itinerary.add">Button <em>Add</em></a><br/> 97 <a href="#subsection.itinerary.delete">Button <em>Delete</em></a><br/> 98 <a href="#subsection.itinerary.sort">Button <em>Sort</em></a><br/> 99 <a href="#subsection.itinerary.reflect">Button <em>Reflect</em></a><br/> 40 100 <a href="#section.stops">Tab <em>Stops</em></a><br/> 101 <a href="#subsection.stops.list">List of member nodes</a><br/> 102 <a href="#subsection.stops.find">Button <em>Find</em></a><br/> 103 <a href="#subsection.stops.show">Button <em>Show</em></a><br/> 104 <a href="#subsection.stops.mark">Button <em>Mark</em></a><br/> 105 <a href="#subsection.stops.add">Button <em>Add</em></a><br/> 106 <a href="#subsection.stops.delete">Button <em>Delete</em></a><br/> 107 <a href="#subsection.stops.sort">Button <em>Sort</em></a><br/> 108 <a href="#subsection.stops.reflect">Button <em>Reflect</em></a><br/> 41 109 <a href="#section.meta">Tab <em>Meta</em></a><br/> 110 <a href="#subsection.meta.rightleft">Check box <em>Stops are possible</em></a><br/> 111 <a href="#subsection.meta.maxdist">Text field <em>Maximum distance from route</em></a><br/> 112 <a href="#subsection.meta.suggest">Button <em>Suggest Stops</em></a><br/> 42 113 </p> 43 114 … … 76 147 </ul> 77 148 149 78 150 <div> 79 151 <a id="section.map_waypoints"/> … … 85 157 <p>When you are back at your computer, download the collected data from your GPS device into a GPX file: the exact steps depend on your particular device, but in general one of the programs <em>gpsbabel</em>, <em>mtkbabel</em> or <em>bt747</em> may help. They are explained on the respective pages of the wiki.</p> 86 158 87 <p>Once you have created the GPX file, open JOSM. Now choose <em>Create Stops from GPX</em> in the menue <em>Public Transport</em>. This raises first a file selection dialogue. Select here your just generated GPX file. The plugin now generates one stop at every waypoint. Now go to the tab <em>Settings</em> and select the type of stop you want to create. Open tab <em>Waypoints</em> and click onto the table. Now you can use keyboard shortcuts to edit the stops: <em>Alt-N</em> will focus the stop of the current line in the table and activate the <em>name</em> cell of this line. <em>Alt-S</em>, <em>Alt-T</em> and <em>Alt-U</em> help you to select the proper type of shelter: <em>Alt-S</em> yields <em>Yes</em>, <em>Alt-T</em> yields <em>No</em> and <em>Alt-U</em> yields <em>implicit</em>. If you don't want to map the shelter, just use only <em>Alt-N</em>. The key combination <em>Alt-D</em> disables the current waypoint and deletes the node associated to it. Now process all waypoints and then close the dialogue. Or process all waypoints, mark the lines they belong to and click <em>Detach</em> - this has the same effect. Once you have pressed <em>Detach</em>, the nodes are released from the dialogue and complete. Congratulations.</p> 159 <p>Once you have created the GPX file, open JOSM. Now choose <a href="#chapter.stops_from_gpx">Create Stops from GPX</a> in the menue <em>Public Transport</em>. This raises first a file selection dialogue. Select here your just generated GPX file. The plugin now generates one stop at every waypoint. Now go to the tab <a href="#section.settings">Settings</a> and select the type of stop you want to create. Open tab <a href="#section.waypoints">Waypoints</a> and click onto the table. Now you can use keyboard shortcuts to edit the stops: <em>Alt-N</em> will focus the stop of the current line in the table and activate the <a href="#subsection.waypoints.list">name</a> cell of this line. <em>Alt-S</em>, <em>Alt-T</em> and <em>Alt-U</em> help you to select the proper type of shelter: <em>Alt-S</em> yields <em>Yes</em>, <em>Alt-T</em> yields <em>No</em> and <em>Alt-U</em> yields <em>implicit</em>. If you don't want to map the shelter, just use only <em>Alt-N</em>. The key combination <em>Alt-D</em> disables the current waypoint and deletes the node associated to it. Now process all waypoints and then close the dialogue. Or process all waypoints, mark the lines they belong to and click <a href="#subsection.waypoints.detach">Detach</a> - this has the same effect. Once you have pressed <a href="#subsection.waypoints.detach">Detach</a>, the nodes are released from the dialogue and complete. Congratulations.</p> 160 88 161 89 162 <div> … … 96 169 <p>When you are back at your computer, download the collected data from your GPS device into a GPX file: the exact steps depend on your particular device, but in general one of the programs <em>gpsbabel</em>, <em>mtkbabel</em> or <em>bt747</em> may help. They are explained on the respective pages of the wiki.</p> 97 170 98 <p>Once you have created the GPX file, open JOSM. Now choose <em>Create Stops from GPX</em> in the menu <em>Public Transport</em>. This raises first a file selection dialogue. Select here your just generated GPX file. Select in the tab <em>Tracks</em> the track to create stops from. Now go to the tab <em>Settings</em> and select the type of stop you want to create. Put the sync time of the GPS device and the stopwatch in the respective fields. Open tab <em>Waypoints</em> and click onto the table. Click the button <em>Add</em> unless you have sufficiently much lines for all your split times. Now enter your split times in the first column. Then proceed as explained in the last paragraph of the <a href="#section.map_waypoints">section before</a>.</p> 171 <p>Once you have created the GPX file, open JOSM. Now choose <a href="#chapter.stops_from_gpx">Create Stops from GPX</a> in the menu <em>Public Transport</em>. This raises first a file selection dialogue. Select here your just generated GPX file. Select in the tab <a href="#section.tracks">Tracks</a> the track to create stops from. Now go to the tab <a href="#section.settings">Settings</a> and select the type of stop you want to create. Put the sync time of the GPS device and the stopwatch in the respective fields. Open tab <a href="#section.trackstops">Stops</a> and click onto the table. Click the button <a href="#subsection.trackstops.add">Add</a> unless you have sufficiently much lines for all your split times. Now enter your split times in the first column. Then proceed as explained in the last paragraph of the <a href="#section.map_waypoints">section before</a>.</p> 172 99 173 100 174 <div> … … 103 177 </div> 104 178 179 <p>N.B.: This apporach requires the software to do some semi-automatic guesswork. Although I've tried several approaches, the software still produces annoyingly much false positive (e.g. halts at traffic lights) and might miss stops (in particular, if the bus has passed them with no stop). Thus you should try to use one of the other two methods (with or without waypoints) first or a combination of these methods. The method might be useful to map stops you have forgotten to record.</p> 180 181 <p>You need a GPS logger, pen and paper. Record a GPS track while taking a ride on the route you want to map. Note the names of the bus stops you have passed and whether they have a shelter or not.</p> 182 183 <p>When you are back at your computer, download the collected data from your GPS device into a GPX file: the exact steps depend on your particular device, but in general one of the programs <em>gpsbabel</em>, <em>mtkbabel</em> or <em>bt747</em> may help. They are explained on the respective pages of the wiki.</p> 184 185 <p>Once you have created the GPX file, open JOSM. Now choose <a href="#chapter.stops_from_gpx">Create Stops from GPX</a> in the menu <em>Public Transport</em>. This raises first a file selection dialogue. Select here your just generated GPX file. Select in the tab <a href="#section.tracks">Tracks</a> the track to create stops from. Now go to the tab <a href="#section.settings">Settings</a> and select the type of stop you want to create. Put the sync time of the GPS device and the stopwatch in the respective fields. Click the button <a href="#subsection.settings.suggest_stops">Suggest stops</a> and open tab <a href="#section.trackstops">Stops</a>. If there are way too much or way too few stops or clusters of stops, adapt the values <a href="#subsection.settings.time_window">Time window</a> and <a href="#subsection.settings.threshold">Move Threshold</a> in the tab <a href="#section.settings">Settings</a>. Now enter in the second column the names of the stops: Mark a line in the table and press <em>Alt-N</em>. This focuses and marks the stop and makes its name editable. If the stop is a false positive, you can delete it with the button <a href="#subsection.trackstops.delete">Delete</a> or <em>Alt-D</em>. All keyboard shortcuts are explained in the <a href="#section.map_waypoints">waypoints section</a>.</p> 186 105 187 <div> 106 188 <a id="section.scratch"/> … … 110 192 <p>The <a href="#notion.oxmoa">Oxmoa schema</a> consists of a relation per direction and contains the <a href="#notion.itinerary">itinerary</a> (the way a bus actually takes from its starting stop to its terminus) and the <a href="#notion.stop">stops</a> served by the bus. Roughly, you need to enter one direction of the itinerary by hand. The stops and the back direction can mostly be derived from that by the software.</p> 111 193 112 <p>Download the area where your <a href="#notion.bus_route">bus route</a> takes place. Choose the menu item < em>Public Transport > Route patterns</em>. This opens a <a href="#section.overview">window</a> where you can see all <a href="#notion.bus_route">public transport routes</a> existing in the downloaded data set. Create a new relation by clicking on the button <a href="#subsection.overview.new">New</a>. Now change to the tab <a href="#section.tags">Tags</a> and set appropriate values for a least <em>route</em> (the type of public transport), <em>ref</em> (the line number) and <em>to</em> (the destination displayed).</p>194 <p>Download the area where your <a href="#notion.bus_route">bus route</a> takes place. Choose the menu item <a href="#chapter.route_patterns">Public Transport > Route patterns</a>. This opens a <a href="#section.overview">window</a> where you can see all <a href="#notion.bus_route">public transport routes</a> existing in the downloaded data set. Create a new relation by clicking on the button <a href="#subsection.overview.new">New</a>. Now change to the tab <a href="#section.tags">Tags</a> and set appropriate values for a least <a href="#notion.route_type">route</a> (the type of public transport), <em>ref</em> (the line number) and <em>to</em> (the destination displayed).</p> 113 195 114 196 <p>Change to the tab <a href="#section.itinerary">Itinerary</a>. Now select on the map the first way that belongs to your <a href="#notion.bus_route">route</a> and press <a href="#subsection.itinerary.add">Add</a>. Mark the second item and press <a href="#subsection.itinerary.add">Add</a> again. You also can select several ways at once and click <a href="#subsection.itinerary.add">Add</a>. If your ways are added in the wrong order or with wrong roles, <a href="#notion.select">mark</a> them (click the first entry in the window, then shift-click the last entry in the window) and press <a href="#subsection.itinerary.sort">Sort</a>. If there appear one or more lines <em>[gap]</em>, then your ways don't fit together. If <a href="#subsection.itinerary.sort">sorting</a> won't solve that then there are gaps in your <a href="#notion.itinerary">itinerary</a> and you need to add the missing links or split ways (mark the way, the node where to split at and then use menu <em>Tools > Split Way</em>) if your bus service only partly uses them. To help you … … 247 329 248 330 <p> 331 <a id="notion.track"/> 332 <strong>track</strong> - A data structure from GPX files: GPX files are organised as a collection of <a href="#notion.waypoint">waypoints</a> and tracks. While waypoints are just points, each track is a sequence of points representing an arbitrary motion. The track contains the information when the vehicle was where. Usually, a GPS logger starts a new track each time you put its power on. 333 </p> 334 335 <p> 249 336 <a id="notion.way"/> 250 337 <strong>way</strong> - The respective OSM primitive. It is visible in the JOSM main window and a list of ways constitutes the <a href="#notion.itinerary">itinerary</a> of a <a href="#notion.bus_route">bus route</a>. A way has an orientation from its first <a href="#notion.node">node</a> to its last node. In JOSM, this is visualised by the direction of the arrows that represent the way. Thus, a vehicle can pass a way in or against its orientation. This is indicated by the role of the <a href="#notion.relation">relation</a> membership representing the <a href="#notion.itinerary">itinerary</a>: <em>forward</em> means that the vehicle passes the way in its orientation while <em>backward</em> means the opposite. 251 </p>252 253 <p>254 <a id="notion.track"/>255 <strong>track</strong> - A data structure from GPX files: GPX files are organised as a collection of <a href="#notion.waypoint">waypoints</a> and tracks. While waypoints are just points, each track is a sequence of points representing an arbitrary motion. The track contains the information when the vehicle was where. Usually, a GPS logger starts a new track each time you put its power on.256 338 </p> 257 339
Note:
See TracChangeset
for help on using the changeset viewer.
