PCMDI / obs4MIPs-cmor-tables

JSON Tables for CMOR3 to create obs4MIPs datasets
Other
6 stars 3 forks source link

What is the meaning of the 'satellite_blended' source type? #98

Closed JimBiardCics closed 6 years ago

JimBiardCics commented 6 years ago

@durack1 @gleckler1 What is the meaning of the 'satellite_blended' source type? Is it satellite blended with in-situ, or a blend retrievals from multiple satellites, either, or something else?

gleckler1 commented 6 years ago

@JimBiardCics Great question. I would say "either", AND possibly "something else", including blended with reanalysis. Adding this one (source_type options) to be discussed with task team. For now you can deal with the loose definition as you see fit. Thanks for bringing it up!

durack1 commented 6 years ago

@gleckler1 this info should be added as to the table notes in the ODS-2.1 document - it's a good thin to clarify

durack1 commented 6 years ago

@gleckler1 in addition to augmenting the ODS-2.1 document, it would also be good to pad out the CVs, we should convert the current obs4MIPs_source_type.json to reflect the

{
    "source_type":[
        "gridded_insitu",
        "reanalysis",
        "satellite_blended",
        "satellite_retrieval"
    ]
}

Would become something more like the CMIP6_source_type.json:

{
    "source_type":{
        "AER":"aerosol treatment in an atmospheric model where concentrations are calculated based on emissions, transformation, and removal processes (rather than being prescribed or omitted entirely)",
        "AGCM":"atmospheric general circulation model run with prescribed ocean surface conditions and usually a model of the land surface",
        "AOGCM":"coupled atmosphere-ocean global climate model, additionally including explicit representation of at least the land and sea ice",
        "BGC":"biogeochemistry model component that at the very least accounts for carbon reservoirs and fluxes in the atmosphere, terrestrial biosphere, and ocean",
        "CHEM":"chemistry treatment in an atmospheric model that calculates atmospheric oxidant concentrations (including at least ozone), rather than prescribing them",
        "ISM":"ice-sheet model that includes ice-flow",
        "LAND":"land model run uncoupled from the atmosphere",
        "OGCM":"ocean general circulation model run uncoupled from an AGCM but, usually including a sea-ice model",
        "RAD":"radiation component of an atmospheric model run 'offline'",
        "SLAB":"slab-ocean used with an AGCM in representing the atmosphere-ocean coupled system"
    },
    "version_metadata":{
        "author":"Paul J. Durack <durack1@llnl.gov>",
        "creation_date":"Tue Sep 26 13:21:14 2017 -0700",
        "institution_id":"PCMDI",
        "latest_tag_point":"note: ",
        "note":"Issue410 durack1 register source_id MRI-AGCM-3-2 (#412)",
        "previous_commit":"6b58df0a827f0abb5f038a1a84759fcb071ea706"
    }
}
durack1 commented 6 years ago

@JimBiardCics @taylor13 @gleckler1 to resolve this I propose the following:

{
    "source_type":{
        "gridded_insitu":"generated from measurements collected from in-situ profiles or site observations",
        "reanalysis":"generated from model reanalysis that assimilated in-situ profiles or site observations",
        "satellite_blended":"generated from measurements collected from in-situ profiles or site observations along with satellite platform radiances",
        "satellite_retrieval":"product generated from satellite platform radiances"
    }
}

Any comments, tweaks, suggestions?

taylor13 commented 6 years ago

This should be checked by someone more familiar with obs than I, but I suggest:

{
    "source_type":{
        "gridded_insitu":"gridded product based on measurements collected from in-situ instruments",
        "reanalysis":"gridded product generated from a model reanalysis based on in-situ instruments and possibly satellite-sensed irradiances",
        "satellite_blended":"gridded product based on both in-situ instruments and satellite-sensed irradiances",
        "satellite_retrieval":"gridded product based on satellite-sensed irradiances"
    }
}

Are we limiting these terms to gridded products, as I've indicated above?

JimBiardCics commented 6 years ago

I like it overall. I think we might ought to avoid the use of the word 'irradiances', in that there are satellite measurements that aren't based on irradiances. Perhaps just the word measurements, so 'satellite-sensed measurements'.

durack1 commented 6 years ago

@JimBiardCics yep sure, so the update is:

{
    "source_type":{
        "gridded_insitu":"gridded product based on measurements collected from in-situ instruments",
        "reanalysis":"gridded product generated from a model reanalysis based on in-situ instruments and possibly satellite-sensed measurements",
        "satellite_blended":"gridded product based on both in-situ instruments and satellite-sensed measurements",
        "satellite_retrieval":"gridded product based on satellite-sensed measurements"
    }
}
gleckler1 commented 6 years ago

I think this is good.

taylor13 commented 6 years ago

I would replace "satellite-sensed measurements" with either

"satellite measurements" or "measurements from satellite instruments". or "measurements collected from satellite instruments"

durack1 commented 6 years ago

Ok and so now we're at:

{
    "source_type":{
        "gridded_insitu":"gridded product based on measurements collected from in-situ instruments",
        "reanalysis":"gridded product generated from a model reanalysis based on in-situ instruments and possibly satellite measurements",
        "satellite_blended":"gridded product based on both in-situ instruments and satellite measurements",
        "satellite_retrieval":"gridded product based on satellite measurements"
    }
}
durack1 commented 6 years ago

These source_type entries are now in place, and I have confirmed that the format change doesn't impact CMOR 3.2.8:

netcdf prw_mon_REMSS-PRW-6-6-0_BE_gn_198701-198812 {
dimensions:
    time = UNLIMITED ; // (24 currently)
    lat = 72 ;
    lon = 144 ;
    bnds = 2 ;
variables:
    double time(time) ;
        time:bounds = "time_bnds" ;
        time:units = "days since 1987-1-1 0:0:0" ;
        time:calendar = "gregorian" ;
        time:axis = "T" ;
        time:long_name = "time" ;
        time:standard_name = "time" ;
    double time_bnds(time, bnds) ;
    double lat(lat) ;
        lat:bounds = "lat_bnds" ;
        lat:units = "degrees_north" ;
        lat:axis = "Y" ;
        lat:long_name = "latitude" ;
        lat:standard_name = "latitude" ;
    double lat_bnds(lat, bnds) ;
    double lon(lon) ;
        lon:bounds = "lon_bnds" ;
        lon:units = "degrees_east" ;
        lon:axis = "X" ;
        lon:long_name = "longitude" ;
        lon:standard_name = "longitude" ;
    double lon_bnds(lon, bnds) ;
    float prw(time, lat, lon) ;
        prw:standard_name = "atmosphere_water_vapor_content" ;
        prw:long_name = "Water Vapor Path" ;
        prw:comment = "vertically integrated through the atmospheric column" ;
        prw:units = "kg m-2" ;
        prw:cell_methods = "area: time: mean" ;
        prw:missing_value = 1.e+20f ;
        prw:_FillValue = 1.e+20f ;
        prw:valid_min = 2.f ;
        prw:valid_max = 3.f ;

// global attributes:
        :Conventions = "CF-1.7 ODS-2.1" ;
        :activity_id = "obs4MIPs" ;
        :contact = "RSS (support@remss.com)" ;
        :creation_date = "2017-11-09T20:45:55Z" ;
        :data_specs_version = "2.1.0" ;
        :frequency = "mon" ;
        :further_info_url = "https://furtherinfo.es-doc.org/obs4MIPs.RSS.REMSS-PRW.REMSS-PRW-6-6-0.prw" ;
        :grid = "2.5x2.5 degree latitude x longitude" ;
        :grid_label = "gn" ;
        :history = "2017-11-09T20:45:55Z; CMOR rewrote data to be consistent with obs4MIPs, and CF-1.7 ODS-2.1 standards" ;
        :institution = "Remote Sensing Systems, Santa Rosa, CA 95401, USA" ;
        :institution_id = "RSS" ;
        :nominal_resolution = "250 km" ;
        :product = "observations" ;
        :realm = "atmos" ;
        :region = "global" ;
        :source = "REMSS-PRW 6.6.0 (2017): Water Vapor Path" ;
        :source_id = "REMSS-PRW-6-6-0" ;
        :source_label = "REMSS-PRW" ;
        :source_type = "satellite_blended" ;
        :source_version_number = "6.6.0" ;
        :table_id = "obs4MIPs_Amon" ;
        :table_info = "Creation Date:(09 November 2017) MD5:bad75686b38de27b7b2272439f53da96" ;
        :title = "PRW v6.6.0 prepared for obs4MIPs (ODS-v2.1.0)" ;
        :tracking_id = "hdl:21.14102/1e72a1b4-b333-4bce-b949-75cf7dd287a6" ;
        :variable_id = "prw" ;
        :variant_info = "Best Estimate" ;
        :variant_label = "BE" ;
        :license = "Data in this file produced by <Your Centre Name> is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License (https://creativecommons.org/licenses/). Use of the data must be acknowledged following guidelines found at <a URL maintained by you>. Further information about this data, including some limitations, can be found via <some URL maintained by you>" ;
        :cmor_version = "3.2.8" ;
}