Skip to content

Metadata Reference

Metadata is the term used to describe all the ancillary information about an image that might be important to the user.

This page captures all the metadata items that are present in ICEYE imagery. You can use the search bar at the top from any page and enter the metadata element you are interested in and it will find it on this page.

ICEYE Product Metadata (Version 2.4)

Format Metadata Elements Description Type Unit Example HDF5 SLC-XML GEOTIF AMP-XML
acquisition_end_utc UTC time for when the last pulse of the scene was sent ASCII UTC time 2019-03-10T18:20:00.307546
acquisition_id Identitification number for this acquisition ASCII int 469840
acquisition_mode Acquisition mode used ASCII text Stripmap, Spotlight
acquisition_prf Pulse Repetition Frequency used for the acquisition float64 Hz 4823.00342969132
acquisition_start_utc UTC time for when the first pulse of the scene was sent ASCII UTC time 2019-03-10T18:19:50.316054
angX X-component of the antenna pointing orientation vector of float64 TBP
angY Y-component of the antenna pointing orientation vector of float64 TBP
angZ Z-component of the antenna pointing orientation vector of float64 TBP
ant_elev_corr_flag Flag indicating if antenna elevation pattern compensation was applied int64 flag 1
antenna_pattern_compensation Amplification factor applied for antenna pattern compensation (for each range sample) vector of float numbers [1.8106, 1.8103...1.0956,1.0957]
AREA_OR_POINT geotif flag indicating if this is an area collection or a point collection ASCII text Area' or 'Point'
avg_scene_height Average elevation over ellipsoid (calculated using SRTM or other low resolution global DEM) float32 meters 661
azimuth_ground_spacing Azimuth sample spacing in meters with the average ground projected velocity float64 meters 1.44733
azimuth_spacing Azimuth sample spacing in meters with the average ground projected velocity float64 meters 1.44733
azimuth_look_bandwidth Bandwidth of each look in range (only for GRD products) float64 Hz 1157.2
azimuth_look_overlap Overlap of adjacent looks in azimuth (only for GRD products) float64 Hz 289.3
azimuth_looks Looks in azimuth direction (for SLC products it is 1) int64 number 3
azimuth_resolution 3dB resolution of this data product float64 meters 2.49
azimuth_time_interval Time interval between azimuth samples in the SLC product. (=1/processing_prf) float64 seconds 0.0002073
calibration_factor Factor to be applied to calibrate detected products to absolute brightness intensity float64 number 1.2341123e-05
carrier_frequency Carrier frequency of the radar system, static parameter float64 Hz 9650000000
chirp_bandwidth Bandwidth used for radar pulse (defines achievable radar range resolution) float64 Hz 134000000
chirp_duration Duration of chirp float64 seconds 4.1473e-05
coord_center Centre coordinate [x(col), y(row),lat,lon] [int32,int32, float64, float64] coordinates [8440,22139,34.86704,-117.99988]
coord_first_far First azimuth row far range coordinate. [x(col), y(row),lat,lon] [int32,int32, float64, float64] coordinates [16878,1,35.17738,-118,11233]
coord_first_near First azimuth row near range coordinate. [x(col), y(row),lat,lon] [int32,int32, float64, float64] coordinates [1,1,35.12016,-117.74549]
coord_last_far Last azimuth row far range coordinate. [x(col), y(row),lat,lon] [int32,int32, float64, float64] coordinates [16878,44298,34.61222,-118.24414]
coord_last_near Last azimuth row near range coordinate. [x(col), y(row),lat,lon] [int32,int32, float64, float64] coordinates [1,44298,34.55509,-117.88013]
data_orientation Can be either "native" or "shadows_down". This describes the data inside the product storage arrays. 'native' means columns are for increasing range and increasing rows are slow time. ''shadows-down' means increasing rows are increasing range and columns represent slow-time direction ASCII text "native"
dc_estimate_coeffs Doppler centroid coefficient as a 2D array, size MxN, where M is the number of DC estimates, and N is the (DC polynomial order+1) 2D array of float64, size MxN number [[5.417583e+03, 1.130813e+07, -8.125472e+09,7.947223e+12], ... [5.417583e+03, 1.130813e+07, -8.125472e+09,7.947223e+12]]
dc_estimate_poly_order Order of polynomial describing one doppler centroid estimate int64 number 3
dc_estimate_time_utc Timestamp for each doppler centroid estimate ASCII list Time (UTC) ['2019-03-10T18:19:51.775477'],['2019-03-10T18:19:52.775477'],['2019-03-10T18:19:53.775477'],['2019-03-10T18:19:54.775477']]
Doppler_Centroid_Coefficients XML Block of data containing sets of coefficiencts in a . Each Coefficient. Has a list index number , a and a . These are then followed by +1 coefficients (), each marked with a number () and a value (). See Doppler Centroid Coefficient Schema Coefficient Block Hz
Doppler_Rate See Doppler Rate Coefficients Schema Coefficient Block
doppler_rate_coeffs Coefficients of doppler rate polynomial as a function of range time. Stored as a vector with size corresponding to the order of the doppler rate polynomial vector of float64 number [5.124592968269841e+03; -1.153864338674892e+06; 2.582540352459471e+08; -5.572042961000484e+10]
doppler_rate_poly_order Order of polynomial describing doppler rate range dependence int64 number 3
first_pixel_time Two-way slant range time origin, corresponding to the near range (1st range sample) float64 seconds 0.004398670017444
fsl_compensation Amplification factor applied for free space loss compensation (for each range sample) vector of float64 numbers [1.0457, 1.0457...1.0841,1.0841]
gcp_terrain_model Options are WGS84 for Ellipsoid, EGM96 for GEOID, DEM for DEM based ASCII text
geo_ref_system Geographic reference frame indicator for scene coordinates and orbit state vectors ASCII text WGS84
grd_amplitude Amplitude array (only for GRD products). Sigma-nought conversion factor of sin(inc_angle) applied. as ‘sample_precision’ number array
grsr_coefficients ground range to slant range polynomial coefficients (only for GRD product) vector of float64 number [6.467483312430216e+05; 0.47388031307797884; 6.685331046296479e-07; -4.928145432555108e-13; 5.0525558404285224e-20]
GRSR_Coefficients See GRSR_Coefficients schema Coefficient Block
grsr_ground_range_origin ground range origin for GRSR conversion number 0
grsr_poly_order Order of polynomial describing ground range to slant range projection dependence (only for GRD product) int64 number 4
grsr_zero_doppler_time ground range origin zero Doppler time ASCII UTC time 2019-04-08T14:50:13.120113
height_spline Python numpy spline parameters for surface height used to focus image hickle meters
heading Satellite heading at centre of imaging operation float64 degrees
incidence_angle_coefficients coefficients of the polynomial for calculating the incidence angle dependence in range vector of float64 number [ 2.67986035e+01; 8.66207416e-05; -5.61940883e-11; -1.73946139e-17; 8.22003978e-23]
Incidence_Angle_Coefficients See Incidence_Angle_Coefficients XML Block Schema Coefficient Block number
incidence_angle_ground_range_origin incidence angle origin in ground range, for calculating incidence angle dependence in range float64 number 0
incidence_angle_poly_order order of the polynomial for calculating the incidence angle dependence in range int64 number 4
incidence_angle_zero_doppler_time incidence angle origin zero Doppler time ASCII UTC time 2019-04-08T14:50:13.120113
incidence_center incidence angle in ground at middle range float64 degrees 23.5
incidence_far incidence angle in ground at far range float64 degrees
incidence_near incidence angle in ground at near range float64 degrees
lat_spline Python numpy spline parameters for image pixel latitudes hickle degrees
local_incidence_angle Array of values describing the local incidence angle or each range sample in the scene []float64 degrees
look_side Look side of the acquisition, only 2 options LEFT or RIGHT ASCII text LEFT
lon_spline Python numpy spline parameters for image pixel longitudes hickle degrees
mean_earth_radius mean WGS84 ellipsoid radius over scene float64 meters 6371346.049
mean_orbit_altitude mean sensor altitude above WGS84 ellipsoid float64 meters 595177.494
number_of_azimuth_samples Number of azimuth samples (number of rows in binary data) int64 number 44298
number_of_dc_estimations Number of doppler centroid estimates int64 number 9
number_of_range_samples Number of range samples (number of columns in binary data) int64 number 16878
number_of_state_vectors Total number of orbit state vectors provided for the scene int64 number 120
orbit_absolute_number Absolute number of orbits since launch int64 number 1447
orbit_direction Specifies whether the orbit is in ascending or descending node at the time of acquisition ASCII text ASCENDING or DESCENDING
orbit_processing_level PREDICTED (based on orbit propagation model ) RAPID (uses onboard GPS data ) PRECISE (corrections applied after GPS data received in ground using high precision orbit propagator (eg ODTK) SCIENTIFIC (Uses precise ground-based measurements together with all above to post-fix orbit to best possible) ASCII Text
orbit_relative_number Relative number of orbit within the repeat cycle int64 number 1447
orbit_repeat_cycle Ground track repeat cycle (to be included) int64 number 99999
Orbit_State_Vectors See Orbit_State_Vectors XML Schema Coefficient Block
pitch Pitch angle of the satellite attitude float degrees 11.5
polarization Transmit and receive polarizations used ASCII text VV
posX X-component of state vector position, for each state vector vector of float64 meters [-2401162517… -2456350660]
posY Y-component of state vector position, for each state vector vector of float64 meters [-5201254993… -5253761907]
posZ Z-component of state vector position, for each state vector vector of float64 meters [3963994744… 3859728760]
processing_prf Pulse Repetition Frequency used for the processing, defines azimuth sample spacing in time (can be higher than acquisition in cases where the Doppler frequency needs to be unfolded due to high variation of Doppler centroid with range) float64 Hz 9646.00685938265
processing_time Timestamp provided by the SAR processor saying when the image for processed ASCII UTC Time 2020-05-27T05:01:49.123456
processor_version Version number of the processor used to generate the product float64 number (internal version numbering)
product_level Processing level ASCII text SLC, GRD
product_file File name of this product ASCII text ICEYE_X2_SLC_SM_16519_20200102T155349.h5
product_name ICEYE_datasetID_eventID_(YYYYMMDD)T(HHMMSS) ASCII Text ICEYE_2457_123123_20191201T056721
product_type Product type (if we have product names for different imaging modes) ASCII text Stripmap, StripmapHigh, Spotlight, SpotlightHigh
range_look_bandwidth Bandwidth of each look in range (only for GRD products) float64 Hz 53600000
range_look_overlap Overlap of adjacent looks in range (only for GRD products) float64 Hz 13400000
range_looks Looks in range direction (for SLC products it is 1) int64 number 3
range_resolution_center Scene centre range resolution float64 meters 2.15
range_resolution_far Range resolution at the far edge of the image float64 meters 1.93
range_resolution_near range resolution at the near edge of the image float64 meters 2.49
range_sampling_rate Sampling rate used for digital sampling, defines range sample spacing in time float64 Hz 157500000
range_spacing
range_spread_comp_flag Flag indicating if free space loss compensation was applied int64 flag 1
ref_track_point_ecef reference point for image in earth centred earth fixed coordinate frame []float64 m array
ref_track_point_lla reference poInt for image in terms of latitude, longitude and altitude []float64 deg,deg,m array
RPC RPC according to http://geotiff.maptools.org/rpc_prop.html Coefficient Block
s_i Real part of the SLC complex array (only for SLC products) as ‘sample_precision’ number array
s_q Imaginary part of the SLC complex array (only for SLC products) as ‘sample_precision’ number array
sample_precision Precision used for binary data samples ASCII text float32, int16
satellite_look_angle Satellite look angle float64 degrees 23.5
satellite_name Name of the satellite ASCII text ICEYE-X2, ICEYE-X4...
scan_beams Provides information Scan beams used in Scan mode (SCAN MODE ONLY) Struct
slant_range_spacing Spacing between two consecutive slant range samples in meters (SLC ONLY) float64 meters 0.95172208888
slant_range_to_first_pixel Two-way slant range distance corresponding to near range (1st sample) float64 metres
spec_version Version of the Level 1 Product Format Specification document float64 number 2.3
state_vector_time_utc Timestamp for each orbit state vector list of ASCII UTC time [2019-03-10T18:19:48.000000, ...]
total_processed_bandwidth_azimuth Doppler bandwidth used for azimuth compression (defines achievable azimuth resolution) float64 Hz 2893
tropo_range_delay Mean signal path length correction (one way) that has been applied to correct for tropospheric propagation float64 meters 2.4
velX X-component of state vector velocity, for each state vector vector of float64 meters/sec [-3285.698...-3245.220]
velY Y-component of state vector velocity, for each state vector vector of float64 meters/sec [-3162.667...-3051.016]
velZ Z-component of state vector velocity, for each state vector vector of float64 meters/sec [-6130.372...-6208.463]
window_function_azimuth Windowing function used over azimuth frequencies ASCII text taylor_20_4
window_function_range Windowing function used over range frequencies ASCII text taylor_20_4
yaw Yaw angle of the satellite attitude float degrees
zerodoppler_end_utc Time corresponding to when the satellite was at the zero Doppler position for the last scene pulse ASCII UTC time 2019-03-10T18:20:00.960210
zerodoppler_start_utc Time corresponding to when the satellite was at the zero Doppler position for the first scene pulse ASCII UTC time 2019-03-10T18:19:51.775477