Public API

These are the classes and functions we support being called from outside GeoEco itself. We do our best to document them well and refrain from changing them in ways that would break external callers once they’ve been defined. There are some examples of using these classes and functions here. Some classes also have example code in their class documentation.

Datasets

Classes that provide a common wrapper around tabular and gridded datasets accessible through various software frameworks. These were developed in the 2000s for GeoEco’s internal use and predate more recent, widely-used frameworks that may provide similar functionality with additional features or a more polished interface. When GeoEco was ported to Python 3, we decided to expose these to external callers in case they were useful. While we do not want to discourage you from taking advantage of these classes, if you are building a complex project that must be maintained long-term (rather than a one-off script or scientific analysis), we encourage you to consider similar frameworks that have greater adoption and a robust, well-funded developer community that supports their long-term maintenance.

`GeoEco.Datasets`	Base classes that provide a common wrapper around tabular and gridded datasets accessible through various software frameworks.
`GeoEco.Datasets.ArcGIS`	`Table` and `Grid` wrappers around tabular, vector, and raster datasets accessible through the ArcGIS arcpy library.
`GeoEco.Datasets.Collections`	General purpose `DatasetCollection`s.
`GeoEco.Datasets.GDAL`	A `FileDatasetCollection` and `Grid` for accessing rasters and raster bands through the Geospatial Data Abstraction Library (GDAL).
`GeoEco.Datasets.HDF4`	A `FileDatasetCollection` and `Grid` for accessing 2D, 3D, and 4D scientific datasets (SDSes) in HDF version 4 files through the Python pyhdf module.
`GeoEco.Datasets.NetCDF`	A `FileDatasetCollection` and `Grid` for accessing 2D, 3D, and 4D gridded variables in netCDF files through the Python netCDF4 module.
`GeoEco.Datasets.SQLite`	A `Table` for accessing SQLite tables accessible through Python's built in `sqlite3` module.
`GeoEco.Datasets.Virtual`	`Grid`s and `DatasetCollection`s that transform `Grid`s and `DatasetCollection`s, lazily if possible.

Data Management

Utility classes and methods for basic manipulation of different kinds of data. Much of the functionality provided here is available in modules in Python’s Standard Library or official third-party libraries for specific data formats. For basic functionality, we encourage you to use those rather than taking a dependency on the classes and functions provided here, unless they are particularly convenient or provide something the standard libraries are missing. The purpose of these is to expose some basic operations as ArcGIS geoprocessing tools, to fill in what we considered to be gaps in ArcGIS’s collection of tools circa 2010 or so. These functions also wrap these basic operations with logging, so that other modules in the GeoEco package can use them and gain automatic logging of basic operations.

`GeoEco.DataManagement.ArcGISRasters`	Functions for common operations with rasters, implemented using ArcGIS's arcpy Python package.
`GeoEco.DataManagement.Directories`	Functions for common directory operations.
`GeoEco.DataManagement.Fields`	Functions for calculating field values from Python expressions.
`GeoEco.DataManagement.Files`	Functions for common file operations.

Data Products

Grid and DatasetCollection wrappers around some commonly-used marine data products. The wrappers allow these products to be easily used with the rest of GeoEco, particularly the classes and functions in the sub-packages of the Datasets package. The wrappers’ documentation include some examples of this.

`GeoEco.DataProducts.CMEMS`	Classes for accessing oceanographic datasets published by Copernicus Marine Service.
`GeoEco.DataProducts.NASA.Earthdata`	Classes for accessing data products from NASA Earthdata.
`GeoEco.DataProducts.NASA.PODAAC`	Classes for accessing data products from NASA JPL PO.DAAC.
`GeoEco.DataProducts.NOAA.ClimateIndices`	Functions for working with NOAA climate indices.

Spatial and Temporal Analysis

Classes with functions that perform various spatial and temporal analysis tasks.

GeoEco.SpatialAnalysis.Interpolation

Functions for interpolating in space and time.

Accessing R from Python

Provides the RWorkerProcess class, which starts R as a child process and allows getting and setting of variables in the R interpreter and evaluation of R expressions.

GeoEco.R

Classes that facilitate invoking R from Python.