Welcome to Polytope's documentation!

Polytope is a feature extraction software developed by ECMWF. It uses concepts of computational geometry to extract n-dimensional polygons (also known as polytopes) from datacubes.

In particular, it can be used to request:

  • 2D cut-outs, such as country cut-outs, from a datacube

    Greece cut-out

  • timeseries from a datacube

    Timeseries

  • more complicated spatio-temporal paths, such as flight paths, from a datacube

    Flight path

  • and many more high-dimensional shapes in arbitrary dimensions...

Important

Note that Polytope reads only the user-requested data, instead of whole fields. Importantly, this implies a significant decrease of the I/O usage when reading data from a datacube.

See Overview for more information.

To learn more about how to use Polytope, refer to the User Guide. In particular, see the Quickstart page for a step-by-step example of how to use the Polytope software. For a more in-depth explanation of how Polytope achieves its feature exctraction, refer to the Developer Guide.

Warning

This project is BETA and will be experimental for the foreseeable future. Interfaces and functionality are likely to change. DO NOT use this software in any project/software that is operational.

License

Polytope is available under the open source Apache License. In applying this licence, ECMWF does not waive the privileges and immunities granted to it by virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.