Open ccarouge opened 2 months ago
Currently the appended BIOS ancillary variables in the BIOS gridinfo don't contain attributes that are particularly helpful, for example:
float rhosoil(latitude, longitude) ;
rhosoil:long_name = "GDAL Band Number 1" ;
rhosoil:_FillValue = -9999.f ;
rhosoil:grid_mapping = "crs" ;
We should at least add a suitable long_name
and units
attribute for the BIOS ancillary variables.
@har917 what information do you want to convey in the global attributes in the BIOS gridinfo with regards to provenance? I can add these to the regridding script used for generating the BIOS gridinfo file.
Also if you have knowledge of the relevant units
and/or long_name
for the BIOS ancillary variables I can add these as well
@SeanBryan51
Information to go in the global attributes (may need fine editing)
The units [in ()] and long name should follow the existing information in the gridinfo - however if that's not available then we can include
Here are the attributes in the original gridinfo file (gridinfo_CSIRO_CRU05x05_4tiles.nc
) for the appended BIOS variables:
BIOS Variable | long_name |
units |
---|---|---|
silt |
UM soil texture - silt fraction | unknow |
clay |
UM soil texture - clay fraction | unknow |
sand |
UM soil texture - sand fraction | unknow |
css |
Soi specific heat capacity | J/kg/K |
sfc |
VOL SMC AT CRIT PT | unknow |
rhosoil |
SOIL BULK DENSITY | kg/m^3 |
bch |
CLAPP-HORNBERGER B COEFFICIENT | unknow |
hyds |
SAT SOIL CONDUCTIVITY | m/s |
ssat |
VOL SMC AT SATURATOIN | unknow |
swilt |
VOL SMC AT WILTING | unknow |
sucs |
SATURATED SOIL WATER SUCTION | m |
mvg |
||
c4frac |
||
modis_igbp |
||
avgannmax_fapar |
Let me know if you are happy (or unhappy) with these attributes. Note: you did not specify attributes for the sand
and css
variables- let me know if these attributes should change.
I will also need the attributes for variables mvg
, c4frac
, modis_igbp
and avgannmax_fapar
as these were not in the original gridinfo file.
@SeanBryan51
Some points - the sand
layer is not used (by any configuration of CABLE as far as I know) since this is evaluated from the silt
and clay
variables. So there is a question as to whether it should be in there or not.
The silt
, clay
and sand
variables are dimensionless (not unknown) - in effect they are fractions.
The units of the sfc
, ssat
and swilt
variables are 'm^3 water / m^3 soil' - I would expand 'VOL SMC' to 'volumetric soil moisture content.
Apologies - yes the dimensions for css
are correct. Minor typos in that it's 'soil specific heat capacity' and `VOL SMC AT SATURATION'
I will need to dig out additional information for the other variables (including sources). Long name and units are
mvg
: NVIS major vegetation group (categorical)
c4frac
: fractional cover of C4 grass (dimensionless)
modis_igbp
: IGBP biome (categorical)
avgannmax_fapar
: average-annual maximum value for FAPAR (dimensionless)
@har97 here are the proposed changes to BIOS variable attributes:
BIOS Variable | long_name (before) |
long_name (after) |
units (before) |
units (after) |
---|---|---|---|---|
silt |
UM soil texture - silt fraction | Silt fraction of soil matrix | unknow | 1 |
clay |
UM soil texture - clay fraction | Clay fraction of soil matrix | unknow | 1 |
sand |
UM soil texture - sand fraction | Sand fraction of soil matrix | unknow | 1 |
css |
Soi specific heat capacity | Soil specific heat capacity | J/kg/K | Unchanged |
sfc |
VOL SMC AT CRIT PT | Volumetric soil moisture content at critical point | unknow | m3 m-3 |
rhosoil |
SOIL BULK DENSITY | Soil bulk density | kg/m^3 | Unchanged |
bch |
CLAPP-HORNBERGER B COEFFICIENT | Clapp-Hornberger b coefficient | unknow | 1 |
hyds |
SAT SOIL CONDUCTIVITY | Hydraulic conductivity of soil at saturation | m/s | Unchanged |
ssat |
VOL SMC AT SATURATOIN | Volumetric soil moisture content at saturation | unknow | 1 |
swilt |
VOL SMC AT WILTING | Volumetric soil moisture content at wilting | unknow | 1 |
sucs |
SATURATED SOIL WATER SUCTION | Soil suction at saturation | m | Unchanged |
mvg |
NVIS major vegetation group | |||
c4frac |
Fractional cover of C4 grass | 1 | ||
modis_igbp |
IGBP biome | |||
avgannmax_fapar |
Average-annual maximum value for FAPAR | 1 |
Some reasons/proposals regarding the above changes:
silt
, clay
and sand
variables as the UM is not relevant in the context of BIOS ancillaries.sand
variable for now for backwards compatibility.1
for dimensionless variables as per the cf-conventions.mvg
, and modis_igbp
can be self describing using the flags_*
attributes (see cf-conventions#flags). Is this of interest?Great to see units going into the variable attributes!
Is it possible to also add the version numbers to the NVIS and MODIS vegetation classifications? I'm not sure what they are, but @har917 may.
From: Sean Bryan @.> Sent: Wednesday, 25 September 2024 14:50 To: CABLE-LSM/CABLE @.> Cc: Subscribed @.***> Subject: Re: [CABLE-LSM/CABLE] Add provenance information about BIOS ancillaries (Issue #406)
@har97https://github.com/har97 here are the proposed changes to BIOS variable attributes:
BIOS Variable long_name (before) long_name (after) units (before) units (after) silt UM soil texture - silt fraction Silt fraction of soil matrix unknow 1 clay UM soil texture - clay fraction Clay fraction of soil matrix unknow 1 sand UM soil texture - sand fraction Sand fraction of soil matrix unknow 1 css Soi specific heat capacity Soil specific heat capacity J/kg/K Unchanged sfc VOL SMC AT CRIT PT Volumetric soil moisture content at critical point unknow m3 m-3 rhosoil SOIL BULK DENSITY Soil bulk density kg/m^3 Unchanged bch CLAPP-HORNBERGER B COEFFICIENT Clapp-Hornberger b coefficient unknow 1 hyds SAT SOIL CONDUCTIVITY Hydraulic conductivity of soil at saturation m/s Unchanged ssat VOL SMC AT SATURATOIN Volumetric soil moisture content at saturation unknow 1 swilt VOL SMC AT WILTING Volumetric soil moisture content at wilting unknow 1 sucs SATURATED SOIL WATER SUCTION Soil suction at saturation m Unchanged mvg NVIS major vegetation group c4frac Fractional cover of C4 grass 1 modis_igbp IGBP biome avgannmax_fapar Average-annual maximum value for FAPAR 1
Some reasons/proposals regarding the above changes:
— Reply to this email directly, view it on GitHubhttps://github.com/CABLE-LSM/CABLE/issues/406#issuecomment-2372951802, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AIL5VYWNYHZXAFQJTLK624TZYI6KBAVCNFSM6AAAAABOXM6HFOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDGNZSHE2TCOBQGI. You are receiving this because you are subscribed to this thread.Message ID: @.***>
Decided to remove MODIS from the GridInfo file as it is just for BLAZE. Can we add provenence (ie. data source and version ) into the global attributes?
Require version for NVIS major vegetation group classification to add to global attributes - potentially investigate use of flags_*
attributes to self describe the data
Quick updates:
long_name
I would retain the ones that are in the current default gridinfo file (with the possible exception of the layer that we had to change the sign of)
Add information to the global attributes of the gridinfo and add variable attributes were needed.