WxGUI Cartographic Composer: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
m (moved WxGUI Hardcopy Map Output Utility to WxGUI Cartographic Composer: The official name of wx.psmap was changed.)
mNo edit summary
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{ToModify}}
Back to [[wxGUI]].
''For development issues see'' '''[http://trac.osgeo.org/grass/wiki/wxGUIDevelopment/GUIForPs.map Trac page]'''.
''For development issues see'' '''[http://trac.osgeo.org/grass/wiki/wxGUIDevelopment/GUIForPs.map Trac page]'''.
__TOC__
__TOC__


{{cmd|ps.map}} (see also {{AddonCmd|ps.output}}) is a ''cartographic composer'', intended to be a stand-alone hardcopy plot generator. It is not meant to be a ''Print'' button for the maps currently displayed in the map canvas, that will need it own controls.
The '''Cartographic Composer''' (so called ''wx.psmap'') is a GUI application which allows GRASS users to prepare interactively hardcopy map outputs. The application can write a instructions file for GRASS module {{cmd|ps.map}}, and then run this module on the background to create PostScript output directly. See the [http://lists.osgeo.org/pipermail/grass-user/2011-March/060158.html announcement] in the mailing list. See also the {{cmd|wxGUI.psmap|desc=manual}}.
 
Cartographic Composer is release under [https://svn.osgeo.org/grass/grass/trunk/GPL.TXT GNU GPL] licence and the source is available from [https://svn.osgeo.org/grass/grass/trunk/gui/wxpython/psmap GRASS SVN repository]. The composer is part of core GRASS GIS. To run the composer, it is necessary to have the [http://pythonware.com/products/pil Python Imaging Library] (on some systems called "python-pillow" package) installed.
 
''Note:'' {{cmd|ps.map}} (see also {{AddonCmd|ps.output}}) is a GRASS module, intended to be a stand-alone hardcopy plot generator. It is not meant to be a ''Print'' button for the maps currently displayed in the map canvas, that will need it own controls.
 
The Cartographic Composer is '''available in [http://grass.osgeo.org/download/software/#g64x GRASS 6.4.2+]''' from the Layer manager menu <code>File &rarr; Cartographic Composer</code> or from the toolbar [[Image:print-compose.png]].


The '''Hardcopy Map Output Utility''' (so called {{addonCmd|wx.psmap}}) is a GUI application which allows GRASS users to prepare interactively hardcopy map outputs. The application can write a instructions file for GRASS module {{cmd|ps.map}}, and then run this module on the background to create PostScript output directly. See the [http://lists.osgeo.org/pipermail/grass-user/2011-March/060158.html announcement] in the mailing list.
In [http://grass.osgeo.org/grass7/ GRASS 7] the tool is also available from the command line as stand-alone application ({{cmd|g.gui.psmap}}).


The wx.psmap is '''available in GRASS 6.4.2+''' from the menu
[[Image:wxpsmap-draft.png|center|thumb|480px|Cartographic Composer - draft mode]]


File -> Hardcopy Map Output Utility
== Supported mapping instructions ==


[[Image:wxpsmap-draft.png|center|thumb|480px|wx.psmap - draft mode]]
The GUI currently supports the most important mapping instructions (see also {{cmd|ps.map}} manual page):


The GUI currently supports the most important mapping instructions
* paper
* paper
* scale
* scale
Line 25: Line 27:
* legend
* legend
* text labels
* text labels
* eps (image, north arrow)


<center><gallery widths=300px heights=300px>
<center><gallery widths=300px heights=300px>
Image:wxpsmap-page-setup.png|wx.psmap - page setup dialog
Image:wxpsmap-page-setup.png|Cartographic Composer - page setup dialog
Image:wxpsmap-mapinfo.png|wx.psmap - mapinfo dialog
Image:wxpsmap-mapinfo.png|Cartographic Composer - mapinfo dialog
</gallery></center>
</gallery></center>


<!--== Installation ==
<!--== Installation ==


After installation launch ''Hardcopy Map Output Utility'' from wxGUI menu
After installation launch ''Cartographic Composer'' from wxGUI menu


  File -> Hardcopy Map Output Utility
  File -> Cartographic Composer


=== Requirements ===
=== Requirements ===
Line 62: Line 65:
;In GRASS 6:
;In GRASS 6:


''Note'': {{cmd|g.extension|version=65}} in GRASS 6 doesn't support installing wxGUI extensions. You can install {{addonCmd|wx.psmap}} from ''wxGUI Command prompt'' using Python version of {{cmd|g.extension|version=70}} available as ''g.extension.py''
''Note'': {{cmd|g.extension|version=64}} in GRASS 6 doesn't support installing wxGUI extensions. You can install {{addonCmd|wx.psmap}} from ''wxGUI Command prompt'' using Python version of {{cmd|g.extension}} available as ''g.extension.py''
   
   
  g.extension.py -s svnurl=https://svn.osgeo.org/grass/grass-addons extension=wx.psmap
  g.extension.py -s svnurl=https://svn.osgeo.org/grass/grass-addons extension=wx.psmap
Line 68: Line 71:
[[Image:wxGUI-install-addons-cmd.png|center|480px|thumb|Installing wx.psmap from wxGUI Command Prompt]]-->
[[Image:wxGUI-install-addons-cmd.png|center|480px|thumb|Installing wx.psmap from wxGUI Command Prompt]]-->


== Video tutorial ==
== Video tutorials ==
{{YouTube|ZMwuC14omyA}} {{YouTube|s0gYrGuzzpo}}
 
{{YouTube|ZMwuC14omyA}}
{{YouTube|s0gYrGuzzpo}}
{{YouTube|XKXtwoMh6Kk|desc=How to add north arrow}}
{{YouTube|8o5cRyH3hb8|desc=Raster, legend, vector outline}}
 
== Input ==
== Input ==


Line 81: Line 89:


{{wxGUI}}
{{wxGUI}}
== Map Output Examples ==


[[Category: ps.map]]
[[Category: ps.map]]
<center><gallery widths=300px heights=300px>
Image:DEM SRTM.png| data source: [http://grass.fsv.cvut.cz/gwiki/FreeGeodataCZ FreeGeodataCZ]
Image:StareMesto.png| data source: ZABAGED (http://www.cuzk.cz)
</gallery></center>
Examples were created within A. Kratochvilova's [http://geo.fsv.cvut.cz/proj/bp/2011/anna-kratochvilova-bp-2011.pdf bachelor thesis] (in Czech)
== Acknowledgement ==
wxGUI Cartographic Composer was developed within a bachelor thesis at the [http://www.cvut.cz Czech Technical University in Prague] by Anna Kratochvilova in 2011.

Latest revision as of 21:51, 15 December 2015

For development issues see Trac page.

The Cartographic Composer (so called wx.psmap) is a GUI application which allows GRASS users to prepare interactively hardcopy map outputs. The application can write a instructions file for GRASS module ps.map, and then run this module on the background to create PostScript output directly. See the announcement in the mailing list. See also the manual.

Cartographic Composer is release under GNU GPL licence and the source is available from GRASS SVN repository. The composer is part of core GRASS GIS. To run the composer, it is necessary to have the Python Imaging Library (on some systems called "python-pillow" package) installed.

Note: ps.map (see also ps.output) is a GRASS module, intended to be a stand-alone hardcopy plot generator. It is not meant to be a Print button for the maps currently displayed in the map canvas, that will need it own controls.

The Cartographic Composer is available in GRASS 6.4.2+ from the Layer manager menu File → Cartographic Composer or from the toolbar .

In GRASS 7 the tool is also available from the command line as stand-alone application (g.gui.psmap).

Cartographic Composer - draft mode

Supported mapping instructions

The GUI currently supports the most important mapping instructions (see also ps.map manual page):

  • paper
  • scale
  • maploc
  • rast
  • vects
  • scalebar
  • mapinfo
  • legend
  • text labels
  • eps (image, north arrow)


Video tutorials

How to add north arrow
Raster, legend, vector outline

Input

  • Ability to load in saved ps.map instructions file. I consider this to be a low priority, deal with it after map creation is fully functional. Start with scripts saved using the GUI, after that is working expand to load any ps.map instructions file.

Outputs

  • ps.map instructions file
  • PostScript file
  • PDF file

Map Output Examples

Examples were created within A. Kratochvilova's bachelor thesis (in Czech)

Acknowledgement

wxGUI Cartographic Composer was developed within a bachelor thesis at the Czech Technical University in Prague by Anna Kratochvilova in 2011.