Recent changes to About MapFramer

About MapFramer modified by Agnar Renolen

Agnar Renolen — Sat, 27 Dec 2014 18:11:30 -0000

--- v6
+++ v7
@@ -28,9 +28,9 @@
 OSX and Linux
 -------------
 Currently, you will have to install Python 2.7 and add ReportLab and PyProj (and their dependencies) manually. You may use pip or easy_install to do that.  Then download the source code using Subversion using the following command:
-~~~~~~~~
-svn checkout svn://svn.code.sf.net/p/mapframer/code/ mapframer-code
-~~~~~~~
+
+    svn checkout svn://svn.code.sf.net/p/mapframer/code/ mapframer-code
+

 The XML-file

About MapFramer modified by Agnar Renolen

Agnar Renolen — Sat, 27 Dec 2014 18:10:36 -0000

--- v5
+++ v6
@@ -1,35 +1,46 @@
 What is MapFramer?
 ================

-MapFramer is a simple command line tool that I wrote in Python to help automate the process of creating and designing frames around maps that contain coordinate ticks, coordinate value, title ans so forth.
+MapFramer is a simple command line tool that I wrote in Python to help automate the process of creating and designing frames around maps that contain coordinate ticks, coordinate values, title and so forth.

-Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used. 
+Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or spatial reference system used. 

-MapFramer then parses this file along with the command line arguments, and creates a PDF-file for the frame. If you have Adobe Illustrator, you can open your map frame in Illustrator, and if you have your map in illustrator- or  PDF-format too, it easy to put your frame on top of the map, using Illustrator, or even Adobe InDesign.
+MapFramer then parses this file along with the command line arguments, and creates a PDF-file for the frame. If you have Adobe Illustrator, you can open your map frame in Illustrator, and if you have your map in illustrator- or in PDF-format too, it easy to put your frame on top of the map, using Illustrator, or even Adobe InDesign.

 At the current stage, MapFramer is rather crude (after all, this was my first Python project); you can't do a whole lot with it, but if you need more sophisticated content, you can add that in Illustrator.

 Getting MapFramer
 ===============
 MapFramer is a free software copylefted by me under the GPL license, version 3.
-It is hosted on sourceforge.net, at mapframer.sourceforge.net
+It is hosted on sourceforge.net, here at mapframer.sourceforge.net

-Currently, executables are available only under the windows platform. But by obtaining the source (using Subversion), installing Python 2.7 and the dependent libraries Reportlab and PyPROJ, you can even use it on OSX and Linux.
+Currently, executables are available only under the windows platform. But by obtaining the source (using Subversion), installing Python 2.7 and the dependent libraries, Reportlab and PyProj, you can even use it on OSX and Linux.

 Executables for other platforms is on the wish list. If you are a developer and know how to do it, I'm happy to accept some help.

-Installing MapFramer
+Installing and running MapFramer
 ================
-To be written
+
+Windows
+-------
+Simply download and run the installer.  Then you may start the MapFramer shell which basically is an ordinary CMD window, but with the path to the mapframer.exe file set up for you.
+
+OSX and Linux
+-------------
+Currently, you will have to install Python 2.7 and add ReportLab and PyProj (and their dependencies) manually. You may use pip or easy_install to do that.  Then download the source code using Subversion using the following command:
+~~~~~~~~
+svn checkout svn://svn.code.sf.net/p/mapframer/code/ mapframer-code
+~~~~~~~
+

 The XML-file
 ==========
 The content of the XML file is described in the [XML-specification].
-Although, not directly used by MapFramer to validate the XML (actually refering to the DTD in the XML-file as DOCTYPE will cause errors), a [DTD-File] has been produced.
+Although, not directly used by MapFramer to validate the XML (actually referring to the DTD in the XML-file as DOCTYPE will cause errors), a [DTD-File] has been produced.

 Running MapFramer
 ================
-MapFramer is invoked using the following command in your cammand shell.
+MapFramer is invoked using the following command in your command shell.

     mapframer [-h] [-s map_scale] [-p srs]
               [-b minx miny maxx maxy] [-o pdf_file] xml_file

About MapFramer modified by Agnar Renolen

Agnar Renolen — Thu, 25 Dec 2014 23:09:15 -0000

--- v4
+++ v5
@@ -3,7 +3,7 @@

 MapFramer is a simple command line tool that I wrote in Python to help automate the process of creating and designing frames around maps that contain coordinate ticks, coordinate value, title ans so forth.

-Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used. (See the [XML-specification])
+Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used. 

 MapFramer then parses this file along with the command line arguments, and creates a PDF-file for the frame. If you have Adobe Illustrator, you can open your map frame in Illustrator, and if you have your map in illustrator- or  PDF-format too, it easy to put your frame on top of the map, using Illustrator, or even Adobe InDesign.

@@ -25,7 +25,7 @@
 The XML-file
 ==========
 The content of the XML file is described in the [XML-specification].
-Although, not directly used by MapFramer to validate the XML (actually refering to the DTD in the XML-file as DOCTYPE will cause errors), a DTD-file has been produced.
+Although, not directly used by MapFramer to validate the XML (actually refering to the DTD in the XML-file as DOCTYPE will cause errors), a [DTD-File] has been produced.

 Running MapFramer
 ================

About MapFramer modified by Agnar Renolen

Agnar Renolen — Thu, 25 Dec 2014 23:02:52 -0000

--- v3
+++ v4
@@ -3,7 +3,7 @@

 MapFramer is a simple command line tool that I wrote in Python to help automate the process of creating and designing frames around maps that contain coordinate ticks, coordinate value, title ans so forth.

-Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used. 
+Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used. (See the [XML-specification])

 MapFramer then parses this file along with the command line arguments, and creates a PDF-file for the frame. If you have Adobe Illustrator, you can open your map frame in Illustrator, and if you have your map in illustrator- or  PDF-format too, it easy to put your frame on top of the map, using Illustrator, or even Adobe InDesign.

About MapFramer modified by Agnar Renolen

Agnar Renolen — Thu, 25 Dec 2014 21:39:27 -0000

--- v2
+++ v3
@@ -43,20 +43,20 @@
   --help
   print help message
  
-  -s map_scale
-  --scale map_scale
+  -s map_scale
+  --scale map_scale
   map scale denominator
  
-  -p srs
-  --srs srs
+  -p srs
+  --srs srs
   spatial reference system(any string accepted by the PROJ.4 library)
  
-  -b minx miny maxx maxy
-  --bounds minx miny maxx maxy
+  -b minx miny maxx maxy
+  --bounds minx miny maxx maxy
   geographical bounds of map frame
  
-  -o pdf_file
-  --output pdf_file
+  -o pdf_file
+  --output pdf_file
   Name of PDF file to output (defaults to the name of the xml-file but with pdf-extension). Any existing PDF-file will be overwritten

About MapFramer modified by Agnar Renolen

Agnar Renolen — Thu, 25 Dec 2014 21:36:36 -0000

--- v1
+++ v2
@@ -37,20 +37,29 @@
 Arguments
 ---------

-short argument         | long argument                 | explanation
------------------------------------------------------------------------------------------------------
--h                     |  --help                       | print help message
------------------------------------------------------------------------------------------------------
--s map_scale           |  --scale map_scale            | map scale denominator
------------------------------------------------------------------------------------------------------
--p srs                 |  --srs srs                    | spatial reference system
-                       |                               | (any string accepted by the PROJ.4 library)
------------------------------------------------------------------------------------------------------
--b minx miny maxx maxy |  --bounds minx miny maxx maxy | geographical bounds of map frame
------------------------------------------------------------------------------------------------------
--o pdf_file            |  --output pdf_file            | Name of PDF file to output.
-                                                       | (defaults to the xml
------------------------------------------------------------------------------------------------------
+
+ 
+  
+  
+  
+ 
+  
+  
+  
+ 
+  
+  
+  
+ 
+  
+  
+  
+ 
+  
+  
+  
+ 
+-h --help print help message
-s map_scale --scale map_scale map scale denominator
-p srs --srs srs spatial reference system(any string accepted by the PROJ.4 library)
-b minx miny maxx maxy --bounds minx miny maxx maxy geographical bounds of map frame
-o pdf_file --output pdf_file Name of PDF file to output (defaults to the name of the xml-file but with pdf-extension). Any existing PDF-file will be overwritten

 ** NOTE: ** map_scale and map bounds must be specified either in the XML file or on the command line.  If it is not specified either place, mapframer will exit wit error.

About MapFramer modified by Agnar Renolen

Agnar Renolen — Thu, 25 Dec 2014 21:28:36 -0000

What is MapFramer?

MapFramer is a simple command line tool that I wrote in Python to help automate the process of creating and designing frames around maps that contain coordinate ticks, coordinate value, title ans so forth.

Basically, you 'design' the map frame by writing an XML-file specifying the various components of the frame. This may even include the geographical bounds of the map, the map scale and the map projection or sparial reference system used.

MapFramer then parses this file along with the command line arguments, and creates a PDF-file for the frame. If you have Adobe Illustrator, you can open your map frame in Illustrator, and if you have your map in illustrator- or PDF-format too, it easy to put your frame on top of the map, using Illustrator, or even Adobe InDesign.

At the current stage, MapFramer is rather crude (after all, this was my first Python project); you can't do a whole lot with it, but if you need more sophisticated content, you can add that in Illustrator.

Getting MapFramer

MapFramer is a free software copylefted by me under the GPL license, version 3.
It is hosted on sourceforge.net, at mapframer.sourceforge.net

Currently, executables are available only under the windows platform. But by obtaining the source (using Subversion), installing Python 2.7 and the dependent libraries Reportlab and PyPROJ, you can even use it on OSX and Linux.

Executables for other platforms is on the wish list. If you are a developer and know how to do it, I'm happy to accept some help.

Installing MapFramer

To be written

The XML-file

The content of the XML file is described in the [XML-specification].
Although, not directly used by MapFramer to validate the XML (actually refering to the DTD in the XML-file as DOCTYPE will cause errors), a DTD-file has been produced.

Running MapFramer

MapFramer is invoked using the following command in your cammand shell.

mapframer [-h] [-s map_scale] [-p srs]
          [-b minx miny maxx maxy] [-o pdf_file] xml_file

Arguments

short argument | long argument | explanation

-h | --help | print help message

-s map_scale | --scale map_scale | map scale denominator

-p srs | --srs srs | spatial reference system
| | (any string accepted by the PROJ.4 library)

-b minx miny maxx maxy | --bounds minx miny maxx maxy | geographical bounds of map frame

-o pdf_file | --output pdf_file | Name of PDF file to output.
| (defaults to the xml

NOTE: map_scale and map bounds must be specified either in the XML file or on the command line. If it is not specified either place, mapframer will exit wit error.

NOTE: the spatial reference system (srs) must be specified only if your map frame contains graticule elements, either in the XML-file, or at command line.

-h	--help	print help message
-s map_scale	--scale map_scale	map scale denominator
-p srs	--srs srs	spatial reference system(any string accepted by the PROJ.4 library)
-b minx miny maxx maxy	--bounds minx miny maxx maxy	geographical bounds of map frame
-o pdf_file	--output pdf_file	Name of PDF file to output (defaults to the name of the xml-file but with pdf-extension). Any existing PDF-file will be overwritten