Release notes

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.

May 13, 2025

Deprecated Added Updated

• Assets

  1. Asset.asset_id is deprecated, use Asset.id.
  2. Asset.update_metadata is deprecated, use pystac.Item.update.
  3. Asset.get_stac_asset_url is deprecated, use pystac.Asset.file.url.
  4. Asset.download_stac_asset is deprecated, use pystac.Asset.file.download.
  5. Asset.download is deprecated, use Asset.file.download.

• Catalog

  1. Catalog.construct_order_parameters is deprecated, use BatchOrderTemplate.
  2. Catalog.construct_search_parameters is deprecated, use Provider.search.
  3. Catalog.search is deprecated, use Provider.search.
  4. Catalog.download_quicklooks is deprecated, use Scene.quicklook.download.

• Catalog base

  1. CatalogBase.get_data_product_schema is deprecated, use DataProduct.schema.
  2. CatalogBase.estimate_order is deprecated, use BatchOrderTemplate.estimate.
  3. CatalogBase.place_order is deprecated, use BatchOrderTemplate.place.

• Orders

  1. Order.order_id is deprecated, use Order.id.
  2. Order.info is deprecated, use Order attributes.
  3. Order.order_details is deprecated, use Order.details.
  4. Order.track_status is deprecated, use Order.track.
  5. Order.estimate is deprecated, use BatchOrderTemplate.estimate.
  6. Order.place is deprecated, use BatchOrderTemplate.place.

• Storage

  1. Storage.get_orders is deprecated, use Order.all.
  2. Storage.get_assets is deprecated, use Asset.all.

• Tasking

  1. Tasking.construct_order_parameters is deprecated, use BatchOrderTemplate.
  2. Tasking.get_quotations is deprecated, use Quotation.all.
  3. Tasking.decide_quotation is deprecated, use Quotation.accept/Quotation.reject and Quotation.save.
  4. Tasking.get_feasibility is deprecated.
  5. Tasking.choose_feasibility is deprecated.

• up42 namespace

  1. up42.initialize_order is deprecated, use Order.get.
  2. up42.initialize_catalog is deprecated.
  3. up42.initialize_asset is deprecated, use Asset.get.
  4. up42.initialize_tasking is deprecated.

• Assets

  1. Asset.get retrieves an asset by ID.
  2. Asset.all filters and iterates assets.
  3. Asset.file.url provides signed URL to access the asset without authentication.
  4. Asset.file.download allows to download the asset file.

• Orders

  1. Order.all filters and iterates orders.
  2. Order.get retrieves retrieves a specific order by its ID.
  3. Order template module (with BatchOrderTemplate and other supporting classes) unifies data and processing ordering.

• Glossary

  1. DataProduct.schema fetches and returns a JSON representation of the schema for a specific data product.
  2. Provider.search filters and iterates scenes of hosting providers using Scene data classes.

• Tasking

  1. A new Quotation class in the Tasking module represents a quotation for a tasking order.
  2. A new QuotationSorting class provides sorting options for quotations.

• PySTAC extension

  1. pystac.Asset.file.url provides signed URL to access the asset without authentication.
  2. pystac.Asset.file.download allows to download the asset file.
  3. pystac.Item and pystac.Collection gets an up42 property, a namespace containing all data from UP42 extensions. All properties within this namespace are read-write.
  4. pystac.Item gets an update method, which saves up42.title and up42.tags values to SAS, then updates the item properties based on the response.

• Order is now a data class.
• Asset is now a data class.

December 12, 2024

• 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.

October 9, 2024

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

August 19, 2024

• 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

July 31, 2024

• 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.

June 25, 2024

• 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

June 17, 2024

• 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()

May 23, 2024

• 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.

May 15, 2024

Implemented thread safety for token retrieval.

May 13, 2024

• 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.

April 17, 2024

• 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()

April 8, 2024

Updated versions of Python packages:

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

April 5, 2024

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

March 15, 2024

• 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.

February 20, 2024

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

January 25, 2024

• 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()

December 15, 2023

Restored the order.get_assets() function.

December 13, 2023

• 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.

November 23, 2023

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

November 14, 2023

• 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.