Using the SatSim Gridded Component: Difference between revisions
No edit summary |
|||
| Line 15: | Line 15: | ||
src/GEOSgcs_GridComp/GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSradiation_GridComp/GEOSsatsim_GridComp | src/GEOSgcs_GridComp/GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSradiation_GridComp/GEOSsatsim_GridComp | ||
The other files in this directory are provided with COSP | The other files in this directory are provided with COSP. Necessary bugfixes and updates have been applied since the Foruna-2_3_p1 tag, so you should update the directory by cding to it and entering | ||
cvs upd -r afe_F2_4_U_satsimdev_20110131 | |||
before compiling. | |||
== Sample Collections for HISTORY.rc == | == Sample Collections for HISTORY.rc == | ||
Revision as of 13:38, 31 January 2011
This page describes how to use the SatSim gridded component, which implements the CFMIP observational simulator package (COSP). This package simulates the cloud observations from the satellite instruments CloudSat, CALIPSO, and PARASOL, and the International Satellite Cloud Climatology Project (ISCCP). The SatSim gridded component is compiled by default into Fortuna 2.3.
Setting Up SatSim
SatSim is turned on by including the following line in the AGCM.rc file at runtime:
USE_SATSIM: 1
To produce output from SatSim you will need to provide data collections in your run's HISTORY.rc file. Samples are provided below. The collections as provided are very storage-intensive: the isccp, lidar and radar collections produce 112M, 616M and 718M per model day; otherwise the largest default collection is prog at 100M every model day. This is due to the many 3D global fields in lidar and radar, and more than fifty 2D fields in isccp.
Compile-Time Options
The SatSim gridded component is located in file GEOS_SatsimGridComp.F90 in the following sub-directory of the GEOS-5 build:
src/GEOSgcs_GridComp/GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSradiation_GridComp/GEOSsatsim_GridComp
The other files in this directory are provided with COSP. Necessary bugfixes and updates have been applied since the Foruna-2_3_p1 tag, so you should update the directory by cding to it and entering
cvs upd -r afe_F2_4_U_satsimdev_20110131
before compiling.
Sample Collections for HISTORY.rc
The following are sample collections that can be cut and pasted into your HISTORY.rc. Don't forget to add the appropriate lines to the COLLECTIONS: section
'geosgcm_lidar'
'geosgcm_radar'
'geosgcm_isccp'
The following are exports from the lidar routine, which simulates data from the CALIPSO and PARASOL satellites. As with all of the collections here, effort has been made to conform to the fields and short names specified in the CFMIP documents. The exports with names beginning respectively with CALIPSOSRCFAD and PARASOLREFL and ending with a number are not CFMIP-compliant as they are supposed to be single multidimensional fields. This is due to limitations that GEOS-5 places on the structure of exports. Exports from the Moist gridded component are provided for comparison and diagnostics.
geosgcm_lidar.template: '%y4%m2%d2_%h2%n2z.nc4',
geosgcm_lidar.archive: '%c/Y%y4',
geosgcm_lidar.format: 'CFIO',
geosgcm_lidar.mode: 'time-averaged',
geosgcm_lidar.frequency: 030000,
geosgcm_lidar.ref_time: 210000,
geosgcm_lidar.fields: 'LIDARPMOL' , 'SATSIM' ,
'LIDARPTOT' , 'SATSIM' ,
'LIDARTAUTOT' , 'SATSIM' ,
'CLLS' , 'MOIST' ,
'FCLD' , 'MOIST' ,
'CLCALIPSO2' , 'SATSIM' ,
'CLLCALIPSO' , 'SATSIM' ,
'CLMCALIPSO' , 'SATSIM' ,
'CLHCALIPSO' , 'SATSIM' ,
'CLTCALIPSO' , 'SATSIM' ,
'PARASOLREFL1' , 'SATSIM' ,
'PARASOLREFL2' , 'SATSIM' ,
'PARASOLREFL3' , 'SATSIM' ,
'PARASOLREFL4' , 'SATSIM' ,
'PARASOLREFL5' , 'SATSIM' ,
'CALIPSOSRCFAD01' , 'SATSIM' ,
'CALIPSOSRCFAD02' , 'SATSIM' ,
'CALIPSOSRCFAD03' , 'SATSIM' ,
'CALIPSOSRCFAD04' , 'SATSIM' ,
'CALIPSOSRCFAD05' , 'SATSIM' ,
'CALIPSOSRCFAD06' , 'SATSIM' ,
'CALIPSOSRCFAD07' , 'SATSIM' ,
'CALIPSOSRCFAD08' , 'SATSIM' ,
'CALIPSOSRCFAD09' , 'SATSIM' ,
'CALIPSOSRCFAD10' , 'SATSIM' ,
'CALIPSOSRCFAD11' , 'SATSIM' ,
'CALIPSOSRCFAD12' , 'SATSIM' ,
'CALIPSOSRCFAD13' , 'SATSIM' ,
'CALIPSOSRCFAD14' , 'SATSIM' ,
'CALIPSOSRCFAD15' , 'SATSIM' ,
::
The following provides exports from the radar routine which simulates CloudSat data. The numbered export fields with names beginning with CLOUDSATCFAD are not CFMIP-compliant for the same reasons as those in the lidar collection.
geosgcm_radar.template: '%y4%m2%d2_%h2%n2z.nc4',
geosgcm_radar.archive: '%c/Y%y4',
geosgcm_radar.format: 'CFIO',
geosgcm_radar.mode: 'time-averaged',
geosgcm_radar.frequency: 030000,
geosgcm_radar.ref_time: 210000,
geosgcm_radar.fields: 'RADARLTCC' , 'SATSIM' ,
'RADARZETOT' , 'SATSIM' ,
'CLCALIPSO2' , 'SATSIM' ,
'CLCALIPSO' , 'SATSIM' ,
'CLOUDSATCFAD01' , 'SATSIM' ,
'CLOUDSATCFAD02' , 'SATSIM' ,
'CLOUDSATCFAD03' , 'SATSIM' ,
'CLOUDSATCFAD04' , 'SATSIM' ,
'CLOUDSATCFAD05' , 'SATSIM' ,
'CLOUDSATCFAD06' , 'SATSIM' ,
'CLOUDSATCFAD07' , 'SATSIM' ,
'CLOUDSATCFAD08' , 'SATSIM' ,
'CLOUDSATCFAD09' , 'SATSIM' ,
'CLOUDSATCFAD10' , 'SATSIM' ,
'CLOUDSATCFAD11' , 'SATSIM' ,
'CLOUDSATCFAD12' , 'SATSIM' ,
'CLOUDSATCFAD13' , 'SATSIM' ,
'CLOUDSATCFAD14' , 'SATSIM' ,
'CLOUDSATCFAD15' , 'SATSIM' ,
'CLLS' , 'MOIST' ,
'FCLD' , 'MOIST' ,
'QLLS' , 'MOIST' ,
'QILS' , 'MOIST' ,
'RI' , 'MOIST' , 'RDFI' ,
'RL' , 'MOIST' , 'RDFL' ,
'SGFCLD' , 'SATSIM' ,
::
The following collection provides the fields from the icarus (ISCPP) routine. The CFMIP documents stipulate that ISCCP output be in a 7x7 matrix of 2D fields; these fields are broken out individually here in the exports with names that start with ISCCP. The rest of the names follow the codes outlined in the ISCCP routines for cloud type and then height (for that cloud type, increasing with U/M/O) and optical depth (A/B).
geosgcm_isccp.template: '%y4%m2%d2_%h2%n2z.nc4',
geosgcm_isccp.archive: '%c/Y%y4',
geosgcm_isccp.format: 'CFIO',
geosgcm_isccp.mode: 'time-averaged',
geosgcm_isccp.frequency: 030000,
geosgcm_isccp.ref_time: 210000,
geosgcm_isccp.fields: 'SGFCLD' , 'SATSIM' ,
'TCLISCCP' , 'SATSIM' ,
'ISCCP_CU_OA' , 'SATSIM' ,
'ISCCP_CU_OB' , 'SATSIM' ,
'ISCCP_CU_UA' , 'SATSIM' ,
'ISCCP_CU_UB' , 'SATSIM' ,
'ISCCP_STCU_OA' , 'SATSIM' ,
'ISCCP_STCU_OB' , 'SATSIM' ,
'ISCCP_STCU_UA' , 'SATSIM' ,
'ISCCP_STCU_UB' , 'SATSIM' ,
'ISCCP_ST_OA' , 'SATSIM' ,
'ISCCP_ST_OB' , 'SATSIM' ,
'ISCCP_ST_UA' , 'SATSIM' ,
'ISCCP_ST_UB' , 'SATSIM' ,
'ISCCP_ACU_OA' , 'SATSIM' ,
'ISCCP_ACU_OB' , 'SATSIM' ,
'ISCCP_ACU_UA' , 'SATSIM' ,
'ISCCP_ACU_UB' , 'SATSIM' ,
'ISCCP_AST_OA' , 'SATSIM' ,
'ISCCP_AST_OB' , 'SATSIM' ,
'ISCCP_AST_UA' , 'SATSIM' ,
'ISCCP_AST_UB' , 'SATSIM' ,
'ISCCP_NST_OA' , 'SATSIM' ,
'ISCCP_NST_OB' , 'SATSIM' ,
'ISCCP_NST_UA' , 'SATSIM' ,
'ISCCP_NST_UB' , 'SATSIM' ,
'ISCCP_CI_OA' , 'SATSIM' ,
'ISCCP_CI_OB' , 'SATSIM' ,
'ISCCP_CI_MA' , 'SATSIM' ,
'ISCCP_CI_MB' , 'SATSIM' ,
'ISCCP_CI_UA' , 'SATSIM' ,
'ISCCP_CI_UB' , 'SATSIM' ,
'ISCCP_CIST_OA' , 'SATSIM' ,
'ISCCP_CIST_OB' , 'SATSIM' ,
'ISCCP_CIST_MA' , 'SATSIM' ,
'ISCCP_CIST_MB' , 'SATSIM' ,
'ISCCP_CIST_UA' , 'SATSIM' ,
'ISCCP_CIST_UB' , 'SATSIM' ,
'ISCCP_CB_OA' , 'SATSIM' ,
'ISCCP_CB_OB' , 'SATSIM' ,
'ISCCP_CB_MA' , 'SATSIM' ,
'ISCCP_CB_MB' , 'SATSIM' ,
'ISCCP_CB_UA' , 'SATSIM' ,
'ISCCP_CB_UB' , 'SATSIM' ,
'ISCCP_SUBV1' , 'SATSIM' ,
'ISCCP_SUBV2' , 'SATSIM' ,
'ISCCP_SUBV3' , 'SATSIM' ,
'ISCCP_SUBV4' , 'SATSIM' ,
'ISCCP_SUBV5' , 'SATSIM' ,
'ISCCP_SUBV6' , 'SATSIM' ,
'ISCCP_SUBV7' , 'SATSIM' ,
'CLLS' , 'MOIST' ,
'FCLD' , 'MOIST' ,
::