Home /Python SDK

Release notes

Stay updated on the release of new versions of the SDK.

Version verification


Check your version

Update your installation

Release tracking in GitHub

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

Version history

2.1.1

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.

2.1.0

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

2.0.1

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

1.1.1

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.

1.1.0

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

1.0.4

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

1.0.3

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.

1.0.2

May 15, 2024

Implemented thread safety for token retrieval.

1.0.1

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.

1.0.0

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

0.37.2

April 8, 2024

Updated versions of Python packages:

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

0.37.1

April 5, 2024
  • Removed the upper-bound limitation for Python versions.
  • Discontinued support for Python 3.8.

0.37.0

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.

0.36.0

February 20, 2024

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

0.35.0

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

0.34.1

December 15, 2023

Restored the order.get_assets() function.

0.34.0

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.

0.33.1

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

0.33.0

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.