Pléiades Primary (Download)

Analytics platform discontinued after January 31, 2024

The current analytics platform will be discontinued after January 31, 2024, and will be replaced by new advanced processing functionalities. This change will affect projects, workflows, jobs, data blocks, processing blocks, and custom blocks. For more information, see the blog post.

Description

A data block that provides non-rectified, unprojected high resolution 12-bit Pléiades images. Available since 2012, these images are acquired by the twin constellation Pléiades 1A and 1B on a daily basis anywhere on the globe. These images are optimal for users familiar with remote sensing processing methods who want to apply their own production techniques (orthorectification or 3D modelling).

See this block on the marketplace.

Dataset information

Specifications	Description
Spatial resolution	2m (MS) 0.5m (P)
Image type	Optical
Geographic coverage	Global
Acquisition mode	Stereo, Tri-stereo
Geometric processing level	Primary
Radiometric processing level	Reflectance
Data availability	2012-present
Incidence angle	Up to 45°
Spectral bands	R (0.590-0.710 µm) G (0.500-0.620 µm) B (0.430-0.550 µm) NIR (0.740-0.940 µm) Panchromatic (0.470-0.830 µm)
File format	GeoTIFF
Metadata	Rational Polynomial Coefficients - provided for easier orthorectification and geometric processing. Attitude and ephemeris data
Bit depth per pixel	12-bit
Coordinate system	WGS84
Can be reused in an UP42 workflow	No

How it works

This block returns the RPC information encoded in the GeoTIFF file. To get the RPC data, use this code to return a dictionary with all the necessary information:

import rasterio as rio

tif_path = ""

with rio.open(tif_path) as src:
    rpc_dict = src.tags(ns="RPC")

For more information about geometric processing with RPCs, see the following online resources:

Pléiades User Guide
RPC Domain Metadata
GIS StackExchange
GDAL Documentation pages: RPC Georeferencing and gdalwarp

Parameter	Overview
`ids`	array of strings / required An array of unique IDs without file extensions, specifying a certain image acquired by a satellite sensor. If used without a geometric filter, the full scene is retrieved. The number of IDs must correspond with the number defined by `limit`. The default value is `null`.
`time_series`	array of strings / required if Required if `time` isn't specified. Image acquisition date and time ranges in RFC 3339 format. This collection is available from 01.01.2012. The number of time ranges must correspond with the number of images specified in `limit`. The default value is `null`.
`time`	string / required if Required if `time_series` isn't specified. An image acquisition date and time range in RFC 3339 format. This collection is available from 01.01.2012. The default value is `2018-01-01T00:00:00+00:00/2021-12-31T23:59:59+00:00`.
`limit`	integer / required The number of images to be returned. The maximum number of returned images: If you have no payment method associated with your account — `20` If you have a payment method associated with your account — `5000` The values of `ids` and `time_series` must correspond with the specified number of images. The default value is `1`.
`stereo_images_only`	boolean If `true`, returns all stereo images for specified AOI and time range. The default value is `false`.
`max_cloud_cover`	integer The maximum percentage of cloud cover. Values range from `0` (no cloud cover) to `100` (full cloud cover). The default value is `100`.
`clip_to_aoi`	boolean / required Whether the specified AOI should be clipped: `true` — the AOI should be clipped. `false` — the full scene will be returned. The cropped AOI works with stereoscopic reconstruction. Note that clipped non-rectified images may cause a substantial shift in the position of the image segment after orthorectification. The default value is `false`.
`bbox`	array of integers / required if Required if `intersects` or `contains` aren't specified. A bounding box to use as an AOI. Will clip to scenes that intersect with this box.
`contains`	object / required if Required if `bbox` or `intersects` aren't specified. A GeoJSON geometry to use as an AOI. Will clip to scenes that fully cover this geometry.
`intersects`	object / required if Required if `bbox` or `contains` aren't specified. A GeoJSON geometry to use as an AOI. Will clip to scenes that intersect with this geometry.

Compatibility

Don't combine primary data with processing blocks. The primary geometric processing level is the closest to the natural image acquired by the sensor. It's not orthorectified, while processing blocks expect orthorectified products.

Limitations

AOI size: The AOI must be larger than 0.1 km².

Geometric filter: The output image is clipped to the AOI bounding box, so the image gaps will be padded with zeros until the bounding box is covered. Depending on the AOI shape and irregularity, the final output image might be larger and the credit consumption will slightly increase.

Examples

Example based on a workflow created with the data block Pléiades Primary without (tri-)stereo images:

Example based on a workflow created with the data block Pléiades Primary with (tri-)stereo images:

Capabilities

Output

raster

up42_standard
`bands`	[ "red", "green", "blue", "nir", "pan" ]
`dtype`	`uint16`
`format`	`GTiff`
`sensor`	`Pleiades`
`resolution`	`0.5`
`processing_level`	`l1`

To know more please check the block capabilities specifications.