Using the SatSim Gridded Component
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. 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
Sample Collections for HISTORY.rc
'geosgcm_lidar'
'geosgcm_radar'
'geosgcm_isccp'
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' ,
::
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' ,
::
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' ,
::