SVGIS

Draw SVG maps

class svgis.svgis.SVGIS(files, bounds=None, crs=None, **kwargs)

Draw geodata files to SVG.

Parameters:

• files (list) – A list of files to draw.
• bounds (Sequence) – An iterable with four float coordinates in (minx, miny, maxx, maxy) format
• crs (dict) – A proj-4 like mapping, or a projection method keyword (file, local, utm).
• style (str) – CSS to add to output file
• scalar (int) – Map scaling factor (output coordinate are multiplied by this)
• style – CSS styles
• padding (number) – Buffer each edge by this many map units.
• precision (int) – Precision for rounding output coordinates.
• simplify (int) – Simplification factor (between 1 and 100).
• id_field (str) – Field in data to use for ID’ing elements.
• class_fields (Sequence) – Fields in data for added classes to elements.

compose(bounds=None, style=None, viewbox=True, inline=True, **kwargs)

Draw files to svg.

Parameters:

• bounds (Sequence) – Map bounding box in WGS84 (longlat) coordinates. Defaults to map data bounds.
• scalar (int) – factor by which to scale the data, generally a small number (1/map scale).
• style (str) – CSS to append to parent object CSS.
• viewbox (bool) – If True, draw SVG with a viewbox. If False, translate coordinates to the frame. Defaults to True.
• inline (bool) – If False, do not add CSS style attributes to each element.
• padding (int) – Number of (projected) units to pad bounds by.
• precision (int) – Precision for rounding output coordinates.

Returns:

str containing an entire SVG document.

compose_file(path, unprojected_bounds=None, **kwargs)

Draw fiona file to an SVG group.

Parameters:

• path (string) – path to a fiona-readable file, or an Apache Commons VFS spec for a zip or tar archive, e.g. zip://path/to/archive.zip/file.shp.
• unprojected_bounds (tuple) – (minx, maxx, miny, maxy) in the layer’s coordinate system. ‘None’ values are OK. “Unprojected” here refers to the fact that we haven’t transformed these bounds yet. They may well, in fact, be in a projection.
• padding (int) – Number of map units by which to pad output bounds.
• scalar (int) – map scale
• class_fields (sequence) – Fields to turn in the element classes (default: self.class_fields).
• id_field (string) – Field to use as element ID (default: self.id_field).

Returns:

members, id, class. This is ready to be passed to svgis.svg.group.

Return type:

A dict with the keys

draw(members, scalar=None, precision=None, style=None, **kwargs)

Combine drawn layers into an SVG drawing.

Parameters:

• members (list) – unicode representations of SVG groups.
• scalar (int) – factor by which to scale the data, generally a small number (1/map scale).
• style (str) – CSS to append to parent object CSS.
• viewbox (bool) – If True, draw SVG with a viewbox. If False, translate coordinates to the frame. Defaults to True.
• inline (bool) – If True, try to run CSS into each element.

Returns:

str containing an entire SVG document.

feature(feature, transforms, classes, datas=None, **kwargs)

Draw a single feature.

Parameters:

• feature (dict) – A GeoJSON like feature dict produced by Fiona.
• transforms (list) – Functions to apply to the geometry.
• classes (list) – Names (unsanitized) of fields to apply as classes in the output element.
• datas (dict) – key-value pairs to add as data-KEY=”value” elements in the output element.
• precision (int) – rounding precision for coordinates.
• id_field (str) – Field to use as id of the output element.
• name (str) – layer name (usually basename of the input file).

Returns:

str

in_crs

Return the CRS being used for input geodata.

out_crs

The output CRS of this drawing

projected_bounds

Returns None if projected bounds aren’t (yet) set

set_in_crs(crs)

Set the CRS to use for input geodata, falling back on the default (WGS84).

set_out_crs(bounds)

Set the output CRS, if not yet set.

unprojected_bounds

Returns None if projected bounds aren’t set

update_projected_bounds(in_crs, out_crs, bounds, padding=None)

Extend projected_bounds bbox with self.padding.

Parameters:

• in_crs (dict) – CRS of bounds.
• out_crs (dict) –
• bounds (tuple) – bounding box.

Returns:

tuple bounding box in out_crs coordinates.

svgis.svgis.map(layers, bounds=None, scale=None, **kwargs)

Draw a geodata layer to SVG. This is shorthand for creating a SVGIS instance and immediately runnning SVGIS.compose.

Parameters:

• layers (sequence) – Input geodata files.
• bounds (sequence) – (minx, miny, maxx, maxy)
• scale (int) – Map scale. Larger numbers -> smaller maps
• padding (int) – Pad around bounds by this much. In projection units.
• crs (string) – EPSG code, PROJ.4 string, or file containing a PROJ.4 string
• clip (bool) – If true, clip features output to bounds.
• style (Sequence) – Path to a css file or a css string.
• class_fields (Sequence) – A comma-separated string or list of class names to use the SVG drawing.
• id_field (string) – Field to use to determine id of each element in the drawing.
• inline (bool) – If False, do not move CSS declarations into each element.
• precision (int) – Precision for rounding output coordinates.
• simplify (int) – Integer between 1 and 99 describing simplification level. 99: not very much. 1: a lot.

Returns:

str containing an entire SVG document.