{"id":44680,"library":"datacube","title":"Open Data Cube","description":"Open Data Cube (ODC) is an open-source analysis environment for satellite and other Earth observation data, providing a gridded data cube abstraction over petabyte-scale archives. Current version is 1.9.20, with regular releases targeting geospatial and remote sensing workflows.","status":"active","version":"1.9.20","language":"python","source_language":"en","source_url":"https://github.com/opendatacube/datacube-core/","tags":["earth-observation","satellite","geospatial","data-cube","remote-sensing"],"install":[{"cmd":"pip install datacube","lang":"bash","label":"Stable release"}],"dependencies":[{"reason":"Core array operations","package":"numpy","optional":false},{"reason":"Labeled multi-dimensional arrays","package":"xarray","optional":false},{"reason":"Reading/writing geospatial raster data","package":"rasterio","optional":false},{"reason":"Caching data cube metadata","package":"cachetools","optional":true}],"imports":[{"note":"","wrong":"","symbol":"datacube","correct":"import datacube"},{"note":"","wrong":"","symbol":"VirtualProduct","correct":"from datacube.model import VirtualProduct"},{"note":"","wrong":"","symbol":"Dataset","correct":"from datacube.model import Dataset"}],"quickstart":{"code":"import datacube\n\n# Quick local test; in production use a proper config\ndc = datacube.Datacube(app='my_app', config='/etc/datacube.conf')\nproducts = dc.list_products()\nprint(products)\n\n# Load some data (adjust product/dataset)\ntry:\n    data = dc.load(product='ls8_nbar_scene', x=(10, 11), y=(40, 41), time=('2020-01-01', '2020-01-10'))\n    print(data)\nexcept Exception as e:\n    print(f\"Loading failure (expected if no ODC backend): {e}\")","lang":"python","description":"Initialize a Datacube instance and list available products. Loading data requires a configured ODC index (PostgreSQL) and product data."},"warnings":[{"fix":"Upgrade to Python >=3.10.","message":"Python 3.10+ required as of datacube 1.9.0; Python 3.9 and below are no longer supported.","severity":"breaking","affected_versions":">=1.9.0"},{"fix":"See migration guide at https://datacube-core.readthedocs.io/en/latest/ops/migration.html","message":"Major API rewrite: `datacube.Datacube()` replaced the legacy `datacube.Datacube(env='...')` and many internal methods changed signatures.","severity":"breaking","affected_versions":">=1.8"},{"fix":"Use `datacube dataset organize` and `datacube dataset sync` instead.","message":"`dc_organise` and `dc_sync` CLI tools are deprecated in favor of `datacube dataset` subcommands.","severity":"deprecated","affected_versions":">=1.8.5"},{"fix":"Set the `DATACUBE_CONFIG_PATH` environment variable or pass a config path to the constructor.","message":"The default config file is `/etc/datacube.conf`; if not present, initializing a Datacube without config will fail silently or raise a cryptic error.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `group_by='time'` for standard UTC days.","message":"`dc.load()` with `group_by='solar_day'` may produce unexpected results if data spans multiple time zones; always inspect the output coordinate. ","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.9.20':36 'abstract':27 'analysi':13 'archiv':32 'cube':3,6,26,53 'current':33 'data':2,5,21,25,52 'data-cub':51 'earth':19,47 'earth-observ':46 'environ':14 'geospati':41,50 'grid':24 'observ':20,48 'odc':7 'open':1,4,11 'open-sourc':10 'petabyt':30 'petabyte-scal':29 'provid':22 'regular':38 'releas':39 'remot':43,55 'remote-sens':54 'satellit':16,49 'scale':31 'sens':44,56 'sourc':12 'target':40 'version':34 'workflow':45","created_at":"2026-06-07T12:51:19.066744+00:00","updated_at":"2026-06-07T12:51:19.066744+00:00","problems":[{"fix":"Run `pip install datacube` and ensure your environment is activated.","cause":"Package not installed or installed in a different virtual environment.","error":"ModuleNotFoundError: No module named 'datacube'"},{"fix":"Start PostgreSQL, verify connection settings in datacube.conf, and ensure the host/port are correct.","cause":"PostgreSQL (database) is not running or misconfigured.","error":"sqlalchemy.exc.OperationalError: (psycopg2.OperationalError) could not connect to server: Connection refused"},{"fix":"Upgrade to the latest version: `pip install --upgrade datacube` and verify with `python -c \"import datacube; print(datacube.__version__)\"`","cause":"Possibly an older version of datacube (pre-1.8) installed, or import conflict with a different package named 'datacube'.","error":"AttributeError: module 'datacube' has no attribute 'Datacube'"},{"fix":"Set AWS credentials via environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`) or configure a `~/.aws/credentials` file.","cause":"ODC is configured to use cloud-hosted data requiring authentication (e.g., AWS S3).","error":"RuntimeError: You must authenticate to use this functionality"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/opendatacube/datacube-core/","github":"https://github.com/opendatacube/datacube-core/","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}