usgs ==== usgs is a Python library for interfacing with the US Geologic Survey's Inventory Service. The Inventory Service supports a variety of requests for accessing USGS datasets, including searching datasets, downloading data products, and accessing metadata on data products. .. note:: Some requests require an account with `USGS's EROS service `_. The account must also have Machine to Machine privileges. Installation ------------ .. code-block:: bash pip install usgs Examples -------- These two examples demonstrate how to access metadata for a Hyperion scene and Landsat 8 scene. Both datasets are part of the EarthExplorer catalog. Hyperion is designated by the dataset ``EO1_HYP_PUB``, Landsat 8 is designated by ``LANDSAT_8``. Python ****** .. code-block:: python from usgs import api # Set the EarthExplorer catalog node = 'EE' # Set the Hyperion and Landsat 8 dataset hyperion_dataset = 'EO1_HYP_PUB' landsat8_dataset = 'LANDSAT_8' # Set the scene ids hyperion_scene_id = 'EO1H1820422014302110K2_SG1_01' landsat8_scene_id = 'LC80290462015135LGN00' # Submit requests to USGS servers api.metadata(hyperion_dataset, node, [hyperion_scene_id]) api.metadata(landsat8_dataset, node, [landsat8_scene_id]) Command Line ************ .. code-block:: bash $ usgs metadata --node EE EO1_HYP_PUB EO1H1820422014302110K2_SG1_01 [ { "metadataUrl": "http://earthexplorer.usgs.gov/metadata/xml/1854/EO1H1820422014302110K2_SG1_01/", "upperLeftCoordinate": { "latitude": 26.253489, "longitude": 21.53022 }, "ordered": false, "acquisitionDate": "2014-10-29T00:00:00Z", "browseUrl": "http://earthexplorer.usgs.gov/browse/eo-1/hyp/182/42/2014/EO11820422014302110K2_SG1_01.jpeg", "dataAccessUrl": "http://earthexplorer.usgs.gov/order/process?dataset_name=EO1_HYP_PUB&ordered=EO1H1820422014302110K2_SG1_01&node=INVSVC", "orderUrl": "http://earthexplorer.usgs.gov/order/process?dataset_name=EO1_HYP_PUB&ordered=EO1H1820422014302110K2_SG1_01&node=INVSVC", "upperRightCoordinate": { "latitude": 26.240475, "longitude": 21.602509 }, "summary": "Entity ID: EO1H1820422014302110K2_SG1_01, Acquisition Date: 29-OCT-14, Target Path: 182, Target Row: 42", "downloadUrl": "http://earthexplorer.usgs.gov/download/external/options/EO1_HYP_PUB/EO1H1820422014302110K2_SG1_01/INVSVC/", "lowerLeftCoordinate": { "latitude": 24.365584, "longitude": 21.074194 }, "modifiedDate": "2014-11-01T13:18:02Z", "startTime": "2014-10-29T07:58:59Z", "sceneBounds": "21.074194,24.352528,21.602509,26.253489", "entityId": "EO1H1820422014302110K2_SG1_01", "endTime": "2014-10-29T07:59:31Z", "lowerRightCoordinate": { "latitude": 24.352528, "longitude": 21.145425 }, "bulkOrdered": false } ] $ usgs metadata --node EE LANDSAT_8 LC80290462015135LGN00 [ { "metadataUrl": "http://earthexplorer.usgs.gov/metadata/xml/4923/LC80290462015135LGN00/", "upperLeftCoordinate": { "latitude": 21.27723, "longitude": -104.10944 }, "ordered": false, "acquisitionDate": "2015-05-15T17:17:09Z", "browseUrl": "http://earthexplorer.usgs.gov/browse/landsat_8/2015/029/046/LC80290462015135LGN00.jpg", "dataAccessUrl": "http://earthexplorer.usgs.gov/order/process?dataset_name=LANDSAT_8&ordered=LC80290462015135LGN00&node=INVSVC", "orderUrl": null, "upperRightCoordinate": { "latitude": 20.90999, "longitude": -102.32534 }, "summary": "Entity ID: LC80290462015135LGN00, Acquisition Date: 15-MAY-15, Path: 29, Row: 46", "downloadUrl": "http://earthexplorer.usgs.gov/download/external/options/LANDSAT_8/LC80290462015135LGN00/INVSVC/", "lowerLeftCoordinate": { "latitude": 19.54002, "longitude": -104.50364 }, "modifiedDate": "2015-05-15T15:20:43Z", "startTime": "2015-05-15T17:16:53Z", "sceneBounds": "-104.50364,19.17102,-102.32534,21.27723", "entityId": "LC80290462015135LGN00", "endTime": "2015-05-15T17:17:25Z", "lowerRightCoordinate": { "latitude": 19.17102, "longitude": -102.73968 }, "bulkOrdered": false } ] Catalogs -------- USGS provides four catalogs, each containing various datasets. All requests made to the Inventory Service must have an associated node. Check each catalog for a list of datasets. +--------------+------------+----------------------------------+ | Catalog | Node Value | URI | +==============+============+==================================+ | :ref:`cwic` | CWIC | http://lsiexplorer.cr.usgs.gov | +--------------+------------+----------------------------------+ | :ref:`ee` | EE | http://earthexplorer.usgs.gov | +--------------+------------+----------------------------------+ | :ref:`hdds` | HDDS | http://hddsexplorer.usgs.gov | +--------------+------------+----------------------------------+ | LPVSExplorer | LPVS | http://lpvsexplorer.cr.usgs.gov/ | +--------------+------------+----------------------------------+ Contents: .. toctree:: :maxdepth: 2 reference/cli reference/api reference/soap reference/catalog/cwic reference/catalog/ee reference/catalog/hdds Indices and tables ================== * :ref:`genindex` * :ref:`modindex`