4. Completing the Effects Table

What is the effects table?

The effects table codifies all the important information about any source of uncertainty (all the twigs in the measurement function tree).

How do I fill in the effects table?

Table descriptor		How this is codified	Notes
Name of effect		A unique name for each source of uncertainty in a term of the measurement function	If a similar effect is present for several terms, the names should be unique, e.g. earth count noise, ICT count noise
Affected term in measurement function		Name and standard symbol of affected term	Usually an effect will only affect a single term, though there may be exceptions, see Section 3.3.3.
Instruments in the series affected		Identifier of the specific instrument / satellite platform where this effect matters	Some effects may only apply to certain instruments in an FCDR series, or may take a different correlation form for different instruments
Correlation type and form	Pixel-to-pixel [pixels]	One of the types defined in Section 4.2: provided by name	Images is for GEO satellites, Orbits for LEO satellites.   Time is a more general quantity and needs an associated attribute describing the unit (e.g. day, week, month, year, epoch)
	from scanline to scanline [scanlines]
	between images [images]
	Between orbits [orbit]
	Over time [time]
Correlation scale	Pixel-to-pixel [pixels]	In units of pixels, scanlines, time or images/orbits – what is the scale of the correlation shape?	See Section 3.4.2. The parameters defined for the particular type and form provided here are as specified in Table 1.
	from scanline to scanline [scanlines]
	between images [images]
	Between orbits [orbit]
	Over time [time]
Channels/bands	List of channels / bands affected	Channel names in standard form	Some effects may only affect certain channels
	Error correlation coefficient matrix	A matrix	See Section 5.5
Uncertainty	PDF shape	Functional form of estimated error distribution for the term	See Section 5.3
	units	Units in which PDF shape is expressed (units of term, or can be as percentage etc)	See Section 5.3
	magnitude	Value(s) or parameterisation estimating width of PDF	See Section 5.3
Sensitivity coefficient		Value, equation or parameterisation of sensitivity of measurand to term	See Section 5.4

Useful Documents

Woolliams, E., Mittaz, J., Merchant C. & Harris, P., 2017, D2_2a: Principles behind the FCDR effects table

Block, T. & Embacher, S., 2017, CDR/FCDR file format specification