gedih3.egi
==========

.. py:module:: gedih3.egi

.. autoapi-nested-parse::

   
   EGI (EASE Grid Index) Module

   A spatial indexing system for GEDI data using the EASE-Grid 2.0 projection (EPSG:6933).
   This module provides square pixel indexing compatible with GEDI L4B products.












   .. rubric:: Notes

   - 12 resolution levels from ~1m to ~160km
   - Hash-based coordinate encoding for efficient storage and queries
   - Native alignment with GEDI L4B raster products
   - Seamless integration with pandas/GeoPandas DataFrames
   - Direct rasterization without resampling artifacts

   **Resolution levels:** Level 1 ~1m · Level 4 ~100m (NISAR) · Level 5 ~200m (BIOMASS) ·
   Level 6 ~1km (GEDI baseline) · Level 7 ~2km · Level 8 ~10km · Level 12 ~160km (partition).
   See ``egi.RESOLUTIONS`` for full table.


   .. rubric:: Examples

   >>> import gedih3.egi as egi
   >>> gdf = egi.egi_dataframe(shots_df, level=6)   # ~1km resolution
   >>> coarse_gdf = egi.egi_to_parent(gdf, parent_level=8)
   >>> agg_gdf = egi.egi_aggregate(gdf, mapper='mean')
   >>> raster = egi.geodf_to_raster(agg_gdf, columns=['agbd_mean'])

   ..
       !! processed by numpydoc !!


Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/gedih3/egi/config/index
   /autoapi/gedih3/egi/core/index
   /autoapi/gedih3/egi/dataframe/index
   /autoapi/gedih3/egi/raster/index
   /autoapi/gedih3/egi/spatial/index