Rename turbulent_kinetic_energy and change units

[nusbaume]

Currently the repo contains the standard name turbulent_kinetic_energy with units of J. However, in atmospheric science the default units for TKE is J kg-1, which are the units for the variable in both SIMA and the UFS (although the diagnostic output in the UFS has it mislabeled as just J).

Thus in order to clarify the units, and to better match the CF-conventions, it was decided to change the standard name in this repo to be specific_turbulent_kinetic_energy, and to change the units to J kg-1.

[dudhia]

I don't think the word "specific" is needed. There are many energies like CAPE and moist static energy that are conventionally J/kg. For sure, J is not correct. Jimy

…

On Fri, Jun 14, 2024 at 8:48 AM Jesse Nusbaumer ***@***.***> wrote: Currently the repo contains the standard name turbulent_kinetic_energy with units of J. However, in atmospheric science the default units for TKE is J/kg, which are the units for the variable in both SIMA and the UFS (although the diagnostic output in the UFS has it mislabeled as just J ). Thus in order to clarify the units, and to better match the CF-conventions, it was decided to change the standard name in this repo to be specific_turbulent_kinetic_energy, and to change the units to J/kg. — Reply to this email directly, view it on GitHub <#70>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AEIZ77A4N7FCS3G3ACYKEFDZHL7FHAVCNFSM6AAAAABJKP7OJCVHI2DSMVQWIX3LMV43ASLTON2WKOZSGM2TGNJUGI3TQNY> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[nusbaume]

@dudhia We discussed this at the CCPP framework meeting and landed on the word "specific" for two reasons:

1. It matches what is listed in the CF-conventions, as there is no turbulent_kinetic_energy, only specific_turbuent_kinetic_energy, and the conventions make a point that the word specific means "per unit mass".

2. We generally wanted to lean towards being more verbose in order to remove any chance of ambiguity. Since technically the SI unit for energy is J, we thought adding specific_ would make it clear to non-atmospheric scientists that the units should be J kg-1.

You do make a really good point though that other "energy" quantities are also per unit mass, and ideally it would be good to have the names of these quantities be consistent (e.g. they either all have specific_ or none of them do). I'll make it an agenda item for the next framework/standard names meeting to discuss it some more (although if people watching this repo have opinions then feel free to respond here on this issue as well).

[mkavulich]

@dudhia I agree that terms for which there is a standard use that implies specific quantities (such as CAPE) this renaming is not needed. This discussion is specifically (heh) about TKE. Doing some literature review (AKA googling "turbulent kinetic energy units") it seems like the standard usage implies "specific" units (energy per unit mass), so maybe this renaming is not necessary; just re-defining the units to J kg^-1 would be sufficient.

[nusbaume]

After discussing this at the CCPP-framework, we decided to keep the name as turbulent_kinetic_energy, but to change the units to J kg-1. I'll go ahead and remove the "name changing" label to make it clear that the standard name itself will remain the same.

[mkavulich]

Resolved by #129