Assets in SDK

1
from itertools import islice
2

3
# Sort by name, in ascending alphabetical order (A to Z)
4
assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.name)
16 collapsed lines
5

6
# Sort by title, in ascending alphabetical order (A to Z)
7
# assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.title)
8

9
# Sort by size, in descending order (largest to smallest)
10
# assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.size.desc)
11

12
# Sort by creation date, in descending order (most recent to earliest)
13
# assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.created_at.desc)
14

15
# Sort by source, in ascending alphabetical order (A to Z)
16
# assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.source)
17

18
# Sort by collection name, in ascending alphabetical order (A to Z)
19
# assets_sorted = up42.Asset.all(sort_by=up42.AssetSorting.collection_name)
20

21
# Define output for one of the sorting examples
22
for asset in islice(assets_sorted, 0, 5): # Print first 5 results
23
    print(f"- Asset name: {asset.name}")
24
    print(f"  Creation date: {asset.created_at}")
25
    print(f"  Source: {asset.source}")
26
    print(f"  Collection name: {asset.collection_name}\n")

1
# Select an asset
2
asset_id = "d290f1ee-6c54-4b01-90e6-d701748f0851"
3

4
# Fetch asset info
5
asset = up42.Asset.get(asset_id)
6

7
# Define output
8
print(f"Asset details for ID: {order.id}")
9
print(f"Asset filename:       {asset.name}")
10
print(f"User title:           {asset.title}")
11
print(f"Collection name:      {asset.collection_name}")
12
print(f"Size:                 {asset.size}")
13
print(f"Filetype:             {asset.content_type}")
14
print(f"Order ID:             {asset.order_id}")
15
print(f"Asset tags:           {', '.join(asset.tags) if asset.tags else 'No tags'}")

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Fetch asset info
5
asset = up42.Asset.get(asset_id=asset_id)
6
asset.asset_id

1
import pandas as pd
2

3
# Select an asset
4
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
5

6
# Retrieve the ItemCollection object and extract the properties
7
stac_items = up42.Asset.get(asset_id).stac_items
8
item_properties = [item.properties for item in stac_items]
9

10
# Create and display a DataFrame
11
df = pd.DataFrame(item_properties)
12
df

1
import pandas as pd
2

3
# Select an asset
4
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
5

6
# Retrieve STAC info and convert it to a dictionary
7
stac_info_dict = up42.Asset.get(asset_id).stac_info.to_dict()
8

9
# Create and display a DataFrame
10
df = pd.json_normalize(stac_info_dict)
11
df

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Retrieve asset file
5
file = up42.Asset.get(asset_id).file
6

7
# Define output
8
print(f"URL:  {file.url}")
9
print(f"Name: {file.file_name}")

1
# Select an asset
2
asset_id = "d290f1ee-6c54-4b01-90e6-d701748f0851"
3

4
# Fetch asset info
5
asset = up42.Asset.get(asset_id)
6

7
# Define output
8
print(f"Asset details for ID: {order.id}")
9
print(f"Asset filename:       {asset.name}")
10
print(f"User title:           {asset.title}")
11
print(f"Collection name:      {asset.collection_name}")
12
print(f"Size:                 {asset.size}")
13
print(f"Filetype:             {asset.content_type}")
14
print(f"Order ID:             {asset.order_id}")
15
print(f"Asset tags:           {', '.join(asset.tags) if asset.tags else 'No tags'}")

1
from itertools import islice
2

3
# Search for assets
4
assets = up42.Asset.all(
5
    collection_names=["phr", "spot"],
6
    sort_by=up42.AssetSorting.created_at.desc,
7
)
8

9
# Define output
10
for asset in islice(assets, 0, 5): # Print first 5 results
11
    print(f"- Asset ID:         {asset.id}")
12
    print(f"  Asset filename:   {asset.name}")
13
    print(f"  User title:       {asset.title}")
14
    print(f"  Collection name:  {asset.collection_name}")
15
    print(f"  Size:             {asset.size}")
16
    print(f"  Filetype:         {asset.content_type}")
17
    print(f"  Order ID:         {asset.order_id}")
18
    print(f"  Asset tags:       {', '.join(asset.tags) if asset.tags else 'No tags'}\n")

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Initialize asset
5
asset = up42.initialize_asset(asset_id)
6

7
# Update asset metadata
8
asset.update_metadata(
9
    title="Sentinel-2 over Western Europe",
10
    tags=["optical", "WEU"],
11
)

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Initialize asset
5
asset = up42.initialize_asset(asset_id)
6

7
# Get STAC asset link
8
stac_asset=asset.stac_items.items[0].assets.get("b01.tiff")
9

10
# Get download URL
11
asset.get_stac_asset_url(stac_asset)

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Initialize asset
5
asset = up42.initialize_asset(asset_id)
6

7
# Download asset
8
asset.download(
9
    output_directory="/Users/max.mustermann/Desktop/",
10
    unpacking=False,
11
)

1
# Select an asset
2
asset_id = "3bf00b63-7188-4b04-aa27-d78e4cd32c01"
3

4
# Initialize asset
5
asset = up42.initialize_asset(asset_id)
6

7
# Get STAC asset link
8
stac_asset=asset.stac_items.items[0].assets.get("b01.tiff")
9

10
# Download STAC asset
11
asset.download_stac_asset(
12
    stac_asset,
13
    output_directory="/Users/max.mustermann/Desktop/",
14
)