# south-up hobo-dyer
./southup.py --names --srs "+proj=cea +axis=wsu +lat_ts=37.5 +ellps=WGS84" hobodyer.pdf

# render to png, image height is computed automatically based on the
# aspect ratio of the projection (mollweide by default)
./southup.py --colors --width 3000 mollweide.png

# a bare white south-up WGS84 long/lat map with a 30 degree grid overlaid
./southup.py --srs "+proj=longlat +axis=wsu +ellps=WGS84 +datum=WGS84 +no_defs" --grid 30 wgs84longlat.pdf

# use a raster base image -- mapnik does not support reprojection of raster
# data, so you'll need to have gdal installed for this to work
./southup.py --raster data/GRAY_50M_SR_OB.tif --colors 13 rasterplusvector.pdf

## usage: southup.py [-h] [--prefix PREFIX] [--raster RASTER]
##                   [--colors [{7,8,9,13}]] [--names]
##                   [--grid [{30,20,15,10,5,1}]] [--xml XML] [--srs SRS]
##                   [--scale SCALE] [-f FORMAT] [-m MARGIN] [--dpi DPI]
##                   [--width WIDTH] [--height HEIGHT]
##                   output
## 
## south up! (and other custom maps made easy)
## 
## positional arguments:
##   output                output filename
## 
## optional arguments:
##   -h, --help            show this help message and exit
## 
## input file options:
##   --prefix PREFIX       Natural earth data set prefix (default: "data/ne_50m")
## 
## visualisation options:
##   --raster RASTER       path to raster file to be used as base layer
##   --colors [{7,8,9,13}], -cols [{7,8,9,13}]
##                         number of fill colours to use for country polygons
##   --names               add country names
##   --grid [{30,20,15,10,5,1}], -g [{30,20,15,10,5,1}]
##                         overlay meridian/parallel grid at given spacing
##   --xml XML, -x XML     mapnik style file (default: southup.xml)
## 
## projection options:
##   --srs SRS             map projection to be used (proj.4 string, default:
##                         "+proj=moll +axis=wsu +ellps=WGS84 +no_defs")
##   --scale SCALE, -s SCALE
##                         map scale denominator (i.e. render map as 1:x)
## 
## output/rendering options:
##   -f FORMAT, --format FORMAT
##                         Cairo target page format (default: "a3l")
##   -m MARGIN, --margin MARGIN
##                         page margin in meters (default: 0.0)
##   --dpi DPI             output dpi (default: 72)
##   --width WIDTH         output width in pixels (for raster output only)
##   --height HEIGHT       output height in pixels (for raster output only)