coincident.io.download.fetch_neon_lpc_tiles#

coincident.io.download.fetch_neon_lpc_tiles(aoi, datetime_str, site_id, output_dir=None)#

Fetch NEON LPC tile bboxes as a GeoDataFrame (in EPSG:4326), optionally writing to disk as a GeoJSON. This function uses regex and assumes a tile size of 1km for all NEON tiles given the necessity for client-side spatial filtering and no PDAL

Steps:

  1. Convert the datetime string to YYYY-MM for the API query.

  2. Determine the appropriate UTM CRS for spatial filtering.

  3. Query the NEON API for LPC files.

  4. Filter files whose 1km tile intersects the AOI in UTM.

  5. Parse each filename for its lower left UTM corner, build a 1km box.

  6. Assemble into a GeoDataFrame and reproject to EPSG:4326.

  7. If output_dir is provided, save the GeoDataFrame as lpc_tiles.geojson.

Parameters:

  • aoi (gpd.GeoDataFrame) – AOI geometries.

  • datetime_str (str) – Date in “YYYY-MM-DD” format.

  • site_id (str) – NEON site identifier.

  • output_dir (Optional[str]) – Directory to write lpc_tiles.geojson. If None, nothing is written.

Returns:

Tile extent polygons in lon/lat.

Return type:

gpd.GeoDataFrame