cf-convention / vocabularies

Issues and source files for CF controlled vocabularies
3 stars 1 forks source link

Modify description of `atmosphere_stability_k_index` #204

Closed JonathanGregory closed 6 months ago

JonathanGregory commented 10 months ago

The description of atmosphere_stability_k_index currently says The index is derived from the difference in air temperature between 850 and 500 hPa, the dew point temperature at 850 hPa, and the difference between the air temperature and the dew point temperature at 700 hPa. I propose that this sentence should be changed to The index is the sum of three quantities: the difference in air temperature between 850 and 500 hPa, the dew point temperature at 850 hPa, and the difference between the air temperature and the dew point temperature at 700 hPa. That would be more informative. Its definition is given by https://en.wikipedia.org/wiki/K-index_(meteorology). (Thanks to @larsbarring for this reference.) Jonathan

github-actions[bot] commented 10 months ago

Thank you for your proposal. These terms will be added to the cfeditor (http://cfeditor.ceda.ac.uk/proposals/1) shortly. Your proposal will then be reviewed and commented on by the community and Standard Names moderator.

taylor13 commented 10 months ago

That description would indeed be much more specific and helpful. I support the change.

efisher008 commented 10 months ago

Hello @JonathanGregory and @taylor13,

Looking at the article you provided a link to, is it definitely correct to say the index is the sum of these three quantities? According to the equation:

image Where: image = Dew point at 850 hPa image = Temperature at 850 hPa image = Dew point at 700 hPa image = Temperature at 700 hPa image = Temperature at 500 hPa

It seems to me as though the first two terms are summed i.e. added together, but the third (i.e. the difference between the air temperature and the dew point temperature at 700 hPa, the dewpoint depression at this pressure level) is subtracted from the total. Would using the phrase 'sum of' not imply that all terms are added together and so potentially lead to a misunderstanding of the calculation of K?

Best regards, Ellie

JonathanGregory commented 10 months ago

Dear Ellie @efisher008

Yes, quite right, sorry, and thanks for checking. Evidently I read that too quickly. It arose because @larsbarring and I were discussing whether this quantity is temperature: on_scale or temperature: difference, and that's not possible to tell from the existing description. With your correction, we could write it (mostly) in words as "The index is calculated as A + B - C, where A is the difference in air temperature between 850 and 500 hPa, B is the dew point temperature at 850 hPa, and C is the dew point depression at 700 hPa." Is that correct and clear? From this you can tell that the index could be a temperature: on_scale quantity, because A and C are defined as differences, but B is an on-scale temperature. Therefore the numerical value of the index will be different in degC and K. (Without B, it would be a temperature: difference quantity, which is the same in degC and K.)

Postscript: In https://github.com/cf-convention/vocabularies/issues/172 we list the standard name atmosphere_stability_k_index as "either". That's because the K-index is an on-scale temperature quantity (as in the last paragraph) and would need units_metadata="temperature: on_scale". On the other hand, the difference between two K-index values would need units_metadata="temperature: difference". A quantity with this standard name could therefore have either of these possibilities for units_metadata. As Lars writes below, a data-writer shouldn't put units_metadata="temperature: unknown" if they know what it is.

Best wishes

Jonathan

larsbarring commented 10 months ago

@JonathanGregory: Just to clarify, what do you mean by temperature: in_situ ?

If you are referring to the possible values of the new units_metadata attribute the possible values to go with a unit involving temperature are temperature: difference, temperature: on_scale and temperature: unknown, where the last alternative should only be used as a last resort if a data reader cannot ascertain which of the other two alternatives it is. A data writer should always select one of the other depending on the type of the data that is produced.

JonathanGregory commented 10 months ago

Sorry again! I mean on_scale, but wrote the wrong thing. Evidently I'm trying to do things too fast, or too many things, and consequently making stupider and more numerous mistakes than usual.

taylor13 commented 10 months ago

@JonathanGregory and all,

I think I'd include the definition of "dew point depression" in the description since to some the sign of a "depression" might be confusing. The end of the description could then read: "... and C is the dew point depression (i.e. the differences between actual temperature and dew point temperature) at 700 hPa."

JonathanGregory commented 10 months ago

Karl @taylor13, Yes, you're right (as always), and I agree that would be even more informative. Jonathan

efisher008 commented 10 months ago

Dear @JonathanGregory, @taylor13 and @jwrotny74,

I thought it would be appropriate to link Jonathan @jwrotny74 into this conversation as he is listed as the proposer for the name we are discussing. I have proposed a change to the description of the existing name in the table.

You can view the proposal here, the description now reads: _The atmosphere_stability_kindex is an index that indicates the potential of severe convection and is often referred to a simply the k index. The index is calculated as A + B - C, where A is the difference in air temperature between 850 and 500 hPa, B is the dew point temperature at 850 hPa, and C is the dew point depression (i.e. the differences between actual temperature and dew point temperature) at 700 hPa.

I wonder if it might be useful to insert the definition of dew point and/or dew point depression from the CF phrasebank into the description as well? These are: " Dew point temperature is the temperature at which a parcel of air reaches saturation upon being cooled at constant pressure and specific humidity." " Dew point depression is also called dew point deficit. It is the amount by which the air temperature exceeds its dew point temperature."

Please let me know your thoughts.

Best regards, Ellie

JonathanGregory commented 10 months ago

Those are actually the descriptions of the standard names dew_point_temperature and dew_point_depression, aren't they? Given they are defined as standard names, the parenthetical "(i.e. the differences between actual temperature and dew point temperature) " doesn't seem necessary after all, especially if you insert those extra phrases. Is it usual to copy descriptions of standard names into the descriptions of other standard names?

taylor13 commented 10 months ago

agree that no need to include parenthetical description if the additional descriptions are included.

efisher008 commented 10 months ago

Hello @JonathanGregory and @taylor13,

You are right that those are the descriptions of those two standard names. I think they have been added to the phrasebank in the case that the terms are used as part of a longer name in future. Since atmospheric_stability_k_index doesn't contain either of these phrases, I think perhaps it is unnecessary to add the definitions of dew_point_temperature and dew_point_depression when they don't form part of the standard name itself? Another equally useful option would be what you suggest, i.e. adding both descriptions and removing the parenthetical description suggested by @taylor13. What would be your preference?

Best wishes, Ellie

taylor13 commented 10 months ago

I think there is no need to define "dew point temperature". Anyone interested in atmospheric_stability_k_index will surely already know what dew point temperature is. Fewer folks will know what sign dew_point_depression has, so I think the more concise phrasing in https://github.com/cf-convention/vocabularies/issues/204 is preferable (but after correcting the typo by replacing "a simply" with "as simply").

efisher008 commented 10 months ago

Hello @JonathanGregory and @taylor13,

It sounds like you've come to a conclusion about the description. Does this text look alright to both of you?

_"The atmosphere_stability_kindex is an index that indicates the potential of severe convection and is often referred to as simply the k index. The index is calculated as A + B - C, where A is the difference in air temperature between 850 and 500 hPa, B is the dew point temperature at 850 hPa, and C is the dew point depression (i.e. the amount by which the air temperature exceeds its dew point temperature) at 700 hPa."

If you agree with this change and there are no further comments in the next 7 days, this term change can be accepted.

Best wishes, Ellie

JonathanGregory commented 10 months ago

Yes, that's fine. Thanks, Ellie.

efisher008 commented 9 months ago

Dear @JonathanGregory and @taylor13,

As 7 days have passed with no more comments, the term change has now been accepted. Thanks again for the discussion!

Best wishes, Ellie

efisher008 commented 9 months ago

Hi all,

Just to make you aware that this name has been included in the list of standard names in issue cf-convention/vocabularies#172 who need text adding for the value of the units_metadata attribute. I've changed the status of the name from 'accepted' to 'under discussion' in the CF editor while this and the rest of the names from that issue are dealt with, which will mean expanding the description slightly.

Best wishes, Ellie

efisher008 commented 8 months ago

Hi all,

This name has been accepted along with the other names in issue cf-convention/vocabularies#172 with additional text to clarify the use of the units_metadata attribute due to its use of temperature units. The next standard names table release (v85) is planned for mid-May.

Best, Ellie

efisher008 commented 6 months ago

Closing this issue as this name has been accepted in version 85 of the CF standard names table, published on 21 May 2024 (https://cfconventions.org/Data/cf-standard-names/85/build/cf-standard-name-table.html).