Check your version
pip show up42-pyconda search up42-pyGet the latest version
pip install up42-py --upgradeconda update -c conda-forge up42-pyOnly the latest version within a major release is supported. Older minor or patch versions aren’t supported once a newer version is available.
- Log in into your GitHub account.
- Open the repository.
- Click
Watch → Custom.
- Select the events you want to subscribe to. To get notifications about releases, select Releases.
- Click Apply.
Processing templates
- Added a new template:
SimularityJobTemplate. It establishes a shared base for Simularity processes, which have source and reference data items. - Added a new template:
DetectionChangeSimularity.
Orders
- Added more attributes to
TaskingOrderDetailsto provide full transparency into the initial order request.
Processing templates
- Updated the
CoregistrationSimularitytemplate to align with the newSimularityJobTemplate.
Glossary
- Updated the
ResolutionValueclass by removing the non-functionaldescriptionfield.
Processing templates
- Marked these change detection processes as deprecated:
DetectionChangeSpacept,DetectionChangePleiadesHyperverge, andDetectionChangeSPOTHyperverge. UseDetectionChangeSimularityinstead.
Processing templates
- Added a new processing job template:
UpsamplingNSSentinel.
Glossary
- Added default property values to the
Providerclass to make the internal handling of provider data more resilient.
Data management
- Added a new
BulkDeletionclass with adeletemethod to enable bulk deletion of STAC items by deleting their parent collections.
Processing templates
- Updated the
UpsamplingNSjob template to align with theSingleItemJobTemplate, which simplifies its required parameters to just input and title.
Glossary
- Improved error handling for catalog searches to return actionable messages from the API, making it faster to debug failed requests.
Base functions
- Marked
up42.get_credits_balanceas deprecated.
Webhooks
- Marked
Webhook.saveas deprecated. - Marked
Webhook.getas deprecated. - Marked
Webhook.trigger_test_eventsas deprecated. - Marked
Webhook.deleteas deprecated. - Marked
Webhook.get_webhook_eventsas deprecated. - Marked
Webhook.allas deprecated.
Tasking
- Added a new
FeasibilityStudyclass that represents a feasibility study for a tasking order. - Added a new
FeasibilityStudy.allmethod that retrieves feasibility studies based on optional filter parameters. - Added a new
FeasibilityStudy.acceptmethod that selects a feasibility study option for acceptance. - Added a new
FeasibilityStudy.savemethod that saves any changes to the decision status of the feasibility study option and updates the properties. - Added a new
FeasibilityStudySortingclass that provides sorting options for feasibility studies. - Added a new
FeasibilityStudyDecisionOptionclass that represents the option of the feasibility study that was accepted for a given order.
Additional functionality
- Added functionality that checks if the latest version of the UP42 Python SDK is used when the package is imported.
Glossary
- Updated the
Sceneclass to include theprovider_propertiesfield.
Orders
- Marked
Order.get_assetsas deprecated.
STAC
- Updated
Up42ExtensionPropertybehavior related to order IDs.
Security
- Updated
requestsdependency to version 2.32.4. - Updated
tornadodependency to version 6.5.1.
Assets
- Marked
Asset.allas deprecated. - Marked
Asset.getas deprecated. - Marked
Asset.stac_itemsas deprecated, usepystac.Client.search. - Marked
Asset.stac_infoas deprecated, usepystac.Client.get_item. - Marked
Asset.fileas deprecated, usepystac.Asset.file.
Processing templates
- Added a new processing job template:
CoregistrationSimularity.
Assets
- Marked
Asset.asset_idas deprecated, useAsset.id. - Marked
Asset.update_metadataas deprecated, usepystac.Item.update. - Marked
Asset.get_stac_asset_urlas deprecated, usepystac.Asset.file.url. - Marked
Asset.download_stac_assetas deprecated, usepystac.Asset.file.download. - Marked
Asset.downloadas deprecated, useAsset.file.download.
Catalog
- Marked
Catalog.construct_order_parametersas deprecated, useBatchOrderTemplate. - Marked
Catalog.construct_search_parametersas deprecated, useProvider.search. - Marked
Catalog.searchas deprecated, useProvider.search. - Marked
Catalog.download_quicklooksas deprecated, useScene.quicklook.download.
Catalog base
- Marked
CatalogBase.get_data_product_schemaas deprecated, useDataProduct.schema. - Marked
CatalogBase.estimate_orderas deprecated, useBatchOrderTemplate.estimate. - Marked
CatalogBase.place_orderas deprecated, useBatchOrderTemplate.place.
Orders
- Marked
Order.order_idas deprecated, useOrder.id. - Marked
Order.infoas deprecated, useOrderattributes. - Marked
Order.order_detailsas deprecated, useOrder.details. - Marked
Order.track_statusas deprecated, useOrder.track. - Marked
Order.estimateas deprecated, useBatchOrderTemplate.estimate. - Marked
Order.placeas deprecated, useBatchOrderTemplate.place.
Storage
- Marked
Storage.get_ordersas deprecated, useOrder.all. - Marked
Storage.get_assetsas deprecated, useAsset.all.
Tasking
- Marked
Tasking.construct_order_parametersas deprecated, useBatchOrderTemplate. - Marked
Tasking.get_quotationsas deprecated, useQuotation.all. - Marked
Tasking.decide_quotationas deprecated, useQuotation.accept/Quotation.rejectandQuotation.save. - Marked
Tasking.get_feasibilityas deprecated. - Marked
Tasking.choose_feasibilityas deprecated.
up42 namespace
- Marked
up42.initialize_orderas deprecated, useOrder.get. - Marked
up42.initialize_catalogas deprecated. - Marked
up42.initialize_assetas deprecated, useAsset.get. - Marked
up42.initialize_taskingas deprecated. - Marked
up42.initialize_storageas deprecated.
Assets
- Added a new
Asset.getmethod that retrieves an asset by ID. - Added a new
Asset.allmethod that filters and iterates assets.
Orders
- Added a new
Order.allmethod that filters and iterates orders. - Added a new
Order.getmethod that retrieves retrieves a specific order by its ID. - Added a new order template module (with
BatchOrderTemplateand other supporting classes) that unifies data and processing ordering.
Glossary
- Added a new
DataProduct.schemaproperty that returns a JSON representation of the schema for a specific data product. - Added a new
Provider.searchmethod that filters and iterates scenes of hosting providers usingScenedata classes.
Tasking
- Added a new
Quotationclass that represents a quotation for a tasking order. - Added a new
QuotationSortingclass that provides sorting options for quotations.
STAC
- Added a new
pystac.Asset.file.urlproperty that provides a signed URL to access the asset without authentication. - Added a new
pystac.Asset.file.downloadmethod that downloads an asset file. - Added a new
up42property topystac.Itemandpystac.Collection, this property is a namespace containing all data from UP42 extensions. All properties within this namespace are read-write. - Added a new
updatemethod topystac.Item, which savesup42.titleandup42.tagsvalues to the service, then updates the item properties based on the response.
Assets
- Updated
Assetand made it a data class.
Orders
- Updated
Orderand made it a data class.
2.1.1
December 12, 2024- Updated the endpoint for the
get_credits_balancefunction, migrated from v1 to v2. - Removed the
limitparameter from theCatalog’sconstruct_search_parametersfunctionality, as it’s not intended for user implementation. - Removed the
DetectionTreesHeightsSpaceptprocessing 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_FULFILLEDstatus.
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, useup42.Webhook.get.up42.get_webhooks. Instead, useup42.Webhook.all.up42.get_webhook_events. Instead, useup42.Webhook.get_webhook_events.up42.create_webhook. Instead, usewebhook.save.Webhook.update. Instead, usewebhook.save.Webhook.create. Instead, usewebhook.save.CatalogBase.get_collections. Instead, useup42.ProductGlossary.get_collections.- Instead of
up42.catalog.get_collections, useup42.ProductGlossary.get_collections(collection_type=up42.CollectionType.ARCHIVE). - Instead of
up42.tasking.get_collections, useup42.ProductGlossary.get_collections(collection_type=up42.CollectionType.TASKING).
- Instead of
CatalogBase.get_data_products. Instead, useup42.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.
- In
-
Removed the following properties:
webhook.webhook_id. Instead, usewebhook.id.webhook.info. Instead, use the Webhook object itself.
-
Removed the following classes:
- In the
Catalogclass, removedProductGlossaryclassesProducerandHost. Replaced by the Provider class in the Glossary module.
- In the
-
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:
LICENSEDandUNLICENSED. - Marked
CatalogBase.get_data_productsas deprecated.
1.1.0
June 25, 2024- Supported new Webhook class functions:
Webhook.allWebhook.getWebhook.get_webhook_eventsWebhook.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_assetsthat 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.infowebhook.update()up42.initialize_webhook()up42.get_webhook_events()up42.create_webhook()up42.get_webhooks()
1.0.3
May 23, 2024- Integrated
tenacityas a dependency. - Implemented resilience mechanisms for
asset.stac_infoandasset.stac_items. - Removed PySTAC client subclassing.
- Streamlined fixtures.
- Expanded test coverage.
- Removed unnecessary token exposure.
1.0.2
May 15, 2024Implemented 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, andgeojson.
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, 2024Updated 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.envproperty 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, 2024Updated 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_jobsupdate_project_settings()create_workflow()
-
Workflow
max_concurrent_jobsupdate_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, 2023Restored 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, 2023Marked the following parameters of storage.get_assets() as deprecated to enforce the use of the PySTAC client search.
geometryacquired_beforeacquired_aftercustom_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.