[MITgcm-devel] An overdue revision of some diagnostic variable names and their descriptions

[Jean-Michel Campin]

Hi Ian,

Any update that can improve/avoid confusion is welcome !

Changing some diagnostic descriptions is easy, we just need to agree on what
to put instead (and may be some consistency across diagnostic descriptions).

If you want also to change diagnostic names (e.g., "UVELMASS" --> ? ), it's 
a little bit more tricky since many users are now used to specify these (bad)
8-characters diagnostic names in their data.diagnostics, so the transition
might be a little painful.

And just to bring an historical perspective, "UVELMASS", "VVELMASS" names
and description were added early on (Mars 11, 2004); from an atmospheric
point of view, using pressure coordinate, the "mass weighted" makes more 
sense (hFac capture the time-dependence of the grid-box mass content).

Cheers,
Jean-Michel

On Tue, Jan 16, 2018 at 07:02:30PM +0000, Fenty, Ian G (329C) wrote:
> Hi MITgcm devel,
> 
> In an effort to make our output more comprehensible to outsiders I think we should consider updating the names of some of our diagnostic output descriptions.
> 
> First, terms such as UVELMASS and UTHMASS are not ???Zonal components of velocity???, they are the component of velocity in the model grid???s ???x??? direction.  In the LLC tiles, 6 of the 13 tiles (or 2 of 5 faces) are rotated by 90 degrees so that flow in the ???+x??? direction is actually negative quasi-meridional.  Moreover, with the Arctic Cap tile 7 (face 3) flow in the positive ???x??? direction is eastward along its bottom edge (first row) and westward along its upper edge (last row).   A similar story applies for flow in the +y direction.  So, can we change these names to reflect the fact that ???u??? and ???v??? are defined not by the compass but by the local orientation of the curvilinear grid?
> 
> Second, the name ???MASS??? and the description ???Mass-Weighted??? is also somewhat misleading because these terms are not weighted by mass at all, but by hFac.  Perhaps a more descriptive term would be ???Geometry-Weighted??? or some other name that reflects the possible non-unity value of hFac?
> 
> This topic has come up many times since we???ve adopted the LLC grids for the ECCO Central Production and other projects.  I???d like to see this sorted out to reduce the confusion that seems to hit everybody encountering these variables for the first time.
> 
> 
>   *   Ian
> 
> 
> 
> 45 |UVELMASS| 50 |    46 |UUr     MR|m/s             |Zonal Mass-Weighted Comp of Velocity (m/s)
> 
> 46 |VVELMASS| 50 |    45 |VVr     MR|m/s             |Meridional Mass-Weighted Comp of Velocity (m/s)
> 
> 
> 50 |UTHMASS | 50 |    51 |UUr     MR|degC.m/s        |Zonal Mass-Weight Transp of Pot Temp
> 51 |VTHMASS | 50 |    50 |VVr     MR|degC.m/s        |Meridional Mass-Weight Transp of Pot Temp
> 

> _______________________________________________
> MITgcm-devel mailing list
> MITgcm-devel at mitgcm.org
> http://mailman.mitgcm.org/mailman/listinfo/mitgcm-devel