There is a newer version of the record available.

Published March 5, 2026 | Version v0.2.0
Software Open

mkgraticule_planet

Authors/Creators

Description

mkgraticule_planet v0.2.0

This release introduces major/minor graticule support and improves robustness when working with projected planetary coordinate systems.

✨ New features

Major / minor graticule classification

Graticules can now be classified using the -m/--major option.

Example:

python mkgraticule_planet.py -g 10 10 -m 30 30 -srs IAU_2015:40100 phobos_grid.gpkg

The output field grid_type will contain:

  • "major"
  • "minor"

This makes it easy to style and label graticules in QGIS.

Dateline de-duplication

New option:

-ndd / --no-duplicate-dateline

When longitude spans approximately 360° (-180..180), the duplicate meridian can be removed (keeping +180). This is particularly useful for polar stereographic projections.

Safer projected CRS handling

Projected coordinate systems such as polar stereographic have limited valid domains.

The tool now:

  • detects near-global extents for projected CRS
  • aborts with a helpful message by default
  • suggests restricting the geographic extent using -e

Advanced options are available when needed:

-s / --skipfailures
-p / --partial-reprojection

Combining these options may allow partial output near projection domain limits.

🗺 QGIS-friendly output

GeoPackages generated by the tool include:

  • multiple label styles (lat_180, lat_ns, lon_180, lon_ew, lon_360)
  • CRS metadata (definition_12_063) for correct recognition of IAU coordinate systems in QGIS
  • optional grid_type classification for styling

📚 Documentation improvements

The README now includes:

  • global graticule example (Phobos)
  • polar stereographic example (Moon south pole)
  • QGIS styling workflow

🔗 Citation

If you use this software in research, please cite:

Hemmi, R. (2026). mkgraticule_planet. Zenodo. https://doi.org/10.5281/zenodo.18864189

Notes

If you use this software, please cite it as follows.

Files

ryodohemmi/mkgraticule_planet-v0.2.0.zip

Files (3.0 MB)

Name Size Download all
md5:c62842e172e56ddb665f3dc61efa1a47
3.0 MB Preview Download

Additional details

Related works