Mapgen User`s manual
Contents
1. basedpi INTEGER rule size resolution DEFAULT 300 dpi Understanding rules and dpi First of all The next paragraphs apply to PNG or other pixel related unscaled graphic formats like JPG or BMP When using PDF or SVG you don t have to care about this too much Because there is always a bit confusion about sizes of objects and the according rules I want to give some hints The rules provided in SVN are for a resolution of 300dpi So the resulting files should be suitable for printing In the file there are ways that have a thickness of let s say 40px What does that mean It means that when printing with 300dpi the way will be displayed using 40 pixels which is roughly 3mm If you look at this same map on a screen you will have much larger ways because the resolution of the screen is much lower 90 120dpi What to do Very simple To create a map for the screen using the same style file just specify scaledpi 117 i e for my netbook Everything will be scaled now Of course you can t send this to the printer now because everything would be too small If you use the 300dpi rule file and you want to print with a higher resolution just specify scaleset 600 or 1200 What to do if you want to specify your rule file for another resolution than 300 Just as easy but don t forget You now have to use basedpi 75 or whatever you chose each time you call mapgen Let s look at our 40px way from above Assuming a base dpi of 75 this way w2. For some applications it is useful to be able to draw a circle around a POI like a fire department i e Just specify the k v of the POI with the rad parameter Add distance in meters the color and the thickness of the circle It is possible to have multiple POIs Just separate them with a semicolon It is also possible to have multiple circles around one POI Just use two entries circle key value distance color thickness circle key value distance color thicknesstkey value distance color thickness circle key value distance color thickness The value may be an asterisk Then all values of the key are allowed Example circle amenity fire station 3000 black 30 Debug Verbose will turn on lots of information to be printed while program executes This is mostly done for debug purposes verbose If you want to print a map only containing multipolygons you can specify so This is also a debug function although a graphical one multionly draws only areas of multipolygons for test purposes Relation analyzer mode ra TEXT TEXT types and or ids separated by commas add relation analyzer layer keep normal elements in map in light colors 56444 multipolygon Displays elements of relations in map Background should be kept in light colors Elements are labeled and whole relation will be placed inside a box
3. alignments will be tried So labels might me moved and or omitted at all At the end of map drawing program will show how many labels and icons were omitted or moved To prevent a special form of clutter caused by certain parallel ways the following option may be specified declutter declutter text WARNING some labels might be omitted motorway and trunk will only be labeled in one direction Motorways and trunks will be labeld only in one direction mapgen tries not to put labels on ways that are too short To do so it calculates the length of the way and the length of the text This is done by assuming a need of 6 pixels per character for a 10pt font Other font sizes are calculated automatically If you find out that 6 ppc doesn t suit your used font please reconfigure the value using the following option ppc 2 float pixels needed per label char using font size 10 DEFAULT 6 Grids directory and stats A grid can be laid over the map Just specify the number of squares you want in longitude direction The other dimension is automatic Of course you can specify the grid color The grid squares are labeled numerically and alphabetically grid lt integer gt number parts for grid 0 no grid DEFAULT 0 gridcolor TEXT color for grid lines and labels DEFAULT black P y Krankenhads Hoei Kia ed A dafa cofe m Ey Street directory mapgen can even create a street directory It will do so includi
4. changed icondir TEXT dir for icons for routes icondir i e DEFAULT routeicons You can also change the default distance of pixels between multiple icons for same way routeicondist INTEGER dist in y direction for route icons on same route DEFAULT 275 And perhaps sometimes it comes in handy if you can scale the given route icons by a factor routeiconscale FLOAT factor to scale the height and width of the route icons gt 1 bigger 1 smaller I a E Srunhildisstein 8 308 50 23 E 3 Teufelsquartier 4574995 50 2 erghot f Bs Colors aliceblue darkcyan dodgerblue lemonchiffon antiquewhite darkgoldenrod firebrick lightblue aqua darkgray floralwhite lightcoral aquamarine darkgreen forestgreen lightcyan azure darkgrey fuchsia lightgoldenrodyellow beige darkkhaki gainsboro lightgray bisque darkmagenta ghostwhite lightgreen black darkolivegreen gold lightgrey blanchedalmond darkorange goldenrod lightpink blue darkorchid gray lightsalmon blueviolet darkred green lightseagreen brown darksalmon greenyellow lightskyblue burlywood darkseagreen grey lightslategray cadetblue darkslateblue honeydew lightslategrey chartreuse darkslategray hotpink lightsteelblue chocolate darkslategrey indianred lightyellow coral darkturquoise indigo lime cornflowerblue darkviolet ivory limegreen cornsilk deeppink khaki linen crimson deepskyblue lavender magenta cyan dimgray lavenderblush maroon darkb
5. Mapgen by Gary68 User s manual Version 1 09 September 2010 gt residential emm motorway us lt He IX em seconda ondary mu T e tertiary track paa De footway XY E path ay Amy a cycleway m park ME stadium T cemetery 4 military Bg forest m farmland residential industrial Table of Contents A o hex datu mcdio USBN LKBB SB 3 OS o NBA AAN ss 3 A E 3 Basic parameters ln en Uo RATEN ER RU EN EN BNN psa a dux c BEN 5 iin ss 5 Usage Example PEST TED 5 Map size and the Ue base am NN 6 Advanced pai aa taste redisse LL oL EDT Den 7 DAS CCL eiu parade neus e cut E BN na LU Cue 3 9 Understanding r lesand dpi uoa tot ans iii 9 Setting scale Or rules ood eae eto deus sone Su tal adeb tea a UR e aie aule nue 10 Sle FIO TODIIHE me ufu AN 11 A OS 11 Nod de e de e be o dl a e e tos 11 Wi E E E AA EE E A E 12 ROUES ei IM 14 ROUTE ICONS ec n ia a n un ian kunanta ea 16 Colors e A A 17 OWN So gia a a e NN akg ua vg NB OL I Eo I bln un e e oV bU 18 A co Nc TEE VE 18 Pee AAS ANE BNN waa icon E ea ice ent enen a et 19 bound pened yeas 20 Grids directory and Salina didas 2l Muss Neira MM 21 Por and place MIR a aE 22 Streetand POT directory mb P DE eue a Red E RR EE NBN ON INE HUS e UR ian 22 UE arden 22 COMA MM E
6. PA an PAN 24 External POLIUS odisse dictus Uca raduno mutuae deitas te e cato mU en da ag 25 Circles around POLIS A BEAN LAS ena Basa 26 Ib n ITI IEEE 26 Introduction Mapgen has its roots in osmdiff pl and osmrender pl They were very basic render programs Once Haiti was hit by the strong earthquake I wanted to provide large png maps for the local help This proved to be hard since so many things couldn t be done with my programs So I decided to improve the features of my renderer and give it a new name So the basic goals became Fastand easy map generation different output formats Fast extraction of needed data out of osm files place Easy style file handling Street and place directories e Keep it simple easy invocation with only 2 mandatory parameters Keep it powerful by using more parameters Hints The projection method used is Mercator ellipsoid is WGS84 Projection used is displayed in footer of map Be aware that at the edges of the map items may be missing This may occur when items are not completely contained in the osm file You can try to prevent this by using the clip parameter with larger values Installation Put the mapgen pl file in a folder Put dir pl in the same folder Put pm files in a subfolder called OSM can also be put into a directory contained in the INC pathes Get Math Poygon from CPAN and create a subfolder Math can also be put into a directory contained in the INC p
7. abel a natural peak using a second rule for elevation i e Using area icons Ways with borders Burg Apotheke Routes Col ju Name Values Description 1 RouteType bus hiking see wiki 2 cit Alivslidicolor A set of colors can be given by using the as a delimiter 3 Thickness INTEGER Of the line 4 DashType See above Of the line 5 Opacity 0 100 Opacity in percent 6 Label Valid keys Key to get the label from StopNodeT 7 hickness INTEGER 8 FromScale INTEGER 9 ToScale INTEGER The colors will be assigned to each found route in order of occurrence in style file if no k v for the colors are present in the osm file Additionally the labels can be configured by command line parameters routelabelcolor TEXT color for labels of routes routelabelsize INTEGER DEFAULT 28 routelabelfont TEXT DEFAULT sans serif routelabeloffset INTEGER DEFAULT 35 f Hiking routes in the Taunus Some bus stops in Frankfurt Route icons Aditionally icons for routes can be added to the map if icons are provided as follows Create folder routeicons and save icons there As the file name choose the ref or the name of the route preceeded by the route type and a dash If the route has a ref the ref has to be used Example routeicons hiking E3 png OR routeicons hiking E3 svg The default icon directory can be
8. athes Install osmosis if desired take care that it can be invoked from command line Install inkscape if desired take care that it can be invoked from command line This is necessary when usein SVG files as tile patterns or when converting from SVG to PNG or PDF bzip2 installation sudo apt get install libcompress bzip2 perl GD installation sudo apt get install libgd graph3d perl Geo Proj4 cpan lt enter gt dann install Geo Proj4 For the directory in PDF format you ll also need the following O latex sudo apt get install texlive latex base dvips sudo apt get install texlive latex bin o ps2pdf sudo apt get install texlive latex bin Information about Osmosis can be found here http wiki openstreetmap org wiki Osmosis Basic parameters Obviously there are some things that can t be hidden from the user So the user has to specify at least 2 basic parameters in file osm style style csv original can be kept and maintained in OO sheet or MS Excel in also supports osm bz2 format Default output name is mapgen svg Output Basic and only output format from mapgen itself is SVG That has the advantage that all further formats contain all elements that mapgen can produce Disadvantage is a post processing done by inkscape out file svg png and pdf names are automatic DEFAULT mapgen svg There are two options specifying additional output formats png also produce png inkscape must be in
9. ctory of streets and POIs if according options for generation are set dircolnum INTEGER number of columns for PDF directory of streets and POIs DEFAULT 3 dirtitle TEXT title for PDF directory of streets and POIs DEFAULT mapgen map Statistics You can print a tag statistic about the usage of the keys and values To keep the list short unimportant keys are omitted This must be adapted in the code if desired The idea is to see what keys are used mostly So you can decide for which features rules are needed Mapgen will print an alphabetical list of keys and values as well as a list of the most used k v combinations At the end of each line the program prints if it knows a rule for that k v Output is separated for nodes and ways and will be written in a file called name tagstat txt tagstat lists keys and values used in osm file program filters list to keep them short see code array noListTags TOP 22 0 LEST highway residential 123 RULE highway footway 51 RULE oneway yes 38 highway service 21 RULE highway primary 19 RULE highway steps 14 foot yes I2 highway secondary 11 RULE building yes 10 RULE bicycle yes 1 0 amenity parking 10 RULE surface cobblestone 9e service parking aisle 8 highway pedestrian 8 landuse residential 6 RULE highway track 6 RULE highway path 5 RULE highway living street S amenity restaurant Oe ameni
10. efault in the upper right corner This can be switched off as well Additionally a color can be specified tower residential motorway primary secondary tertiary track footway path cycleway line rail park forest farmland farmuard ler INT lercolor TEXT TA E G Ss O no ruler DEFAULT black Krankenha fa gt E 2 de erm nei lac p gt Pii p T DEFAULT 1 l draw ruler Optionally a scale value can be calculated and added to the map Of course the color for this text can be set scale scalecolor TEXT print scale set scale color DEFAULT black A specific scale can be set i e 1 25 000 by adding scaleset 25000 to the command line To be able to work with this information you have to specify the resolution of the output device in dpi By default this is set to 300dpi scaleset INTEGER printer options scaledpi INTEGER size INTEGER set correct 1 x preset for map scale overrides print resolution DEFAULT 300 dpi Setting the scale overrides the size parameter The program will in any case print information on how big the map will be and on what paper size 1t will fit basedpi basedpi is the dpi on which the sizes in the rules file are given So if you i e want to use a base resolution of 72dpi you could set this by specifying basedpi 72 You should then also specify scaledpi 72
11. ing means that not all of the data given in the osm file will be presented This is useful to clip incomplete data at the edges of the area in the osm file Clipping can be done by a percentage or by giving a bounding box which might be more precise Giving a bounding box overrides simple clipping actual map aa Symmetric clipping large multipolygon actual map data Clipping to enable big elements not completely in bbox Padding means to pad the map with an empty border Useful for islands Program will output some useful information about map and paper sizes as well as resolution and scale bgcolor TEXT color for background size lt integer gt in pixels for x axis DEFAULT 1024 clip lt integer gt percent data to be clipped on each side O no clipping DEFAULT 0 clipbbox float float float float left right bottom top of bbox for clipping map out of data more precise than clip overrides clip pad INTEGER percent of white space around data in osm file DEFAULT 0 Advanced parameters By default a legend is drawn in the upper left corner This can be switched off legend INT O no legend l legend in top left corner 2 legend in lower right corner DEFAULT 1 You can also place the legend in the lower right corner by giving legend 2 The legend will only show elements that would be drawn if present in the current map scale A ruler is drawn by d
12. irst cell These lines will be omitted when style file is read File Note that you can enter multiple key value pairs for a rule Valid for nodes and ways Different entries must be separated by a I If you for example want a rule for all tracks with tracktype gradel then the entries would be column key tag highway tracktype column value track gradel Nodes Column 4 Name Values Description see wiki 1 key cp values can be separated by a 1 see above see wiki 2 value an asterisk may be used as a wild card values can be separated by a 1 see above 3 color see separate table the fill color thickness INTEGER key where value will be the label text entries can 5 label be separated by or AND PRIO special keys _lon and lat 6 label color see list below label size INTEGER size Of text 8 jud INTEGER NOT USED RIGHT NOW 9 legend Oorl 10 Icon File name 11 Icon size n pixels 12 FromScale INTEGER 13 ToScale INTEGER A halo can be specified by using the option halo FLOAT white halo width for point feature labels DEFAULT 0 However then a bold font is used so you also have to adjust ppc to maybe 7 The halo is white and opacity is 9096 Use large font sizes Ways l Cn nup Name Values Description 1 ke see wiki y values can be separated by a 1 see wi
13. ki 1 sk sans an asterisk may be used as a wild card values can be separated by a 1 3 color see separate list the fill color 4 thickness INTEGER thickness of line 1 4 for tracks 10 14 relation 1 1 dashes y 5 dash style 20 23 for borders olm the style of the dashes forming 30 35 for steps drawn with y linecap BUTT Border Border color for the way Only valid 1f 2 color TEAT border thickness is gt 0 y Borger INTEGER Border thickness for the way thickness 8 fill 0 or 1 0 area will not be filled 1 area will be filled key where value will be used as 9 label label text entries can be separated by or AND PRIO special keys lon and lat 10 label color see below 11 label size INTEGER font size 12 abel Tong see below family 13 label offset INTEGER dein muse duectiom negative 14 legend 0orl entry for automatic legend O no 1 yes applies for areas closd ways areas tagged 15 base layer Oorl with 1 are drawn as background first use for landuse natural etc 16 Icon TEXT Fill icon for area SVG and PNG supported 17 FromScale INTEGER 16 ToScale INTEGER Mapgen will produce a file that lists all labels that were not placed on the map but should have according to the rules given The file name is derived from the svg name and ends with _NotDrawnLabels txt The user can then process this information further Using _lon and _lat you could nicely l
14. lue dimgrey lawngreen mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream mistyrose moccasin navajowhite navy oldlace Fonts eserif sans serif cursive fantasy monospace Times Baskerville Verdena Symbol Oneways olive olivedrab orange orangered orchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum powderblue oneways add oneway arrows onewaycolor TEXT purple red rosybrown royalblue saddlebrown salmon sandybrown seagreen seashell sienna silver skyblue slateblue slategray slategrey color for oneway arrows snow springgreen steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen Extracts If you don t wan t the whole osm data to be printed that is contained in the file no problem As long as you have installed osmosis and this can be invoked from the current directory by command line Just specify the name of a place or a node id and mapgen will look for such a place Upon success it will invoke osmosis to extract the needed data By default a width and height of 4km 2 2km radius is set But of course it can be overridden If you want to speed up the search process you can provide a placefile in osm format which only contains places Can be created with osmosi
15. ng the grid sguares where the street is located if the grid is turned on Output is an unformatted street list to be further processed The grid sguares are separated by a tab File name is name streets txt dir create street directory in separate file if grid is enabled grid squares will be added In the next table you can see a section of the street directory On the left without grids on the right with grid squares Burgstrahe BULGStEraR Css 2 Ku RAD Bl Cohausenstrahe CohausenstraBe Al A2 Bl Crufterostrahe CrufterosStrah Gs wee wey kana D2 Elisabethenstrahe ElisabethenstraBe B2 C1 C2 D1 El Eschborner Weg EsSchbotner WE Gis te Sek Rab eed bana C1 Feldbergstrahe FeldbergstraBe A Bl Poi and place list You can print a poi and place list like the street directory Grid option applies as well poi create list of pois Delkenheim C5 Diedenbergen F4 Eddersheim G5 Edeka Kundenparkplatz G7 Falkenberg Keramag E7 EIOCSheYm e eev a a F6 GELAdaUtomata dedesine eaea ta C1 Street and POI directory in PDF You can create a formatted street and POI directory in PDF format To be able to do so you need some programs installed see installation latex dvips ps2pdf Also necessary is to also specify the options to create street and POI directories with dir and or poi and a grid created by grid x dirpdf creates dire
16. ould have to have a thickness of only 10px Assuming a base dpi of 600 would mean to specify a thickness of 80px Some Hints my netbook has a resolution of 117 dpi my 18 monitor has a resolution of 90 dpi e for printing choose a scalable format or a dpi of 300 dpi or more most laser printers today support 600 or even 1200 dpi Setting a scale for rules alone If you specify a certain scale for rulescaleset then for selecting rules not the actual scale of the map is used but the specified one This is useful to show more or less details than initially intended by the given ruleset minScale maxScale A similar function can be found in the Garmin GPS receivers Map details normal more most less least rulescaleset INTEGER determines the scale used to select rules DEFAULT 0 meaning actual map scale is used to select rules Style file format In any case only one rule per object is used And this is the first matching rule according to the style file So it s possible i e first to look after all tracktype X Y and then having a default rule for all highway track So it is important to have more specific rule higher above in the sheet file The different sections of the file start with a SECTION line This line contains the word SECTION in the first cell These lines are mandatory even if no rules for a section are present You can add COMMENT lines for remarks if you enter COMMENT in the f
17. s place TI node id can be given alternatively lonrad F1 latrad F EXT Place to draw automatically LOAT LOAT placefile 1 Speeds up search process TEXT gt radius for pl lace width in km radius for pl lace width in km D quotation marks can be used if necessary OSMOSIS REQUIRED DEFAUL 2 EFAUL 2 file in which to look for places can be produced with osmosis Program will print used OSMOSIS string to STDOUT for later use Declutter Usually when drawing maps especially with lots of details clutter may occur mapgen will register an used area for each drawn label and won t use this area again mapgen will register an used area for each drawn icon and won t use this area again mapgen registers a polygon for each drawn way label and will prevent collision Icons will be placed at the given location Using option allowiconmove you can permit the program to slightly move icons if they don t fit the original position Labels are drawn afterwards and will be placed accordingly Using this option will significantly increase the number of drawn icons in cluttered areas In Frankfurt using a scale of 1 50 000 150 more icons could be drawn allowiconmove allows icons to be moved if they don t fit the exact position Text labels for nodes and areas will be placed on a default position and orientation If this is not possible other positions and
18. stalled very big pdf also produce pdf inkscape must be installed The names are automatic and derived from the out name Inkscape must be installed and your system must be able to run it from command line in the current directory The PNG files are rather big So maybe some post processing is appropriate Usage examples Most simple form perl mapgen pl in file osm style mapgenRules csv Also specify an output name if you wish perl mapgen pl in file osm style mapgenRules csv out map svg Also specify size and that you want a PDF additionally perl mapgen pl in file osm style mapgenRules csv size 2048 pdf Now let s say you have a big osm file but only want a map of a certain city perl mapgen pl in germany osm style mapgenRules csv place Frankfurt This will probably not cover the whole of Frankfurt because the default radiuses are too small 2km each direction perl mapgen pl in germany osm style mapgenRules csv place Frankfurt lonrad 10 latrad 10 Now we want our map with grid lines and a street directory perl mapgen pl in file osm style mapgenRules csv grid 8 dir And let s turn off the legend perl mapgen pl in file osm style mapgenRules csv legend 0 Map size and the like The background color can be set according to the given color set The size of the picture is specified by the width in pixels Height is automatically calculated Clipp
19. ty pharmacy Sat Obviously we should maybe implement a rule for oneway yes And we can see that by far the most used tag here is highway residential Coordinates Grid You can add a grid of coordinates to your map by specifying the coords option By default the grid distance is 0 01 degrees This can be changed by using the coordsexp parameter The value given here is the power of 10 2 means 0 01 degrees 2 means 10 degrees And of course the color can be changed coords turn on coordinates grid coordsexp INTEGER degrees to the power of ten for grid distance DEFAULT 2 equals 0 01 degrees coordscolor TEXT set color of coordinates grid da KIIA A o gt ie Kpiten st Ve 1 V se External POI files A separate POI file can be specified where additional POIs are defined These will be placed on the map according to their positions The following information is needed longitude latitude size of dot in points of base resolution color for node and label name of POI size of label in points of base resolution poifile TEXT name of file with POIs to be displayed in map The file must be in text format CSV and uses SPACE as a delimiter and as field delimiters and could look someting like this 8 50 40 blue confluence point 1 40 9 50 40 blue confluence point 2 40 8 45 50 086 40 red HOME 40 afe r Apfel USR thaus fheim a a TOW Circles around POIs
Download Pdf Manuals
Related Search