{
    "info": {
        "author": "Yann Forget",
        "author_email": "yannforget@mailbox.org",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "Intended Audience :: Developers",
            "Intended Audience :: Science/Research",
            "License :: OSI Approved :: MIT License",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Topic :: Scientific/Engineering :: GIS"
        ],
        "description": "[![DOI](https://zenodo.org/badge/145747919.svg)](https://zenodo.org/badge/latestdoi/145747919)\n\n## Description\n\n**ASARapi** is a simple Python command-line program that allows you to search the [ESA Online Catalogue](http://esar-ds.eo.esa.int/sxcat) for SAR images produced by the [ERS-1](https://earth.esa.int/web/sppa/mission-performance/esa-missions/ers-1) (1991-2000), [ERS-2](https://earth.esa.int/web/sppa/mission-performance/esa-missions/ers-2) (1995-2011), or [Envisat](https://earth.esa.int/web/sppa/mission-performance/esa-missions/envisat) (2002-2012) satellites and to download them.\n\nThe following collections are supported:\n\n* `ASA_IMP_1P`: Level 1 products for ENVISAT ASAR Image Mode Precision Image.\n* `ASA_IMS_1P`: Level 1 products for ENVISAT ASAR Image Mode Single-Look\n  Complex.\n* `SAR_IMP_1P`: Level 1 products for ERS SAR Precision Image.\n* `SAR_IMS_1P`: Level 1 products for ERS SAR Single-Look Complex.\n\n## Installation\n\n**ASARapi** can be installed using `pip`.\n\n```sh\npip install asarapi\n```\n\n## Usage\n\n### Sync database\n\n**ASARapi** is designed to work with a local SQLite dump of the ESA Online Catalogue in order to speed up spatial queries. Therefore, the database must be downloaded before using the program by running the `sync` subcommand.\n\n```bash\nasarapi sync\n```\n\nThe file will be stored in your user data directory, e.g. `~/.local/share/asarapi` on Linux, `/Users/<user>/Library/Application Support/asarapi` on OSX, or `C:\\Users\\<user>\\AppData\\Local\\asarapi` on Windows.\n\nPlease see [`yannforget/esa-online-catalogue`](https://github.com/yannforget/esa-online-catalogue) for further details regarding the scraping of the ESA Online Catalogue.\n\n### Search the catalog\n\n#### Usage\n\n```\nUsage: asarapi search [OPTIONS]\n\n  Search for ERS and Envisat products.\n\nOptions:\n  --geojson PATH                  GeoJSON footprint.\n  --start TEXT                    Start date (YYYY-MM-DD).\n  --stop TEXT                     Stop date (YYYY-MM-DD).\n  --latlon FLOAT...               Decimal lat/lon.\n  --bounds FLOAT...               (max_lat, max_lon, min_lat, min_lon).\n  --platform TEXT                 Platform of interest (ERS or ENVISAT, default = all)\n  --product TEXT                  Product type (Precision (default) or Single-Look).\n  --polarisation TEXT             Polarisation channels (default = all).\n  --orbit [ascending|descending]  Orbit direction (default = all).\n  --contains                      Footprint contained by input geom (default = False).\n  --limit INTEGER                 Max. number of results (default = 500).\n  --output PATH                   Output CSV file.\n  --help                          Show this message and exit.\n```\n\nBy default, `asarapi search` will output the product IDs that satisfy the query. A CSV file containing the metadata and the footprint of each scene can be generated with the `--output` option.\n\n#### Examples\n\n```sh\n# All available products between 1995 and 1999 according to an area of interest\n# defined in a GeoJSON file.\nasarapi search --start 1995-01-01 --stop 1999-12-31 --geojson aoi.geojson\n\n# All available products between 1995 and 1999 that intersect the given location\nasarapi search --start 1995-01-01 --stop 1999-12-31 --latlon 16.27 -0.04\n\n# Envisat Single-Look Complex images for a given AOI\nasarapi search --start 2002-01-01 --stop 2005-01-01 --geojson aoi.geojson \\\n        --platform envisat --product single-look --orbit descending\n\n# Write the result of a query in a .CSV file\nasarapi search --start 1995-01-01 --stop 1999-12-31 --geojson aoi.geojson \\\n        --output products.csv\n```\n\n### Download a product\n\n#### Usage\n\nTo download products, you will need [ESA SSO](https://eo-sso-idp.eo.esa.int) credentials. Register for free [here](https://eo-sso-idp.eo.esa.int/idp/umsso20/registration).\n\n```sh\nUsage: asarapi download [OPTIONS] PRODUCT\n\n  Download an ERS or Envisat product.\n\nOptions:\n  -u, --username TEXT   ESA SSO username.\n  -p, --password TEXT   ESA SSO password.\n  -o, --outputdir PATH  Output directory.\n  --help                Show this message and exit.\n```\n\n#### Example\n\n```sh\nasarapi download -u <esa_sso_username> -p <esa_sso_password> \\\n        \"SAR_IMP_1PNESA20030215_091621_00000015A081_00465_40900_0000\"\n```\n\n## API\n\n**ASARapi** can also be used in custom Python scripts:\n\n```python\nfrom datetime import datetime\nfrom shapely.geometry import Point\nfrom asarapi.catalog import query\nfrom asarapi.download import log_in, log_out, request_download\n\nusername = esa_sso_username\npassword = esa_sso_password\noutput_dir = '../data'\nlocation = Point(16.84, -0.04)\n\nresults = query(\n    area=location.wkt,\n    start=datetime(1999, 1, 1),\n    stop=datetime(2002, 1, 1),\n    orbit='ascending'\n)\n\nsession = log_in(username, password)\nfor product_id in results.index:\n    request_download(session, product_id, output_dir)\nlog_out(session)\n```\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/yannforget/asarapi",
        "keywords": "earth observation,gis,remote sensing",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "asarapi",
        "package_url": "https://pypi.org/project/asarapi/",
        "platform": "",
        "project_url": "https://pypi.org/project/asarapi/",
        "project_urls": {
            "Homepage": "https://github.com/yannforget/asarapi"
        },
        "release_url": "https://pypi.org/project/asarapi/0.6/",
        "requires_dist": [
            "requests",
            "click",
            "pandas",
            "tqdm",
            "shapely",
            "appdirs",
            "bs4"
        ],
        "requires_python": "",
        "summary": "Search and download ERS-1, ERS-2, and Envisat products.",
        "version": "0.6"
    },
    "last_serial": 4497927,
    "releases": {
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "610b972cb0e7680416f1c29219283901",
                    "sha256": "3129baa2fc37396c60ca9e6c3683a6682e27847211ef8487ca4cc00c03479339"
                },
                "downloads": -1,
                "filename": "asarapi-0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "610b972cb0e7680416f1c29219283901",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15435,
                "upload_time": "2018-08-22T18:32:07",
                "url": "https://files.pythonhosted.org/packages/a7/ab/0cb6af762d307f95197554b8e823f41880edbeeef02f96cfd68c7ffa6a2e/asarapi-0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "d164df1dea68df090a86f0bb624062ba",
                    "sha256": "8a07063d8d60a006e859f6597bd454dfe0bcab9d3cb3db93eb79c50b04ac025e"
                },
                "downloads": -1,
                "filename": "asarapi-0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "d164df1dea68df090a86f0bb624062ba",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15753,
                "upload_time": "2018-08-22T18:32:09",
                "url": "https://files.pythonhosted.org/packages/11/30/d1e77ed3bed437fbefad77c4431ad76c7e6ca5d6913f703be05fe5f2a8e5/asarapi-0.1.tar.gz"
            }
        ],
        "0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "33cad32f7e9ef210271ebe17e9484d01",
                    "sha256": "025e11f772f2a578e5877b2f8be8da617d3c3639d3ec522b80189bdaaac188d2"
                },
                "downloads": -1,
                "filename": "asarapi-0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "33cad32f7e9ef210271ebe17e9484d01",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15484,
                "upload_time": "2018-10-01T14:46:00",
                "url": "https://files.pythonhosted.org/packages/ad/1b/630781949b446104e36176b640f7a792a7abfe1ed682289c36039c5abab3/asarapi-0.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "3ec5bb813a9467c4fbcadb6b0214d811",
                    "sha256": "3c19a29171edb432b0cafa448746905ab91673b507c8ea339e36353b389b06cf"
                },
                "downloads": -1,
                "filename": "asarapi-0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "3ec5bb813a9467c4fbcadb6b0214d811",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15832,
                "upload_time": "2018-10-01T14:46:01",
                "url": "https://files.pythonhosted.org/packages/bd/0b/f2a180545fe51f06af4810c3c7dd630accc83daee03fc75e1b8531ab81f0/asarapi-0.2.tar.gz"
            }
        ],
        "0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ab2a89b7df63a6e6fada634b0eaf7018",
                    "sha256": "8eae24eb7a51fef4a9c00422d380576f6640a22ae3410a31f272d55a19f44166"
                },
                "downloads": -1,
                "filename": "asarapi-0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ab2a89b7df63a6e6fada634b0eaf7018",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15554,
                "upload_time": "2018-10-25T11:12:11",
                "url": "https://files.pythonhosted.org/packages/1b/2b/16a94c6ad10f7a8e4cd2656648562d29ebec4053e27e06ace20980e8c029/asarapi-0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "3cb26a08238afa691f3eb60a28f7d33a",
                    "sha256": "ea4b260a4d3d2bd95111d5005fb904a26714a05a882ab186a4c1da1b4da254fd"
                },
                "downloads": -1,
                "filename": "asarapi-0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "3cb26a08238afa691f3eb60a28f7d33a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15902,
                "upload_time": "2018-10-25T11:12:13",
                "url": "https://files.pythonhosted.org/packages/65/26/268ae861e9a7a455f16e0128403f5116859961e8aacd6aa512a2a08f407d/asarapi-0.3.tar.gz"
            }
        ],
        "0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ccf935a65d3877d12800e6b0fe9dce16",
                    "sha256": "893cbb647b8abf2c2a1a1f78d4b8e53d64da3024d1235b5690395f23d2a8bd8d"
                },
                "downloads": -1,
                "filename": "asarapi-0.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ccf935a65d3877d12800e6b0fe9dce16",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15565,
                "upload_time": "2018-10-28T15:17:19",
                "url": "https://files.pythonhosted.org/packages/50/76/c34af93933c50447cdfd12782c64946681d04a5974bbda65c52f1d904597/asarapi-0.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "49a72e8cf75f4ab53cda7062246ae033",
                    "sha256": "e06e10093df09f75cf778dd9cecc1f089eeb0ad7b3cc1b2fa235f7592a2aa17d"
                },
                "downloads": -1,
                "filename": "asarapi-0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "49a72e8cf75f4ab53cda7062246ae033",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15927,
                "upload_time": "2018-10-28T15:17:21",
                "url": "https://files.pythonhosted.org/packages/64/11/c9b3b7a41386343b117d7e747c293f5b6744be76d8c617f49163b545f42a/asarapi-0.4.tar.gz"
            }
        ],
        "0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "067c23c7157083dd46727f0b81089330",
                    "sha256": "7e12db8a4bcc335cc444c2fcdad3b04a42f1c376a55c6a2e0f19ebe68279e6c9"
                },
                "downloads": -1,
                "filename": "asarapi-0.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "067c23c7157083dd46727f0b81089330",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15607,
                "upload_time": "2018-10-29T12:40:37",
                "url": "https://files.pythonhosted.org/packages/c8/67/3cf0650ef926f4cb79da785866ca8b1c1e016b9c89e68266f7a851997691/asarapi-0.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "b48982510acd13365ab33c125dd0d5b4",
                    "sha256": "986a9eab4847c1f9f2a3aed9e0600ec4558f78a7508f7dd0f366280743995cd6"
                },
                "downloads": -1,
                "filename": "asarapi-0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "b48982510acd13365ab33c125dd0d5b4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15977,
                "upload_time": "2018-10-29T12:40:38",
                "url": "https://files.pythonhosted.org/packages/5b/c1/8fbf8782338f2cac7ab6325a5325e5e23dff2d6a404c696d7d1919680bba/asarapi-0.5.tar.gz"
            }
        ],
        "0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b5172e391b212f6f6cba8edf852eacbd",
                    "sha256": "52a38267e4eecace16b7b74d031c0ecbe249de8fd6dfe67289d6867b80e0641f"
                },
                "downloads": -1,
                "filename": "asarapi-0.6-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b5172e391b212f6f6cba8edf852eacbd",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 15596,
                "upload_time": "2018-11-17T19:26:36",
                "url": "https://files.pythonhosted.org/packages/93/cd/0310de7d54f5180f5f1c89cbe78a63d6b681bf332564e96b4ff0b18b6fd7/asarapi-0.6-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "c28c724da4831197e28495a2544f0843",
                    "sha256": "ad3190cbed949dfec4df0f2974789a071ad2dd1b5c5e6b6d349d4c3b8a120a00"
                },
                "downloads": -1,
                "filename": "asarapi-0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "c28c724da4831197e28495a2544f0843",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15958,
                "upload_time": "2018-11-17T19:26:38",
                "url": "https://files.pythonhosted.org/packages/a4/54/064a216afc556fabcedd1573b99c68540a0bf67f5084612330597b49bfbd/asarapi-0.6.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "b5172e391b212f6f6cba8edf852eacbd",
                "sha256": "52a38267e4eecace16b7b74d031c0ecbe249de8fd6dfe67289d6867b80e0641f"
            },
            "downloads": -1,
            "filename": "asarapi-0.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b5172e391b212f6f6cba8edf852eacbd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 15596,
            "upload_time": "2018-11-17T19:26:36",
            "url": "https://files.pythonhosted.org/packages/93/cd/0310de7d54f5180f5f1c89cbe78a63d6b681bf332564e96b4ff0b18b6fd7/asarapi-0.6-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "c28c724da4831197e28495a2544f0843",
                "sha256": "ad3190cbed949dfec4df0f2974789a071ad2dd1b5c5e6b6d349d4c3b8a120a00"
            },
            "downloads": -1,
            "filename": "asarapi-0.6.tar.gz",
            "has_sig": false,
            "md5_digest": "c28c724da4831197e28495a2544f0843",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 15958,
            "upload_time": "2018-11-17T19:26:38",
            "url": "https://files.pythonhosted.org/packages/a4/54/064a216afc556fabcedd1573b99c68540a0bf67f5084612330597b49bfbd/asarapi-0.6.tar.gz"
        }
    ]
}