geoips is a free software program, using the NRL Open License Agreement.
Distribution Statement A. Approved for public release. Distribution is unlimited.
This source code is protected under the license referenced at
https://github.com/NRLMMD-GEOIPS.
Distribution Statement
GeoIPS ® Documentation#
Date: Jul 23, 2026 Version: 2.0.0a0
Previous versions: Documentation of previous geoips versions are available at github.com/NRLMMD-GEOIPS.
Useful links: Source Repository | GeoIPS License | Migrating to 2.0 | NRLMMD | CIRA
Introduction#
GeoIPS (Geolocated Information Processing System) is an extensible, open-source Python framework designed to process any dataset with latitude and longitude coordinates. It is plugin-based, allowing users to easily extend its functionality without modifying the core codebase. Users can add new plugins for data reading, interpolation, processing algorithms, output formatting, etc., enabling the generation of both imagery and structured data products. Plugins can be employed in Python scripts/packages or configured in YAML files to produce consistent, reliable, infrastructure-as-code Workflows.
Scientific workflows frequently require transforming geolocated data into consistent imagery and derived products. Whether working with satellite observations, model output, or field measurements, researchers and operational centers must combine data reading, coordinate transformations, interpolation, algorithm application, and output formatting into reproduceable pipelines. These functions and their combined workflows are often implemented as ad-hoc scripts that become very difficult to extend, reuse, and put into production.
GeoIPS is a plugin-based Python framework, originally designed for production meteorological applications and currently used in real-time environments. Since becoming open-source, we have worked to adapt GeoIPS for broader community use and improve user experience. GeoIPS’ architecture is general to any dataset that has associated latitude and longitude coordinates. The package’s two main goals are to help scientists avoid reinventing existing functionality and to facilitate the transition of scientific work to those who want to use it in production.
GeoIPS separates data reading, interpolation, processing algorithms, output formatting, and other functions into plugins that can be pieced together into novel and reproducible workflows. The system supports generation of imagery and structured data products, enabling consistent transformation from input geolocated data products to analysis- and publication-ready outputs.
A quick introduction to geoips, including an overview of the package, system requirements, installation instructions, a quick start guide, and best practices.
The reference guide contains a detailed description of geoips API. The reference describes how the methods work and which parameters can be used. It assumes that you have an understanding of the key concepts.
