Skip to main content

Python SDK for UP42

Project description

Python SDK for UP42, the geospatial marketplace and developer platform.

Documentation   •   UP42.com   •   Support

Highlights

  • Python package for easy access to UP42's geospatial datasets & processing workflows
  • Use UP42 functionality together with your preffered Python libraries!
  • For geospatial analysis & product builders!
  • Interactive maps & visualization, ideal with Jupyter notebooks

Installation & Documentation

See the documentation for getting started guides, examples and the code reference.

The package requires Python > 3.6.

pip install up42-py

30-second Example

The UP42 Python package uses nine classes, representing the hierarchical structure of UP42: Project > Workflow > Job > JobTask | JobCollection | Catalog > Order | Storage > Asset.

In this example a new workflow consisting of Sentinel-2 data and Land-Surface-Temperature is created. The area of interest and workflow parameters are defined. After running the job, the results are downloaded and visualized.

Try this example without installation! Binder

import up42
up42.authenticate(project_id="12345", project_api_key="67890")
project = up42.initialize_project()

# Construct workflow
workflow = project.create_workflow(name="30-seconds-workflow", use_existing=True)
#print(up42.get_blocks(basic=True))
input_tasks = ["Sentinel-2 L2A Visual (GeoTIFF)",
               "Sharpening Filter"]
workflow.add_workflow_tasks(input_tasks)

# Define the aoi and input parameters of the workflow to run it.
aoi = up42.get_example_aoi(as_dataframe=True)
# Or use up42.draw_aoi(), up42.read_vector_file(), FeatureCollection, GeoDataFrame etc.
input_parameters = workflow.construct_parameters(geometry=aoi, 
                                                 geometry_operation="bbox", 
                                                 start_date="2018-01-01",
                                                 end_date="2020-12-31",
                                                 limit=1)
input_parameters["esa-s2-l2a-gtiff:1"].update({"max_cloud_cover":5})

# Price estimation
workflow.estimate_job(input_parameters)

# Run a test job to query data availability and check the configuration.
test_job = workflow.test_job(input_parameters, track_status=True)

# Run the actual job.
job = workflow.run_job(input_parameters, track_status=True)

job.download_results()
job.plot_results(figsize=(6,6))

Support

For any kind of issues or suggestions please see the documentation, open a github issue or contact us via Email support@up42.com

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

up42-py-0.18.1.tar.gz (41.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

up42_py-0.18.1-py3-none-any.whl (50.4 kB view details)

Uploaded Python 3

File details

Details for the file up42-py-0.18.1.tar.gz.

File metadata

  • Download URL: up42-py-0.18.1.tar.gz
  • Upload date:
  • Size: 41.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.12

File hashes

Hashes for up42-py-0.18.1.tar.gz
Algorithm Hash digest
SHA256 ee586e5018aecb5eef84fc9ccdba1f0fcb71b7c06059a4d205effbc309c69aed
MD5 d2cd2e3103afa1d13bcb8bb5e1294398
BLAKE2b-256 913dddee1442ee0f6b41fccf3aaeb28ce834ada4d07787261ddde543694618dd

See more details on using hashes here.

File details

Details for the file up42_py-0.18.1-py3-none-any.whl.

File metadata

  • Download URL: up42_py-0.18.1-py3-none-any.whl
  • Upload date:
  • Size: 50.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.12

File hashes

Hashes for up42_py-0.18.1-py3-none-any.whl
Algorithm Hash digest
SHA256 667f05400e016b39b7039c556c6c027d04b1f3b48038728ed01e4b4d69278e4f
MD5 a9d986369abc778fdc1974746df2aa6b
BLAKE2b-256 bc76b8ce3630370994a3d65c57914ba569a0b3c36a146fd5389aa5e6d996f2a3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page