34 | | * [wiki:Help/Concepts/Object Objects] - explains what '''objects''' maps consist of and how these objects are described in detail |
35 | | * [wiki:Help/Concepts/Conflict Conflict] - explains the basics of '''conflicts''', why they occur, how they are detected and how you can resolve them |
36 | | * [wiki:Help/Concepts/Changeset Changeset] - explains why you create a '''changeset''' when you upload data to the OSM server |
| 27 | === OSM data model === |
| 28 | * [=#objects Objects] ([Help/Concepts/Object complete reference]) - explains what '''node''', '''way''', '''relation''' and '''tag''' is; ''Presets'' are introduced at the same page. |
| 29 | * There are [Help/Concepts/Object#Relations many types of relations], currently loaded relations can be selected via [Help/Dialog/RelationList Relations] but there a [Help/Dialog/RelationEditor single interface to edit them] |
| 30 | |
| 31 | === Changesets === #changeset |
| 32 | [Help/Concepts/Changeset Changesets] exists for every of your "edit". They simply group data creations, modifications and deletions - with additional properties {{{comment}}}, {{{created_by}}}, {{{imagery_used}}} [osmwiki:Proposed_features/changeset_tags and several others] (this information stored as simple tags). Similar to other wiki software, one changeset can affect one object (a single character edit in the text), but may contain big changes (removals of paragraphs, partial or complete rewrite of the text) with the only difference that geo information is edited instead of text. Investigating history of one character is equally hard to comparing text at given point in time. Since [osmwiki:Planet.osm complete "text" in OSM is 30-600GB big] therefore users speak of history within several changesets and not about complete history every time. |
| 33 | |
| 34 | |
| 35 | [Help/Action/Upload Upload changeset dialog] - explains why you create a '''changeset''' and low level details about protocol that uploads data to the OSM server |
| 36 | |
| 37 | === JOSM concepts === |
| 38 | * [=#hotkeys Hotkeys] or shortcuts ([wiki:Shortcuts complete reference]). **EVERY** "button" and menu item may be assigned with hot-key (including menu items provided with [wiki:Plugins plugins]; popular [wiki:Presets presets] and [Help/Action/Search#SavesearchqueryinMaintoolbar saved search queries]). Some of the default hotkeys or activation steps may be surprising. All active shortcuts will be present under [wiki:Help/Preferences/Shortcuts "Hotkeys" tab in F12 menu] you can adjust and fine-tune them or reset at any moment. |
| 39 | * [=#preferences Preferences] ([Help/Preferences complete reference]) - some of the settings are unaccessible via [Help/Action/Preferences settings menu] or have [#JOSMinterfacecustomization control elements and menus everywhere in the editor] |
| 40 | * [=#undoredo Undo/redo mechanism] - used to spot mistakes, but these tools are especially useful when ''learning new tools'' in JOSM. Similar to other editors, ''most operations'' in JOSM can be [Help/Action/Undo undone] and [Help/Action/Redo redone], unless they are listed in [Help/Listofirreversibleoperations list of irreversible operations]. Difference is that all changes can be displayed in [Help/Dialog/CommandStack command stack dialog]. |
| 41 | |
| 42 | == Workflow examples == |
| 43 | * [[Help/Downloading data]] - there are many ways to load existing data in JOSM |
| 44 | * Help/Relations - relation editing may involve multiple windows ([Help/Dialog/RelationList Relations window], [Help/Dialog/SelectionList Selection], [Help/Dialog/RelationEditor Relation editor]) in JOSM. Some plugins may simplify some steps, but provide less clarity about what you do: many tools, states or tags become "hidden" or even worse: simply unaccessible. |
| 45 | * [wiki:Help/Operating_multiple_JOSM_at_once Operating multiple JOSM at once] - you are not limited to run one copy of JOSM, unfortunately we don't have any details about it yet (please help us if you are working this way) |
| 46 | * [Help/AudioMapping Audio mapping]: playing voice notes and synchronizing them with your GPS tracks in JOSM |
| 47 | * [Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean |
| 48 | * [wiki:HowTo How to create runabout from crossing ways] |
| 49 | |
| 50 | {{{ |
| 51 | #!html |
| 52 | <!-- |
| 53 | candidates: |
| 54 | http://www.openstreetmap.org/user/LLlypuk82/diary/35962 |
| 55 | --> |
| 56 | }}} |
| 57 | |
| 58 | == JOSM tools (incomplete reference) == |
| 59 | |
| 60 | {{{ |
| 61 | #!html |
| 62 | List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part. |
| 63 | }}} |
| 64 | |
| 65 | [wiki:Help/Action/SearchMenuItems Search among all JOSM tools and menu items] - {{{Ctrl+Spacebar}}} |
| 66 | |
| 67 | === Basic shape of objects === |
| 68 | * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list |
| 69 | * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects |
| 70 | * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects; |
| 71 | * [Help/Action/Extrude Extrude], [Help/Action/Draw/AngleSnap Angle snapping], [osmwiki:JOSM/Plugins/CommandLine#Usage Spline or Bezier ''from commandline plugin''] - mostly for man made objects |
| 72 | * both [Help/Action/Draw Draw nodes mode] and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] - have their followers and use cases |
| 73 | * [Help/Action/Paste Paste previously copied objects] - not only tags but also their geometries |
| 74 | |
| 75 | === Selection === |
| 76 | Selection (or list of currently selected objects) is precisely described in Help/Dialog/SelectionList#Selection (because it is visible from this dialogue), it can be modified with following tools (incomplete list): |
| 77 | * [Help/Action/Select#Selecttool Select objects] - contains many modifiers, including [Help/Action/LassoMode lasso mode] |
| 78 | * [Help/Action/Search Search] - a very powerful tool and a query language with [Help/Action/Search#Keywords over 28 keywords] and flexible operators to combine them in flexible manner. Not to mention regex and [wiki:Help/Styles/MapCSSImplementation mapcss] filters. |
| 79 | * (Shift+F3) - search objects by preset |
| 80 | * [wiki:Help/Plugin/UtilsPlugin2#Selection] - multiple selection focused tools ''from UtilsPlugin2'' |
| 81 | * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] - useful when editing highways, railways, rivers, power networks and networks in general |
| 82 | * [Help/Action/SelectAll Select all] is more useful after you download precise list of objects |
| 83 | |
| 84 | === Tags === |
| 85 | Tags of currently selected objects displayed in [Help/Dialog/TagsMembership Tags/Memberships Dialog]. |
| 86 | * [Help/Action/Copy Copy] - copy selected objects to the buffer |
| 87 | * [Help/Action/PasteTags PasteTags] - paste previously copied tags |
| 88 | * Tabular editor (Ctrl+T) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) |
| 89 | * (Shift+R) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) copy tags from previous selection |
| 90 | * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue |
| 91 | |
| 92 | === Topology tools and changes === |
| 93 | * [Help/Action/MergeNodes Merge] two or more points |
| 94 | * [Help/Action/UnGlue UnGlue] explode single point into multiple |
| 95 | * [Help/Action/MoveNodeWay Join point into a way segment] |
| 96 | * [wiki:Help/Action/DisconnectNodeWay DisconnectNodeWay] - opposite of above, disconnect a node from a way segment |
| 97 | * [wiki:Help/Action/AddIntersections AddIntersections] (Shift+I) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) - will create nodes at places where current selections intersects (or self intersects) |
| 98 | * [wiki:Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2]) |
| 99 | * [Help/Action/SplitWay Split way] - split way by a node |
| 100 | * [Help/Action/CombineWay Combine Way] - combine several selected ways in one |
| 101 | * [Help/Action/JoinAreas Join overlapping areas] |
| 102 | * [Help/Plugin/ContourMerge ContourMerge] mode can used to glue complex parts that would require too many ''Merges'' otherwise; it could also used to partially or completely replace geometry of one object with partial or a complete geometry of other object |
| 103 | |
| 104 | === Geometry tools === |
| 105 | ==== Precision in angles ==== |
| 106 | * [Help/Action/Draw#Anglesnapping Anglesnapping] will ease drawing way segments in 30°, 45°, 60° and 90° degrees |
| 107 | * [Help/Action/Extrude#Basicusage Extrude] tool will ease drawing of strictly perpendicular segments |
| 108 | |
| 109 | ==== Alignment ==== |
| 110 | * [Help/Action/AlignInLine Align in line] will align selected nodes into a line |
| 111 | * [Help/Action/DistributeNodes Distribute] as above, but also place them at equal distances |
| 112 | * "Copy" objects at precise anchor points ''from [osmwiki:JOSM/Plugins/CommandLine commandline]'' |
| 113 | * "Move" objects at custom vector ''from [osmwiki:JOSM/Plugins/CommandLine commandline]'' |
| 114 | * [Help/Action/AlignInCircle Align selected nodes in circle] |
| 115 | |
| 116 | ===== Parallel ===== |
| 117 | * [Help/Action/Parallel Parallel], draw lines and curves parallel to each other, draw nested infrastructure quickly |
| 118 | * [Help/Action/Extrude#MovesegmentinparallelCtrl Extude mode used on segments] - will move them in parallel, preserving angles when it is needed |
| 119 | |
| 120 | |
| 121 | ==== Rotation ==== |
| 122 | * [Help/Action/Select#Rotateobjects Rotate objects] at user-defined angle (but exact angle is unknown) |
| 123 | * {{{ShapeTools}}} [wiki:Plugins plugin]: |
| 124 | * Rotate object at predefined angle |
| 125 | * Rotate objects (match building with road) |
| 126 | * Rotate objects (match building with road, don't rotate more than epsilon) |
| 127 | |
| 128 | === Viewport control === |
| 129 | * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool] |
| 130 | * [Help/Dialog/Minimap Minimap] window |
| 131 | * [Help/Action/JumpToPosition JumpToPosition] |
| 132 | |