Pléiades Primary (Download)

Primary: Sensor image, not georeferenced or map-projected, and rigourous model metadata (attitude, ephemeris) allowing geometric processing (orthorectification – DEM extraction). RGB+NIR (2 m) and panchromatic (0.5 m) bands.


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.

Pléiades Primary images
Pléiades Primary images

Dataset information

SpecificationsDescription
Spatial resolution2m (MS)
0.5m (P)
Image typeOptical
Geographic coverageGlobal
Acquisition modeStereo, Tri-stereo
Geometric processing levelPrimary
Radiometric processing levelReflectance
Data availability2012-present
Incidence angleUp to 45°
Spectral bandsR (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 formatGeoTIFF
MetadataRational Polynomial Coefficients - provided for easier orthorectification and geometric processing.
Attitude and ephemeris data
Bit depth per pixel12-bit
Coordinate systemWGS84
Can be reused in an UP42 workflowNo

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:

ParameterOverview
idsarray 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_seriesarray 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.
timestring / 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.
limitinteger / 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_onlyboolean
If true, returns all stereo images for specified AOI and time range. The default value is false.
max_cloud_coverinteger
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_aoiboolean / 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.
bboxarray 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.
containsobject / 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.
intersectsobject / 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 km2.

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:

Loading...

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

Loading...

Capabilities

Output

raster
up42_standard
bands
[
  "red",
  "green",
  "blue",
  "nir",
  "pan"
]
dtypeuint16
formatGTiff
sensorPleiades
resolution0.5
processing_levell1
To know more please check the block capabilities specifications.