Skip to main content

Create vector datasets from raster surfaces

Project description

Raster –> vector surface creation tools in python

Installation

From GitHub:

pip install -e git+git@github.com:mapbox/make-surface.git#egg=makesurface

From PyPI

pip install makesurface --pre

Manual

  1. Install dependencies:

‘click>=3.0’, ‘fiona’, ‘numpy’, ‘rasterio’, ‘shapely’, ‘scipy’, ‘mercantile’, ‘pyproj’

  1. Clone this repo:

:console:git clone git@github.com:mapbox/make-surface.git

  1. cd into :console:make-surface then pip install -e .

Usage - Vectorize

makesurface vectorize [OPTIONS] INFILE

Takes an input raster, and converts into a stacked shapefile. Sort of like gdal polygonize with more control, optimized for vector tiles. Also can print out a CartoCSS template for stylizing (one style for each class).

image

image

Options:

--outfile TEXT           Write to GeoJSON
-b, --bidx INTEGER       Input band to vectorize. [default = 1]
-cl, --classes TEXT      Number of output classes, OR "all" for rounded
                         input values (ignored if class file specified)
                         [default = 10]
-cf, --classfile TEXT    One-line CSV of break values [default = None]
-w, --weight FLOAT       Weighting between equal interval and quantile
                         breaks [default = 1 / equal interval]
-s, --smoothing INTEGER  Value by which to zoom and smooth the data [default
                         = None]
-n, --nodata TEXT        Manually defined nodata value - can be any number
                         or "min" [default = None]
-ov, --outvar TEXT       Name of output variable [Default = value]
-set, --setnodata FLOAT  Value to set nodata to (eg, if nodata / masked, set
                         pixel to this value) [default = None]
-c, --carto
-ni, --nibble            Expand mask by 1 pixel
--axonometrize FLOAT     EXPERIMENTAL
-ns, --nosimple
--help                   Show this message and exit.

Usage - Triangulate

makesurface triangulate [OPTIONS] ZOOM

Creates an empty triangular lattice: image0

Options:
  --bounds FLOAT...  Bounding Box ("w s e n") to create lattice in
  --tile INTEGER...  Tile ("x y z") to create lattice in
  --output TEXT      File to write to (.geojson)
  --tableid TEXT     static id for databases
  --help             Show this message and exit.

Usage - fillfacets

makesurface fillfacets [OPTIONS] SAMPLERASTER [INFILE]

Use GeoJSON-like triangle geometry to get average regional raster value for that geometry

image

image

Options:

--output TEXT           Write output to .json [default - print to stdout]
-b, --bidxs TEXT...     Band to sample [default=1]
--zooming INTEGER       Manual upsampling of raster for sampling [Default =
                        upsampling by estimated polygon density]
-np, --noproject        Do not project data
-ogjs, --outputgeojson  Output updated GeoJSON
-bp, --batchprint TEXT
-cl, --color
--help                  Show this message and exit.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

makesurface-0.2.9dev.tar.gz (10.5 kB view details)

Uploaded Source

File details

Details for the file makesurface-0.2.9dev.tar.gz.

File metadata

File hashes

Hashes for makesurface-0.2.9dev.tar.gz
Algorithm Hash digest
SHA256 43d3891426437d004d54ef1dd6b73598dcbb2f98336aa87bd550ba0e019ef392
MD5 a4c106cda04e29b94e6aada4a7869458
BLAKE2b-256 c945d4686c56c9b119384dd5da8b03807bba505aa1f87040fb94893363b49a14

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page