Glossary

Choose data offerings from the glossary using the SDK.


Overview

The glossary provides information on UP42 data offerings. It helps you create orders.

Collections serve as the higher-level category, containing one or more data products related to the actual configuration of data available for ordering.

View repository

Class: CollectionType

An enumeration class that defines types of geospatial collections.

Examples

Python

    glossary = up42.glossary.ProductGlossary

tasking_collections = glossary.get_collections(
    collection_type = up42.glossary.CollectionType.TASKING,
    sort_by = up42.glossary.CollectionSorting.name.asc,
)

for collection in tasking_collections:
    print(f"{collection.name}")

  

Constants
ConstantDescriptionValue
ARCHIVEstr
A catalog collection.
ARCHIVE
TASKINGstr
A tasking collection.
TASKING

Class: ResolutionValue

A data class that represents the resolution of data within a collection.

Attributes
AttributeDescription
minimumfloat
The best possible resolution available for the collection, in meters.
descriptionOptional[str]
A description of the resolution.
maximumOptional[float]
The least detailed resolution available for the collection, in meters. The parameter is omitted if the collection has only one resolution value, specified in minimum.

Class: CollectionMetadata

A data class that contains metadata related to a collection.

Attributes
AttributeDescription
product_typeOptional[Literal[“OPTICAL”, “SAR”, “ELEVATION”]]
The type of product the collection delivers.
resolution_classOptional[Literal[“VERY_HIGH”, “HIGH”, “MEDIUM”, “LOW”]]
The spatial resolution class.
resolution_valueOptional[ResolutionValue]
The level of detail achievable for the collection.

Class: Provider

A data class that represents a provider in the system.

Attributes
AttributeDescription
namestr
The name of the provider.
titlestr
The title of the provider.
descriptionstr
The description of the provider.
roleslist[Literal[“PRODUCER”, “HOST”]]
Provider roles:
  • PRODUCER: A provider that initially acquired and processed the source data. Data acquired by a producer can be distributed to various hosts.
  • HOST: A provider that offers access to data acquired by a producer.

Class: DataProduct

A data class that represents a data product in the system.

Attributes
AttributeDescription
namestr
The data product name.
titlestr
The title of the data product.
descriptionstr
The description of the data product.
idOptional[str]
The data product ID.
eula_idOptional[str]
The EULA ID.

Class: Collection

A data class that represents a collection in the system.

Attributes
AttributeDescription
namestr
The name of the collection.
titlestr
The title of the collection.
descriptionstr
The description of the collection.
typeCollectionType
The type of the collection.
integrationslist[IntegrationValue]
Integration values.
providerslist[Provider]
Providers.
data_productslist[DataProduct]
Data products.
metadataOptional[CollectionMetadata]
The collection metadata.

Class: CollectionSorting

A class that contains predefined sorting fields.

Examples

Python

    glossary = up42.glossary.ProductGlossary

tasking_collections = glossary.get_collections(
    collection_type = up42.glossary.CollectionType.TASKING,
    sort_by = up42.glossary.CollectionSorting.name.asc,
)

for collection in tasking_collections:
    print(f"{collection.name}")

  

Attributes
AttributeDescription
nameutils.SortingField
Sorts by collection name. The default order is ascending.
titleutils.SortingField
Sorts by collection title. The default order is ascending.
descriptionutils.SortingField
Sorts by collection description. The default order is ascending.
typeutils.SortingField
Sorts by collection type. The default order is ascending.

Class: ProductGlossary

A data class that represents product glossary in the system.

Examples

Python

    glossary = up42.glossary.ProductGlossary

tasking_collections = glossary.get_collections(
    collection_type = up42.glossary.CollectionType.TASKING,
    sort_by = up42.glossary.CollectionSorting.name.asc,
)

catalog_collections = glossary.get_collections(
    collection_type = up42.glossary.CollectionType.ARCHIVE,
    sort_by = up42.glossary.CollectionSorting.name.asc,
)

print(f"Tasking collections")
for collection in tasking_collections:
    print(f"    {collection.title}: {collection.name}")
    print(f"    {collection.description}")
    print(f"")

print(f"Catalog collections")
for collection in catalog_collections:
    print(f"    {collection.title}: {collection.name}")
    print(f"    {collection.description}")
    print(f"")

  

Functions

get_collections

Retrieves a list of geospatial collections. Returns Iterator[Collection].

ParameterDescription
collection_typeOptional[CollectionType]
The type of the collection.
sort_byOptional[utils.SortingField]
The results sorting method that arranges elements in ascending or descending order based on a chosen field.

Learn more