{"id":25434378,"url":"https://github.com/cs-si/eodag-labextension","last_synced_at":"2025-11-01T00:30:32.835Z","repository":{"id":42192585,"uuid":"408378208","full_name":"CS-SI/eodag-labextension","owner":"CS-SI","description":"Jupyterlab extension for EODAG search","archived":false,"fork":false,"pushed_at":"2024-04-10T21:31:54.000Z","size":6301,"stargazers_count":16,"open_issues_count":7,"forks_count":2,"subscribers_count":8,"default_branch":"develop","last_synced_at":"2024-04-13T03:36:14.951Z","etag":null,"topics":["earth-observation","eodag","geographic-data","gis","jupyter","jupyterlab","labextension","notebook","remote-sensing","satellite-imagery"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CS-SI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-09-20T09:12:59.000Z","updated_at":"2024-04-25T16:50:33.895Z","dependencies_parsed_at":"2023-09-24T10:14:16.141Z","dependency_job_id":"73010889-c5f3-4bd1-b87a-93337b430ff6","html_url":"https://github.com/CS-SI/eodag-labextension","commit_stats":{"total_commits":226,"total_committers":14,"mean_commits":"16.142857142857142","dds":0.5530973451327434,"last_synced_commit":"a37cb9d8d3747f25a56099261e7e5c78d24ae072"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag-labextension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag-labextension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag-labextension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag-labextension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CS-SI","download_url":"https://codeload.github.com/CS-SI/eodag-labextension/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239242106,"owners_count":19605954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["earth-observation","eodag","geographic-data","gis","jupyter","jupyterlab","labextension","notebook","remote-sensing","satellite-imagery"],"created_at":"2025-02-17T06:16:31.721Z","updated_at":"2025-11-01T00:30:32.807Z","avatar_url":"https://github.com/CS-SI.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eodag-labextension\n\n[![JupyterLab v3](https://badge.fury.io/py/eodag-labextension.svg)](https://badge.fury.io/py/eodag-labextension)\n[![JupyterLab v3](https://img.shields.io/badge/jupyterlab-3.x-orange?logo=jupyter)](https://jupyter.org/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/git/https%3A%2F%2Fgithub.com%2FCS-SI%2Feodag-labextension.git/master?urlpath=lab%2Ftree%2Fnotebooks%2Fbasic_usage.ipynb)\n\nSearching and browsing remote sensed imagery directly from JupyterLab.\n\n![screencast](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_screencast.gif)\n\nThis extension is using the [eodag](https://github.com/CS-SI/eodag) library to efficiently search from various image\nproviders. It can transform search results to code cells into the active Python notebook to further process/visualize\nthe dataset.\n\nThe extension is composed of a Python package named `eodag-labextension`, and add a tab into the left panel of Jupyter\nLab. The package consist of a Python Jupyter notebook REST service consumed by the client and served at `/eodag/` or\n`/user/\u003cusername\u003e/eodag/` for JupyterHub (a home page is available at that URL).\n\n- [Requirements](#requirements)\n- [Compatibility](#compatibility)\n- [Install](#install)\n  - [Configuration](#configuration)\n- [QuickStart](#quickstart)\n  - [Search](#search)\n  - [Settings](#settings)\n  - [Results overview](#results-overview)\n  - [Apply to the Jupyter notebook](#apply-to-the-jupyter-notebook)\n  - [User manual](#user-manual)\n- [Contribute](#contribute)\n- [Troubleshooting](#troubleshooting)\n- [License](#license)\n\n## Requirements\n\n- pip \u003e= 21.0\n\n## Compatibility\n\n- newest `eodag-labextension` versions are compatibles with JupyterLab v3\n- v3.1.3 is the latest version compatible with JupyterLab v2\n- v2.1.3 is the latest version compatible with JupyterLab v1\n\n## Install\n\n```bash\npip install eodag-labextension\n```\n\nYou can also uninstall it quite simply.\n\n```bash\npip uninstall eodag-labextension\n```\n\n### Configuration\n\neodag configuration file should be localized at `~/.config/eodag/eodag.yaml` (see\n[eodag documentation](https://eodag.readthedocs.io/en/latest/getting_started_guide/configure.html)).\nMake sure that that file is configured properly.\n\n## QuickStart\n\nYou can use `eodag-labextension` inside a Jupyter notebook. Start Jupyter lab with `jupyter lab`, and in Jupyter lab\nopen a notebook.\n\n## Search\n\n![extension logo](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_icon.png)\nClick on this icon in the left of JupyterLab interface to open EODAG-Labextension tab.\n\n![form](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_form.png)\n\nWith displayed search form, you can enter search extent and following search criteria:\n\n- **Provider**: the provider on which to perform the search. If no provider is selected, search will loop on providers\n  by [priority](https://eodag.readthedocs.io/en/stable/getting_started_guide/configure.html#priority-setting), and\n  return the first non empty results.\n- **Product type**: the searched product type. List filtering is performed using product types description keywords.\n  For each entry of the drop-down list, a tooltip is displayed at hovering time with corresponding title.\n  ![product types](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_product_types.png)\n\n- **Date range**: minimal and maximal dates of the search temporal window.\n- **Max cloud cover**: maximum cloud cover allowed in search results in percent. 100% will disable cloud cover\n  filtering.\n- **Additional parameters**: used to enter key-value pairs criteria for the request. See\n  [available parameters in EODAG documentation](https://eodag.readthedocs.io/en/stable/add_provider.html#opensearch-parameters-csv).\n\nAs **search geometry** you can draw multiple extents, or use none. Each extent can be a rectangle or a free polygon.\n\n_Product type is mandatory. Other criteria are optional._\n\nOnce search criteria are filled out, click on:\n\n- `Generate Code` to automatically generate and insert the corresponding eodag search code bellow the active cell.\n- `Preview Results` to perform a search in background, display results, and generate search code in a second step.\n\n## Settings\n\n![reload logo](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_reload_icon.png)\nClick on this icon to reload [EODAG configuration](https://eodag.readthedocs.io/en/stable/getting_started_guide/configure.html)\nand take into account your updated credentials or providers settings.\n\n![settings logo](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_settings_icon.png)\nClick on this icon to open EODAG-Labextension settings. You will be enable to:\n\n- choose whether newly inserted code should replace existing search code or not;\n- configure the default map settings.\n\n![settings tab](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_settings_map.png)\n\n### Results overview\n\n![extension popup](https://raw.githubusercontent.com/CS-SI/eodag-labextension/develop/notebooks/images/eodag_labext_popup.png)\n\nThe results overview popup is compopsed of 3 parts:\n\n- a map showing products extent,\n- a table listing products,\n- a pane containing metadata for currently selected product.\n\nThe results table allows you to access product metadata by clicking on the desired product line. The magnifying glass\nbutton allows you to zoom in on the product's in the map view. By scrolling down in the list of results, the search is\nautomatically restarted to retrieve the following results.\n\nIn the metadata view, clicking on the _Quicklook_ displays it in native resolution. Clicking it again reduces its size\nagain.\n\n### Apply to the Jupyter notebook\n\nIf the search result is correct, clicking on the \"`Generate code`\" button will insert the Python eodag code in a new cell\nafter the selected cell of the currently open notebook. The popup is automatically closed. From there, it is possible\nto work in the notebook on the search results by executing the eodag search.\n\nHere is an example of generated code:\n\n```python\nfrom eodag import EODataAccessGateway, setup_logging\n\nsetup_logging(1) # 0: nothing, 1: only progress bars, 2: INFO, 3: DEBUG\n\ndag = EODataAccessGateway()\ngeometry = \"POLYGON ((0.550136 43.005451, 0.550136 44.151469, 2.572104 44.151469, 2.572104 43.005451, 0.550136 43.005451))\"\nsearch_results = dag.search(\n  productType=\"S2_MSI_L1C\",\n  geom=geometry,\n  start=\"2021-08-01\",\n  end=\"2021-08-11\",\n  cloudCover=17,\n)\n```\n\n### User manual\n\nPlease refer to the\n[user manual notebook](https://github.com/CS-SI/eodag-labextension/blob/develop/notebooks/user_manual.ipynb)\nfor results usage examples.\n\n## Contribute\n\nHave you observed a bug while running `eodag-labextension`?\nDo you have a suggestion for a new feature?\n\nDon't hesitate and open an issue or submit a pull request, contributions are most welcome!\n\nFor guidance on setting up a development environment and how to make a\ncontribution to `eodag-labextension`, see the\n[contributing guidelines](https://github.com/CS-SI/eodag-labextension/blob/develop/CONTRIBUTING.md).\n\n## Troubleshooting\n\nIf you are seeing the frontend extension, but it is not working, check\nthat the server extension is enabled:\n\n```bash\njupyter server extension list\n```\n\nIf the server extension is installed and enabled, but you are not seeing\nthe frontend extension, check the frontend extension is installed:\n\n```bash\njupyter labextension list\n```\n\nTo submit an issue, please go to [github issues](https://github.com/CS-SI/eodag-labextension/issues).\n\n## License\n\nThis software is licensed under Apache License v2.0.\nSee LICENSE file for details.\n\n_Copyright 2022 CS GROUP - France\nAll rights reserved_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcs-si%2Feodag-labextension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcs-si%2Feodag-labextension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcs-si%2Feodag-labextension/lists"}