Release notes

pip show up42-py

conda search up42-py

pip install up42-py --upgrade

conda update -c conda-forge up42-py

1. Log in into your GitHub account.
2. Open the repository.
3. Click  Watch → Custom.
4. Select the events you want to subscribe to. To get notifications about releases, select Releases.
5. Click Apply.

• Updated the endpoint for the get_credits_balance function, migrated from v1 to v2.
• Removed the limit parameter from the Catalog’s construct_search_parameters functionality, as it’s not intended for user implementation.
• Removed the DetectionTreesHeightsSpacept processing template class due to the sunsetting of the associated process.

• Supported cost estimation for tasking orders.
• Supported asset retrieval from orders that have the BEING_FULFILLED status.

• Supported a new Glossary module allowing retrieving information about geospatial collections.

• Removed the following functions:

  • up42.initialize_webhook. Instead, use up42.Webhook.get.
  • up42.get_webhooks. Instead, use up42.Webhook.all.
  • up42.get_webhook_events. Instead, use up42.Webhook.get_webhook_events.
  • up42.create_webhook. Instead, use webhook.save.
  • Webhook.update. Instead, use webhook.save.
  • Webhook.create. Instead, use webhook.save.
  • CatalogBase.get_collections. Instead, use up42.ProductGlossary.get_collections.
    • Instead of up42.catalog.get_collections, use up42.ProductGlossary.get_collections(collection_type=up42.CollectionType.ARCHIVE).
    • Instead of up42.tasking.get_collections, use up42.ProductGlossary.get_collections(collection_type=up42.CollectionType.TASKING).
  • CatalogBase.get_data_products. Instead, use up42.ProductGlossary.get_collections, it returns data products alongside collection information.

• Removed the following arguments:

  • In CatalogBase.place_order: scene, geometry.
  • In Catalog.estimate_order: scene, geometry.
  • In Catalog.construct_search_parameters: sortby, ascending.
  • In Storage.get_assets: acquired_after, acquired_before, geometry, custom_filter.
  • In Webhook.all: return_json.

• Removed the following properties:

  • webhook.webhook_id. Instead, use webhook.id.
  • webhook.info. Instead, use the Webhook object itself.

• Removed the following classes:

  • In the Catalog class, removed ProductGlossary classes Producer and Host. Replaced by the Provider class in the Glossary module.

• Removed the following templates:

  • AugmentationSpacept

• Updated versions of Python packages:
  • certifi: updated to version 2024.7.4.
  • setuptools: updated to version 70.0.0.
  • urllib: updated to version 2.2.2.
  • zipp: updated to version 3.19.1.
• Added EULA-related statuses to processing jobs: LICENSED and UNLICENSED.
• Marked CatalogBase.get_data_products as deprecated.

• Supported new Webhook class functions:
  • Webhook.all
  • Webhook.get
  • Webhook.get_webhook_events
  • Webhook.save
• Supported a new Processing module allowing the following:
  • Create templates for jobs
  • Validate jobs
  • Determine the cost of jobs
  • Run jobs
  • Monitor job statuses

• Resolved an issue with pystac.Item.get_assets that caused accessing STAC assets to fail when using deepcopy support in the UP42 authentication layer.
• Updated versions of Python packages:
  • requests: updated to version 2.32.0.
  • tornado: updated to version 6.4.1.
  • geopandas: updated to version 0.14.4.
  • tenacity: updated to version 8.4.1.
• Marked webhook functions and attributes as deprecated:
  • webhook.info
  • webhook.update()
  • up42.initialize_webhook()
  • up42.get_webhook_events()
  • up42.create_webhook()
  • up42.get_webhooks()

• Integrated tenacity as a dependency.
• Implemented resilience mechanisms for asset.stac_info and asset.stac_items.
• Removed PySTAC client subclassing.
• Streamlined fixtures.
• Expanded test coverage.
• Removed unnecessary token exposure.

Implemented thread safety for token retrieval.

• Enhanced HTTP resilience with increased retry attempts and backoff mechanisms.
• Resolved an issue where temporary storage would exceed capacity during catalog downloads.
• Updated the following dependencies: jinja2, tqdm, and geojson.

• Removed project credentials as an authentication method.
• Removed previously deprecated visualization functions:
  • folium_base_map()
  • draw_aoi()
  • map_quicklooks()
  • map_results()
  • plot_coverage()
  • plot_results()
  • plot_quicklooks()
  • plot_coverage()

Updated versions of Python packages:

• black: updated to version 24.3.0.
• pillow: updated to version 10.3.0.

• Removed the upper-bound limitation for Python versions.
• Discontinued support for Python 3.8.

• Fixed unintentional removal of titles and tags during asset metadata updates.
• Removed the unnecessary auth.env property and corresponding tests.
• Expanded the new authentication stack to accommodate account authentication scenarios.
• Added new components within the HTTP layer to facilitate future enhancements in authentication and request handling.
• Aligned the majority of the code with Pylint checks.

Updated the place_order() and estimate_order() functions of the CatalogBase class to the latest version of the API.

• Removed the following edit and create functions:

  • up42

    • validate_manifest()

  • Project

    • max_concurrent_jobs
    • update_project_settings()
    • create_workflow()

  • Workflow

    • max_concurrent_jobs
    • update_name()
    • add_workflow_tasks()
    • get_compatible_blocks()
    • get_parameters_info()
    • construct_parameters()
    • construct_parameters_parallel()
    • estimate_job()
    • test_job()
    • test_jobs_parallel()
    • run_job()
    • run_jobs_parallel()

  • Job

    • track_status()
    • cancel_job()

• Marked the following visualization functions as deprecated:

  • up42

    • viztools.folium_base_map()

  • Catalog

    • plot_coverage()
    • map_quicklooks()
    • plot_quicklooks()

  • Job

    • map_results()
    • plot_results()

  • JobCollection

    • map_results()
    • plot_results()

  • JobTask

    • map_results()
    • plot_results()
    • plot_quicklooks()

Restored the order.get_assets() function.

• Updated the storage.get_orders() function to the latest version of the API.
• Set Poetry as the only dependency manager.
• Removed the order.get_assets() function.

Marked the following parameters of storage.get_assets() as deprecated to enforce the use of the PySTAC client search.

• geometry
• acquired_before
• acquired_after
• custom_filter

• Updated authentication by changing it from project-based to account-based.
• Added a new function to the Asset class: get_stac_asset_url() generates a signed URL that allows to download a STAC asset from storage without authentication.