{"id":24529,"library":"rio-stac","title":"rio-stac","description":"Create SpatioTemporal Asset Catalog (STAC) Items from raster datasets using Rasterio. Version 0.12.0 dropped Python 3.9 support. Release cadence is irregular, with several minor releases per year.","status":"active","version":"0.12.0","language":"python","source_language":"en","source_url":"https://github.com/developmentseed/rio-stac","tags":["stac","raster","geospatial","rasterio"],"install":[{"cmd":"pip install rio-stac","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core dependency for raster I/O","package":"rasterio","optional":false},{"reason":"For STAC item creation","package":"pystac","optional":false}],"imports":[{"note":"rio_stac has no submodule named 'stac'; the main module is the package itself.","wrong":"from rio_stac import stac","symbol":"rio_stac","correct":"import rio_stac"},{"note":"No 'stac' function; use rio_stac.create_stac_item() directly.","wrong":"from rio_stac import stac","symbol":"stac","correct":"import rio_stac"}],"quickstart":{"code":"import rio_stac\nfrom pystac import Item\n\n# Create a STAC item from a raster file\nitem = rio_stac.create_stac_item(\n    \"https://example.com/sample.tif\",\n    input_datetime=\"2023-01-01T00:00:00Z\",\n    assets={\"image\": {\"href\": \"https://example.com/sample.tif\"}},\n)\nprint(item.to_dict())","lang":"python","description":"Create a basic STAC Item from a raster URL."},"warnings":[{"fix":"Upgrade Python to 3.10 or higher, or pin rio-stac to <0.12.0.","message":"Dropped Python 3.9 support in version 0.12.0. Python 3.10+ required.","severity":"breaking","affected_versions":">=0.12.0"},{"fix":"Always supply `input_datetime` explicitly, or ensure the raster has valid TIFF DateTime tags.","message":"The `input_datetime` parameter is required for `create_stac_item()`. If the raster's TIFF tags contain a datetime, it can be parsed automatically (use `input_datetime=None`), but this may fail silently.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `geometry` instead of `geom`.","message":"The `geom` parameter in `create_stac_item` was deprecated in 0.10.0 in favor of `geometry`.","severity":"deprecated","affected_versions":"<0.10.0"},{"fix":"Use absolute URIs for asset hrefs.","message":"When using `assets` parameter, the 'href' inside each asset must be an absolute URL or local path; relative paths may cause unexpected errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `rio_stac.create_stac_item()` directly.","cause":"Incorrect import pattern: `from rio_stac import stac` or `rio_stac.stac(...)`","error":"AttributeError: module 'rio_stac' has no attribute 'stac'"},{"fix":"Pass an ISO datetime string or set to None (but prefer explicit datetime).","cause":"Missing the required `input_datetime` parameter.","error":"TypeError: create_stac_item() missing 1 required positional argument: 'input_datetime'"},{"fix":"Always provide an explicit `input_datetime` parameter.","cause":"The TIFF tags do not contain a valid datetime or the format is unsupported.","error":"rio_stac.errors.DateParsingError: Could not parse datetime from raster metadata"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}