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.
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:
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:
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 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:
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 |