Introduction#

coincident simplifies access to a curated set of datasets of relevance to NASA STV studies. It is designed to simplify working with disparate metadata for areal and satellite remote sensing datasets. coincident relies heavily on GeoPandas in that metadata records are always returned as GeoDataFrame objects, and most methods are written to operate either on entire dataframes or single rows within a dataframe.

Dataset aliases#

import coincident

coincident.datasets.aliases

Unified search function#

the coincident package provides a search() method that has the same syntax regardless of which dataset you are searching. Behind the scenes, polygons intersecting your area of interest are efficiently located and returned as a geodataframe.

aoi = gpd.read_file(
    "https://raw.githubusercontent.com/unitedstates/districts/refs/heads/gh-pages/states/CO/shape.geojson"
)
gf = coincident.search(
    dataset="3dep",
    intersects=aoi,
    datetime=["2018", "2024"],
)
gf.explore(column="workunit", popup=True)

Convenience functions#

coincident also provides a number of convenience functions, some of which only pertain to specific datasets. For example, loading raster imagery via Xarray or creating visualizations of browse imagery. Refer to the API Docs for a listing of functions.