Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Standard names: area fraction #24

Closed
taylor13 opened this issue May 11, 2022 · 14 comments
Closed

Standard names: area fraction #24

taylor13 opened this issue May 11, 2022 · 14 comments
Labels
moderator attention (added by GitHub action) Moderators are requested to consider this issue standard name (added by template) Requests and discussions for standard names and other controlled vocabulary

Comments

@taylor13
Copy link

taylor13 commented May 11, 2022

In the descriptions of standard names that include the string "area_fraction", the guidance provided includes the following:

"Area fraction" is the fraction of a grid cell's horizontal area that has some 
characteristic of interest.  It is evaluated as the area of interest divided by the 
grid cell area.

This seems to rule out defining such fractions as the area of interest divided by the area of some portion of the grid cell (e.g., the area of snow on sea ice divided by the area of sea ice, which in general differs from the area of snow in a grid cell divided by the area of the grid cell).

This is a problem that has cropped up in CMIP where, for example, the fraction of sea ice area covered by melt ponds was incorrectly assigned the standard name area_fraction. According to the guidance for area_fraction, the variable should be interpreted as fraction of grid cell area covered by melt ponds, not fraction of sea ice area covered by melt ponds.

In order to accommodate fractions of some portion of a grid cell (rather than the entire grid cell), we might adopt one of the following:

  1. define a new standard name, partial_area_fraction. (This idea was suggested to me by @martinjuckes.)
  2. revise the restrictive guidance to read:
"Area fraction" is the fraction of a grid cell's horizontal area that has some 
characteristic of interest.  It is evaluated as the area of interest divided by the 
grid cell area, or if the cell_methods restricts the evaluation to some portion of 
that grid cell (e.g. "where sea_ice"), then it is the area of interest divided by the 
area of the identified portion.

I initially favored Martin's suggestion, but now realize that there are a number of other standard names that include the string "area_fraction" (surface_snow_area_fraction, tendency_of_sea_ice_area_fraction_due_to_thermodynamics, and many more), which also might need a second standard name with "area_fraction" replaced by "partial_area_fraction". Another virtue of the second option is that the mistake in using area_fraction in CMIP would be corrected by relaxing the restriction that the fraction's divisor should be the full grid cell area.

@taylor13 taylor13 added the standard name (added by template) Requests and discussions for standard names and other controlled vocabulary label May 11, 2022
@JonathanGregory
Copy link
Contributor

Dear Karl @taylor13

I would favour keeping the existing standard names, and to modify the guidance in the way you suggest. I think that area fraction should be regarded as an intensive quantity, which can be averaged over any area or area type.

Cheers

Jonathan

@taylor13
Copy link
Author

Dear @japamment et al.,
There seems to be no objection to clarifying (and making less restrictive) the definition of the standard_name "area_fraction". Could we change it to read:

"Area fraction" is the fraction of a grid cell's horizontal area that has some 
characteristic of interest.  It is evaluated as the area of interest divided by the 
grid cell area, or if the cell_methods restricts the evaluation to some portion of 
that grid cell (e.g. "where sea_ice"), then it is the area of interest divided by the 
area of the identified portion.

thanks,
Karl

@github-actions
Copy link

This issue has had no activity in the last 30 days. This is a reminder to please comment on standard name requests to assist with agreement and acceptance. Standard name moderators are also reminded to review @feggleton @japamment

@japamment
Copy link
Member

Dear Karl @taylor13 and Jonathan @JonathanGregory,

Apologies for having overlooked this issue, and that my response is long overdue.

I have a few questions about the proposal.

I can see the benefit of extending the description of area_fraction to allow for fractions of portions of grid cells (identified by cell_methods using phrases such as "where sea_ice") and how this might apply to the melt pond example in CMIP6 data. For this usage, would the method part of cell_methods be "mean"? This would seem to make sense for describing the total area within a grid cell having a given characteristic divided by the total area of the identified portion. What cell_method was used in the CMIP6 data?

If "mean" is always the correct cell_method to use for an area_fraction then I think we should include a statement to that effect in the standard name description.

Also, is the intention that the proposed change should be applied to all X_area_fraction standard names? It seems to me that it should.

Best wishes,
Alison

@taylor13
Copy link
Author

In common usage of area_fraction, I think "mean" is often the appropriate method for the spatial dimension, but not necessarily the time dimension, and in general I can imagine that sometimes "standard_deviation" or some other cell method would be called for.

I agree that the description should apply to all X_area_fraction standard names.

@github-actions github-actions bot removed the moderator attention (added by GitHub action) Moderators are requested to consider this issue label Jul 31, 2024
@efisher008
Copy link
Collaborator

Hi @japamment @taylor13,

Were there any agreed actions from this discussion?

Best wishes,
Ellie

@taylor13
Copy link
Author

taylor13 commented Aug 7, 2024

I think we should replace some (or all?) of the current descriptions of standard_names that include the text "area_fraction" with what I have written in #24 (comment). I don't think there have been objections to that. I can help with whether it is "some" or "all" if we are in general agreement.

@JonathanGregory
Copy link
Contributor

I agree with applying Karl's words.

@efisher008
Copy link
Collaborator

Hi Karl @taylor13,

I agree this seems sensible. If you could help with identifying which names to apply this to, that would be much appreciated.
From the current version (v85) of the Standard Names table, I found the following names containing area_fraction:

  • area_fraction
  • area_fraction_below_surface
  • area_fraction_of_day_defined_by_solar_zenith_angle
  • area_fraction_of_night_defined_by_solar_zenith_angle
  • area_fraction_of_twilight_defined_by_solar_zenith_angle
  • burned_area_fraction
  • clear_sky_area_fraction
  • cloud_area_fraction
  • cloud_area_fraction_in_atmosphere_layer
  • convective_cloud_area_fraction
  • convective_cloud_area_fraction_in_atmosphere_layer
  • floating_ice_shelf_area_fraction
  • fog_area_fraction
  • fraction_of_time_with_sea_ice_area_fraction_above_threshold
  • gross_rate_of_decrease_in_area_fraction
  • gross_rate_of_increase_in_area_fraction
  • grounded_ice_sheet_area_fraction
  • high_type_cloud_area_fraction
  • ice_cloud_area_fraction
  • ice_cloud_area_fraction_in_atmosphere_layer
  • isccp_cloud_area_fraction
  • land_area_fraction
  • land_ice_area_fraction
  • liquid_water_cloud_area_fraction
  • liquid_water_cloud_area_fraction_in_atmosphere_layer
  • low_type_cloud_area_fraction
  • medium_type_cloud_area_fraction
  • permafrost_area_fraction
  • sea_area_fraction
  • sea_ice_area_fraction
  • snow_area_fraction_viewable_from_above
  • stratiform_cloud_area_fraction
  • stratiform_cloud_area_fraction_in_atmosphere_layer
  • surface_snow_area_fraction
  • tendency_of_sea_ice_area_fraction_due_to_dynamics
  • tendency_of_sea_ice_area_fraction_due_to_ridging
  • tendency_of_sea_ice_area_fraction_due_to_thermodynamics
  • vegetation_area_fraction

There are also three accepted (but not yet published) names in the CF editor with this term:

  • modis_ice_topped_cloud_area_fraction (#52)
  • modis_liquid_topped_cloud_area_fraction (#52)
  • modis_cloud_area_fraction (#52)

Best wishes,
Ellie

@taylor13
Copy link
Author

Thanks for the list. I think the following text should be included in the description of all the above standard names.

"Area fraction" is the fraction of a grid cell's horizontal area that has some 
characteristic of interest.  It is evaluated as the area of interest divided by the 
grid cell area, or if the cell_methods restricts the evaluation to some portion of 
that grid cell (e.g. "where sea_ice"), then it is the area of interest divided by the 
area of the identified portion.

best,
Karl

@efisher008
Copy link
Collaborator

Hi @taylor13,

Thank you for your reply and for re-posting the text. This has replaced the original definition of area_fraction in all above names and has been added to the accepted names relating to MODIS variables.

The rest of the definition was unchanged and so the full text reads as follows:
"Area fraction" is the fraction of a grid cell's horizontal area that has some characteristic of interest. It is evaluated as the area of interest divided by the grid cell area, or if the cell_methods restricts the evaluation to some portion of that grid cell (e.g. "where sea_ice"), then it is the area of interest divided by the area of the identified portion. It may be expressed as a fraction, a percentage, or any other dimensionless representation of a fraction. To specify which area is quantified by a variable with standard name area_fraction, provide a coordinate variable or scalar coordinate variable with standard name area_type. Alternatively, if one is defined, use a more specific standard name of X_area_fraction for the fraction of horizontal area occupied by X.

I have also amended the definition of the phrase area_fraction in the CF phrasebank to the above text.

Are there any other actions from this issue that need to be highlighted?

Best,
Ellie

@taylor13
Copy link
Author

Thanks Ellie. The above looks fine. To be sure, I assume the full description above would only be used for the stand-alone area_fraction, not all the other "area fraction" standard names (since the last 2 sentences in the description would not generally apply). Right?

@efisher008
Copy link
Collaborator

Hi @taylor13,

That is correct - the full description is only applied to area_fraction.

Best,
Ellie

Copy link

This issue has had no activity in the last 30 days. Accordingly:

  • If you proposed this issue or have contributed to the
    discussion, please reply to any outstanding concerns.
  • If there has been little or no discussion, please comment
    on this issue, to assist with reaching a decision.
  • If the proposal seems to have come to a consensus, please
    wait for the moderators to take the next steps towards
    acceptance.

Standard name moderators are also reminded to review @feggleton @japamment @efisher008

@github-actions github-actions bot added the moderator attention (added by GitHub action) Moderators are requested to consider this issue label Sep 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
moderator attention (added by GitHub action) Moderators are requested to consider this issue standard name (added by template) Requests and discussions for standard names and other controlled vocabulary
Projects
None yet
Development

No branches or pull requests

4 participants