wmo-im / wmds

WIGOS Metadata Standard: Semantic standard and code tables
16 stars 22 forks source link

1-01-01 Align radiation variables requirements #389

Closed fstuerzl closed 9 months ago

fstuerzl commented 2 years ago

Proposal Summary

Summary and Purpose

Provide consistent names and descriptions/definitions for radiation terminology; align terminology in use in OSCAR/Surface (based on the WMO codes registry) and OSCAR/Requirements.

Proposal

Add definitions and include the term "radiation" in the UV variables:

notation path name description
267 \Atmosphere\Radiation\Background luminance Background luminance Luminous flux received from the background per unit solid angle and per unit area. Note: Luminous flux is a quantity derived from radiant flux by evaluating the radiation according to its action upon the International Commission on Illumination standard photometric observer.
270 \Atmosphere\Radiation\Sunshine duration Sunshine duration The total time in one day during which the direct solar irradiance is equal to or more than the threshold value for bright sunshine (the threshold being 120 W m–2 of direct solar irradiance).
271 \Atmosphere\Radiation\Surface albedo Surface albedo Hemispherically integrated reflectance of the Earth surface in the range 0.4-0.7 µm.   
273 \Atmosphere\Radiation\UV\UV-B radiation UV-B radiation Ultraviolet radiation covering the range 280-315 nm.
356 \Atmosphere\Radiation\UV\UV Broadband radiation UV Broadband radiation Spectrally integrated UV radiation 
357 \Atmosphere\Radiation\UV\UV Erythemal radiation UV Erythemal radiation Radiation effective in causing actinic erythema.
358 \Atmosphere\Radiation\UV\UV Multiband radiation UV Multiband radiation UV radiation measured across several discrete, narrow wavebands (e.g. 10 nm) within the UV range, providing coarse spectral information
359 \Atmosphere\Radiation\UV\UV Spectral radiation UV Spectral radiation UV radiation measured at continuous and higher spectral resolution (e.g. 1 nm) than multiband UV radiation.
Replace the name and add a description for the following variables: notation current name new name new description
566 Long-wave radiation (downwelling) Downward long-wave irradiance Flux density of downwelling long-wave radiation, at a specified level within the atmosphere, including the Earth surface.
567 Long-wave radiation (upwelling) Upward long-wave irradiance Flux density of upwelling long-wave radiation, at the top of the atmosphere or at a specified level within the atmosphere, including the Earth surface.
565 Long-wave radiation (direction unspecified) Long-wave irradiance (direction unspecified) Flux density of long-wave radiation (direction unspecified) at a specified level within the atmosphere, including the Earth surface. Long-wave radiation is the radiation at wavelengths greater than 3 μm (3000 nm), including most of the spectrum emitted by sources at terrestrial temperatures.
571 Diffuse solar radiation Diffuse downward short-wave irradiance Flux density of diffuse short-wave solar radiation, at a specified level within the atmosphere, including the Earth surface.
572 Direct solar radiation Direct downward short-wave irradiance Flux density of direct downwelling short-wave solar radiation, at the top of the atmosphere or at a specified level within the atmosphere, including the Earth surface.
573 Global solar radiation (downwelling) Downward short-wave irradiance Flux density of downwelling short-wave solar radiation, at the top of the atmosphere or a specified level within the atmosphere, including the Earth surface. [The term “global (downward) shprtwave irradiance’ is sometimes used to specify that this flux is the sum of direct and diffuse components.]
574 Global solar radiation (upwelling) Upward short-wave irradiance Flux density of upwelling short-wave radiation, at the top of the atmosphere or a specified level within the atmosphere, including the Earth surface.

Include the following new variables in table 1-01-01 (Atmosphere):

notation name description tags path
new id Net short-wave irradiance Flux density of short-wave solar radiation, as the difference between downwelling and upwelling radiation (positive for net downward), at the top of the atmosphere or at a specified level within the atmosphere, including the Earth surface.  Radiation \Atmosphere\Radiation
new id Short-wave irradiance (direction unspecified) Flux density of short-wave radiation (direction unspecified) at a specified level within the atmosphere, including the Earth surface. Short-wave radiation includes most of the solar radiation spectrum in the atmosphere from 280 nm to 3000 nm (3 μm). Radiation  \Atmosphere\Radiation
new id Net long-wave irradiance Flux density of upwelling long-wave radiation, as the difference between downwelling and upwelling radiation (positive for net downward) at a specified level within or at the top of the atmosphere, including the Earth surface.   Radiation \Atmosphere\Radiation
new id Upward spectral radiance Upward radiant power per area unit, per solid angle, and per wavelength or wavenumber interval . Radiation \Atmosphere\Radiation
new id Downward spectral radiance Downward radiant power per area unit, per solid angle, and per wavelength or wavenumber interval . Radiation \Atmosphere\Radiation
new id Solar spectral irradiance Spectrally resolved flux density of radiation received from the sun at the top of the atmosphere Radiation \Atmosphere\Radiation
new id Solar total irradiance Spectrally integrated flux density of radiation received from the sun at the top of the atmosphere. Also called “Total solar irradiance (TSI)”. Radiation \Atmosphere\Radiation
new id Earth surface short-wave bidirectional reflectance Reflectance of the Earth surface as a function of the viewing angle and the illumination angle averaged over the range 0.4-0.7 µm. Radiation \Atmosphere\Radiation
new id Earth surface spectral bidirectional reflectance Reflectance of the Earth surface as a function of viewing angle, incidence angle and wavelength, spectrally resolved. [The distribution of this variable is represented by the Bidirectional Reflectance Distribution Function (BRDF) ] Radiation \Atmosphere\Radiation
new id Earth surface emissivity Emissivity of the Earth surface as a function of wavelength and viewing angle. Radiation \Atmosphere\Radiation
new id Long-wave earth surface emissivity Emissivity of the earth surface integrated over the thermal IR wavelength range and integrated hemispherically.   Radiation \Atmosphere\Radiation

Reason

Some radiation variables in OSCAR/Requirements currently have no corresponding WMDR variable:

Stakeholder(s)

@JohnEyre

Consultations

@laurentvuilleumier, @PeterBlattner, @AnnWebb

Context

[include references to manuals or guides that are reviewed to ensure alignment, if proposal differs then document how and why]

Expected Impact of Change

LOW for new codes and changes of names and descriptions

JREyre commented 1 year ago

@fstuerzl @gaochen-larc @joergklausen @amilan17

For the record, I am copying here the comments from Sebastian Schmidt on my comments (above), together with my replies. I reviewed all the comments again, and so some of my replies are modified from previous emails:

  1. John: Diffuse short-wave irradiance: Is a definition of the net flux direction needed? The direction would normally be downward, but it is theoretically possible that it could be upward. Sebastian: Upward flux is always diffuse. When talking about diffuse irradiance, I can confirm that we typically mean downward, but I also agree that we could be more specific if that's preferable. John: I don’t think I agree that the upward flux is always diffuse. Over cloud it will often be close to diffuse. But, for example, over a calm (mirror-like) ocean with a cloud-free sky, it is close to specular. (I am taking “diffuse” to mean no variation with nadir angle but, from a measurement perspective, it will usually mean that the measurement integrates over all nadir angles, over the whole hemisphere. However, these are definitions of geophysical variables, not measurements.) However, Sebastian’s comment does not affect the definition. Sebastian: I think there's a confusion here between net irradiance (difference between downwelling and upwelling), and diffuse irradiance (component of the downwelling shortwave irradiance). Am I mis-reading something there? John: Net flux v upward and downward fluxes. The “requirement” is (usually) to observe the net, but measurements are usually of upward or downward. So, I think there is good reason to have both on the list, but we need to check that this is done consistently. I think they currently are consistent (if, perhaps, not complete). Does everyone agree?

  2. John: Background luminance: Is the note included in the definition needed? (Note: "Luminous flux is a quantity derived from radiant flux by evaluating the radiation according to its action upon the International Commission on Illumination standard photometric observer.") Sebastian: I would say an explanation would be helpful because it's not a typical quantity that we come across very often. That said, I am not sure I understand the note 🙂 What is meant by "background" in this context? Sorry to not have a straight answer for you here..... John: I agree with Sebastian - I too do not understand the comment. Can we identify an expert who is more familiar with this area? Alternatively, we could drop "Background luminance" from the list for the time being, in order to move this Issue along.

  3. Long-wave irradiance (direction unspecified). Sebastian: I think that's fine, but irradiance is often just specified w.r.t. a horizontal reference. (There are exceptions to this, for example, when quantifying horizontal photon flux density, but that is only rarely measured – almost never in the longwave). John: I agree with the comment, but I don't this affects the definition. noting that this is a geophysical variable, not a measurement.

  4. Earth surface short-wave bidirectional reflectance. Sebastian: This is of course correct, but the specification of the wavelength band seems somewhat arbitrary. In practice, most BRDF measurements are done spectrally and not averaged over the visible band. John: Spectrally integrated v spectrally resolved. It is true that most new missions measure spectrally resolved quantities, but some old missions measured spectrally integrated, and so there is good reason to include both.

  5. Albedo Sebastian: While we are on the topic: If BRDF is included, it might be useful to include albedo also since it is one of the primary modulators of Earth's radiation budget. It can be derived from upwelling and downwelling shortwave spectral or broadband irradiance, and therefore is not a primary parameter – maybe have a discussion amongst your team whether it's appropriate to include? John: We have an observed variable called "surface albedo" under "atmosphere". It currently lacks a definition. Franziska: why have we not addressed this before?

To summarise, Sebastian has given us some good comments, but I don't think they affect our proposed variables or their definitions, with the following exceptions:

gaochen-larc commented 1 year ago

AMS definition for Surface Albedo: The ratio, expressed as a percentage, of the amount of electromagnetic radiation reflected by the earth's surface to the amount incident upon it. Value varies with wavelength and with the surface composition.

I wonder if the definition should also indicate surface albedo is also a function of incident angle.

amilan17 commented 1 year ago

https://github.com/wmo-im/tt-wigosmd/wiki/2023.05.04-TT-WIGOSMD notes: There has been a lot of feedback recently and John is still following through.

AnnWebb commented 1 year ago

Add the concept of planetary albedo? Includes reflection from the atmosphere including clouds – as measured from satellites.

Ann

From: gaochen-larc @.> Sent: 04 May 2023 00:05 To: wmo-im/wmds @.> Cc: Ann Webb @.>; Mention @.> Subject: Re: [wmo-im/wmds] 1-01-01 Align radiation variables requirements (Issue #389)

AMS definition for Surface Albedo: The ratio, expressed as a percentage, of the amount of electromagnetic radiation reflected by the earth's surface to the amount incident upon it. Value varies with wavelength and with the surface composition.

I wonder if the definition should also indicate surface albedo is also a function of incident angle.

— Reply to this email directly, view it on GitHubhttps://github.com/wmo-im/wmds/issues/389#issuecomment-1533863116, or unsubscribehttps://github.com/notifications/unsubscribe-auth/A45BQQZVBYWQ7MIUSAYXW6DXELQCJANCNFSM5UPDZJFA. You are receiving this because you were mentioned.Message ID: @.***>

JREyre commented 1 year ago

@AnnWebb @gaochen-larc @joergklausen @fstuerzl Hi Ann, That's a very good thought. However, I have checked the OSCAR/Requirements and OSCAR/Space databases, and "planetary albedo" does not appear in either. This means that no Application Area (not even GCOS, for Climate Monitoring) has stated a requirement to observe it, and no Space Agency has registered a capability to observe it.
I will feed this back to the managers of the WIGOS RRR process. John

amilan17 commented 1 year ago

https://github.com/wmo-im/tt-wigosmd/wiki/2023.06.01-TT-WIGOSMD notes: @JohnEyre will add relevant content based on recent feedback; @fstuerzl will update branch; @joergklausen will validate PR

amilan17 commented 1 year ago

https://github.com/wmo-im/tt-wigosmd/wiki/2023.06.15-TT-WIGOSMD notes:

@joergklausen will review PR

amilan17 commented 1 year ago

https://github.com/wmo-im/tt-wigosmd/wiki/2023.06.30-TT-WIGOSMD notes:

@joergklausen will review PR 497

joergklausen commented 1 year ago

@amilan17 Done. Pls merge PR