Skip to main content

fio_planet: Fiona CLI plugins from Planet Labs.

Project description

fio-planet

A package of Fiona CLI plugins from Planet Labs.

Documentation Status

These CLI commands are for creating Unix pipelines which manipulate streams of GeoJSON features. Such pipelines provide a subset of the functionality of more complicated tools such as GeoPandas, PostGIS, or QGIS, and are intended for use with streams of hundreds of features, where the overhead of JSON serialization between pieces of a pipeline is tolerable.

Installation

python -m pip install --user fio-planet

Usage

fio-planet adds filter, map, and reduce commands to Fiona's fio program. These commands afford some of the capabilities of spatial SQL, but act on features of a GeoJSON feature sequence instead of rows of a spatial RDBMS table. fio-filter decimates a seqence of features, fio-map multiplies and transforms features, and fio-reduce turns a sequence of many features into a sequence of exactly one. In combination, many transformations are possible.

Expressions take the form of parenthesized lists which may contain other expressions. The first item in a list is the name of a function or method, or an expression that evaluates to a function. The second item is the function's first argument or the object to which the method is bound. The remaining list items are the positional and keyword arguments for the named function or method. The list of functions and callables available in an expression includes:

  • Python operators such as +, /, and <= plus truth, not, and is
  • Python builtins such as dict, list, and map
  • All public functions from itertools, e.g. islice, and repeat
  • All functions importable from Shapely 2.0, e.g. Point, and unary_union
  • All methods of Shapely geometry classes
  • Functions specific to fio-planet

Here's an expression that evaluates to a Shapely Point instance.

(Point 0 0)

Point is a callable instance constructor and the pair of 0 values are positional arguments. Note that the outermost parentheses of an expression are optional.

Here's an expression that evaluates to a Polygon, using buffer.

buffer (Point 0 0) :distance 1.0

The inner expression (Point 0 0) evaluates to a Shapely Point instance, buffer evaluates to shapely.buffer(), and :distance 1.0 assigns a value of 1.0 to that method's distance keyword argument.

In a fio-planet expression, all coordinates and geometry objects are in the OGC:CRS84 reference system, like GeoJSON. However, function arguments related to length or area, such as buffer's distance argument, are understood to have units of meters.

fio-filter and fio-map evaluate expressions in the context of a GeoJSON feature and its geometry attribute. These are named f and g. For example, here is an expression that tests whether the input feature is within 50 meters of the given point.

<= (distance g (Point -105.0 39.753056)) 50.0

fio-reduce evaluates expressions in the context of the sequence of all input geometries, which is named c. For example, this expression dissolves input geometries using Shapely's unary_union.

unary_union c

Support

Documentation is hosted at Read the Docs: https://fio-planet.readthedocs.io/en/latest/.

For usage help, please use the project discussion forum or email developers@planet.com.

If you think you've found a bug, please use the project issue tracker.

Roadmap

Version 1.0 adds filter, map, and reduce to Fiona's fio CLI.

Note that there are no conditional forms in 1.0's expressions. The project will likely add a cond after 1.0.

Contributing

Before 1.0 the project is looking for feedback on the existing commands more than it is looking for new commands.

The project uses black, flake8, mypy, and tox for static checks and testing.

black src tests && flake8 && mypy && tox

Authors and acknowledgment

Contributors to this project are

License

Apache License, Version 2.0.

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

fio_planet-1.0.1.tar.gz (58.2 kB view details)

Uploaded Source

Built Distribution

fio_planet-1.0.1-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file fio_planet-1.0.1.tar.gz.

File metadata

  • Download URL: fio_planet-1.0.1.tar.gz
  • Upload date:
  • Size: 58.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for fio_planet-1.0.1.tar.gz
Algorithm Hash digest
SHA256 40a869ad1e02f9aacbebfbecbe13bec2183f00a3281848dc2e81fa1fed91f771
MD5 145c78399e78c3964850484eccc038d6
BLAKE2b-256 9bb5a66e60ebdaddbbe747cc377edb8d9b150460f5a5dfb049b96ed658ae3c54

See more details on using hashes here.

Provenance

File details

Details for the file fio_planet-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: fio_planet-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 16.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for fio_planet-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c996cd5d4d19f6adcc967d9e804092df74dc13e2d614dfee58c06971cc9138a1
MD5 62a420b7d1db2309810bd0b8d863b68f
BLAKE2b-256 6ba85aca201d8238f12013ebb671da39915b4e5c3a037ba536468bd3b79a1703

See more details on using hashes here.

Provenance

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