The Catalog Service provides access to products, bands, and images available from Descartes Labs.

Catalog

The Catalog API can be found as Python package descarteslabs.catalog. To install please refer to Installation.

The tables below list the objects, types, and exceptions available through the Catalog API. For information on how these objects work together, check out the Catalog Guide.

Product

`Product`	A raster product that connects band information to imagery.
`DeletionTaskStatus`	The asynchronous deletion task's status

Bands

`Band`	A data band in images of a specific product.
`SpectralBand`	A band that lies somewhere on the visible/NIR/SWIR electro-optical wavelength spectrum.
`MicrowaveBand`	A band that lies in the microwave spectrum, often from SAR or passive radar sensors.
`MaskBand`	A binary band where by convention a 0 means masked and 1 means non-masked.
`ClassBand`	A band that maps a finite set of values that may not be continuous.
`GenericBand`	A generic kind of band not fitting any other type.

Image

`Image`	An image with raster data.
`ImageUpload`	The status object returned when you upload an image using `upload()` or `upload_ndarray()`.
`ImageCollection`	Holds Images, with methods for loading their data.

Blob

`Blob`	A stored blob (arbitrary bytes) that can be searched and retrieved.
`BlobCollection`
`BlobDeletionTaskStatus`	The asynchronous deletion task's status

Search

`Search`	A search request that iterates over its search results.
`ImageSearch`	A search request that iterates over its search results for images.
`ImageSummaryResult`	The readonly data returned by `SummaySearch.summary()` or `SummaySearch.summary_interval()`.
`BlobSearch`	A search request that iterates over its search results for blobs.
`BlobSummaryResult`	The readonly data returned by `SummaySearch.summary()` or `SummaySearch.summary_interval()`.
`EventSubscriptionSearch`	A search request that iterates over its search results for event subscriptions.
`properties`	A wrapper object to construct filter properties by referencing instance attributes.

EventSchedule

`EventSchedule`	A Scheduled Event.
`EventScheduleCollection`

EventSubscription

`EventSubscription`	A Subscription to receive event notifications.
`EventSubscriptionCollection`
`EventSubscriptionTarget`	Target for an EventSubscription.
`EventSubscriptionComputeTarget`	An EventSubscriptionTarget tailored for a compute function.
`EventSubscriptionSqsTarget`	An EventSubscriptionTarget tailored for an SQS queue.
`NewImageEventSubscription`	A convenience class for creating an EventSubscription for a new image event.
`NewStorageEventSubscription`	A convenience class for creating an EventSubscription for a new storage event.
`NewVectorEventSubscription`	A convenience class for creating an EventSubscription for a new storage event.
`ComputeFunctionCompletedEventSubscription`	A convenience class for creating an EventSubscription for a compute function completion event.
`ScheduledEventSubscription`	A convenience class for creating an EventSubscription for a scheduled event.

EventRule

`EventRule`	An EventBridge rule to match event subscription targets.
`EventRuleCollection`
`EventRuleTarget`	Target for an EventRule.

EventApiDestination

`EventApiDestination`	An EventBridge API destination.
`EventApiDestinationCollection`

Types

`DocumentState`	The state of the catalog object.
`TaskState`	The state of a task.
`DataType`	Valid data types for bands.
`BandType`	Types of bands with different data interpretation.
`Colormap`	Predefined colormaps available to assign to bands.
`ProcessingStepAttribute`	Processing Levels Step.
`ProcessingLevelsAttribute`	An attribute that contains properties (key/value pairs).
`Resolution`	A spatial pixel resolution with a unit.
`ResolutionUnit`	Valid units of measure for Resolution.
`File`	File definition for an Image.
`StorageState`	The storage state for an image or blob.
`StorageType`	The storage type for a blob.
`ImageUploadOptions`	Control of the upload process.
`ImageUploadType`	The type of upload data.
`OverviewResampler`	Allowed overview resampler algorithms.
`ImageUploadStatus`	The status of the image upload operation.
`ImageUploadEvent`	Image upload event data.
`ImageUploadEventType`	The type of the image upload event.
`ImageUploadEventSeverity`	The severity of an image upload event.
`EventType`	The event type for a subscription.
`Placeholder`	Placeholder class for EventSubscriptionComputeTarget.
`EventConnectionParameter`	Parameter value for a connection.

Exceptions

`AttributeValidationError`	There was a problem validating the corresponding attribute.
`DeletedObjectError`	Indicates that an action cannot be performed.
`UnsavedObjectError`	Indicate that an action cannot be performed.

Note that many API calls result in a network request, which can result in a spurious ClientError or ServerError exception. This has been documented for all calls that are susceptible to this. A non-exhaustive list of potential exceptions that can occur are:

AuthError when you don’t have the necessary credentials to access the Descartes Labs services.
RateLimitError when there are too many request within a given time interval.
ServerError when there is an internal error in one of the Descartes Labs services.
GatewayTimeoutError when there is congestion in the Descartes Labs networks.

Catalog Client

CatalogClient

The CatalogClient handles the HTTP communication with the Descartes Labs catalog.