Skip to content

Client release v1.11.0
Compare
Choose a tag to compare
@stephencpope stephencpope released this 20 Jul 14:22
· 230 commits to master since this release
v1.11.0
c976515

Installation

  • The extra requirement options have changed. There are four extra requirement options now, visualization, tables,
    complete, and tests. visualization pulls in extra requirements to support operating in a Jupyter notebook or
    environment, enabling interactive maps and graphical displays. It is not required for operating in a "headless"
    manner. tables pulls in extra requirements to support the Tables client. complete is the combination of
    visualization and tables. tests pulls in extra requirements for running the tests. As always,
    pip install 'descarteslabs[complete]' will install a fully enabled client.

Configuration

  • The Descartes Labs client now supports configuration to support operating in different environments. By default,
    the client will configure itself for standard usage against the GCP platform ("gcp-production"), except in the case of AWS Marketplace users, for whom
    the client will configure itself against the AWS platform ("aws-production").
    Alternate environments can be configured by setting the DESCARTESLABS_ENV environment variable before starting python, or by using a prelude like 
    from descarteslabs.config import Settings
Settings.select_env("environment-name")
    before any other imports of any part of the descarteslabs client package.
  • The new AWS Enterprise Accelerator release currently includes only Auth, Configuration
    and the Scenes client.

Auth and Exceptions

  • The descarteslabs.client.auth package has moved to descarteslabs.auth. It is now imported
    into the original location at descarteslabs.client.auth to continue to work with existing
    code, but new code should use the new location.
  • The descarteslabs.client.exceptions module has moved to descarteslabs.exceptions. It is
    now imported into the original location at descarteslabs.client.exceptions to continue to
    work with existing code, but new code should use the new location.

Scenes

  • Fixed an issue in scenes.DLTile.from_shape where there would be incomplete coverage of certain geometries. The function may now return more tiles than before.
  • Added support for the new all_touched parameter to the different GeoContext types. Default behavior remains the same
    as always, but if you set all_touched=True this communicates to the raster service that you want the image(s) rastered
    using GDAL's CUTLINE_ALL_TOUCHED option which will change how source pixels are mapped to output pixels. This mode is
    only recommended when using an AOI which is smaller than the source imagery pixel resolution.
  • The DLTile support has been fixed to avoid generating gaps when tiling regions that span
    a large distance north-to-south and straddle meridians which are boundaries between
    UTM zones. So methods such as DLTile.from_shape may return more tiles than previously,
    but properly covering the region.
  • Added support for retrieving products and bands.
    • Methods added: get_product, get_band, get_derived_band, search_products,
      search_bands, search_derived_bands.
    • Disallows search without products parameter.
  • Scaling support has been enhanced to understand processing levels for newer products. The
    Scene.scaling_parameters and SceneCollection.scaling_parameters methods now accept
    a processing_level argument, and this will be factored in to the determination of
    the default result data type and scaling for all rastering operations such as Scene.ndarray
    and SceneCollection.mosaic.
  • If the user provides the rasterio package (which implies providing GDAL), then rasterio
    will be used to save any downloaded images as GeoTIFF, allowing for the use of compression.
    Otherwise, by default the tifffile support will be used to generate the GeoTIFF files
    but compression is not supported in this mode.
  • As the Places client has been deprecated, so has any use of the place= parameter supported
    by several of the Scenes functions and methods.

Catalog

  • (Core users only) Added support for specifying the image index to use when creating a new Product.
  • Added support for defining per-processing-level data_type, data_range, display_range
    and physical_range properties on processing level steps.

Discover

  • Added support for filtering Assets by type and name fields.
    • Supported filter types blob, folder, namespace, sym_link, sts_model, and vector. Specifying multiple types will find assets matching any given type.
    • The name field supports the following wildcards:
      • * matches 0 or more of any character.
      • ? matches 1 of any character.
    • Find assets matching type of blob and having a display name of file name.json or file2name.txt but not filename.json:
      • Discover().list_assets("asset/namespace/org:some_org", filters="type=blob&name=file?name.*")
      • Discover().list_assets("asset/namespace/org:some_org", filters=AssetListFilter(type=AssetType.BLOB, name="file?name.*"))
    • Find assets of type blob or vector:
      • Discover().list_assets("asset/namespace/org:some_org", filters="type=blob,vector")
      • Discover().list_assets("asset/namespace/org:some_org", filters=AssetListFilter(type=[AssetType.BLOB, AssetType.VECTOR], name="file?name.*"))

Metadata

  • Metadata.products and Metadata.available_products now properly implement paging so that
    by default, a DotList containing every matching product accessible to the user is returned.

Raster

  • If the user provides the rasterio package (which implies providing GDAL), then rasterio
    will be used to save any downloaded images as GeoTIFF, allowing for the use of compression.
    Otherwise, by default the tifffile support will be used to generate the GeoTIFF files
    but compression is not supported in this mode.

Tables

  • Fixed an issue that caused a user's schema to be overwritten if they didn't provide a primary
    key on table creation.
  • Now uses Discover backend filtering for list_tables() instead of filtering on the client to
    improve performance.
  • list_tables() now supports filtering tables by name
    • Tables.list_tables(name="Test*.json")

Tasks

  • New Tasks images for this release bump the versions of several dependencies, please see
    the Tasks guide for detailed lists of dependencies.

Workbench

  • The new Workbench release bumps the versions of several dependencies.

Workflows

  • Added support for the new all_touched parameter to the different GeoContext types.
    See description above under Scenes.

General

  • The Places client has been deprecated, and use thereof will generate a deprecation warning.
  • The older Catalog V1 client has been deprecated, and use thereof will generate a deprecation
    warning. Please use the Catalog V2 client in its place.
  • Documentation has been updated to include the `AWS Enterprise Accelerator" release.
  • With Python 2 far in the rearview mirror, the depedencies on the six python package have
    been removed throughout the library, the distribution and all tasks images.
Assets 2