This repository houses definitions of geometric features. These features can include regions, transects, and points. Currently they are described in geojson format. For example, here are some regions for Antarctica.

Data for regions has been derived from sources listed in the contributors file as specified via the author field in each geojson file.

The scripts in the top level directory can be used to help maintain and use this repository. All of them can be run with the -h flag to get usage information.

A typical workflow will look like:

• Build feature list (features.geojson):

• Multiple calls to: ./merge_features.py

• Edit features:

• Edit features.geojson

• Visualize features:

• ./plot_features.py
  (Note: requires cartopy package, e.g., conda install -c scitools cartopy)

• Split features:

• ./split_features.py

Other available scripts include

• combine_features.py - Combine features into a single feature.
• difference_features.py - Mask features using shapes in a second feature file.
• fix_features_at_antimeridian.py - Split a feature at the antimeridian (+/- 180 longitude). The resulting feature has all points between -180 and 180 lon.
• set-group_name.py - Set the "groupName" property of the FeatureCollection
• tag_features.py - Add one or more tags to the "Tag" property of each feature in a file.

IMPORTANT: Always use the split_features.py script when placing features in their respective directories. This will help everyone maintain the repository, and allow tools to parse them cleanly.

An example workflow to select and plot region features is

$ rm features.geojson
$ ./merge_features.py -d ocean -o features.geojson
$ ./merge_features.py -f iceshelves/region/Ronne_1/region.geojson -o features.geojson
$ ./merge_features.py -d landice -o features.geojson
$ ./plot_features.py -f features.geojson -m cyl