On this page we provide information about software modules that were completely or partially removed from GEOS-Chem.
Overview
We have removed several obsolete source code modules and files from GEOS-Chem v10-01 (and higher versions), as shown in the tables below. We were able to do this because:
- The
Input_Opt
, State_Met
, and State_Chm
derived type objects now carry many variables that were formerly stored in GEOS-Chem legacy modules.
- The addition of the HEMCO emissions component into GEOS-Chem v10-01 has rendered much of GEOS-Chem's legacy code obsolete.
- Removing obsolete modules and files will allow GEOS-Chem to more efficiently operate in High-Performance computing (HPC) environments, such as when we couple GEOS-Chem to the NASA GEOS-5 GCM.
- The FlexChem chemical solver package has allowed us to remove all legacy SMVGEAR code from GEOS-Chem v11-01 and higher versions.
Legend for the tables below:
COMPLETELY REMOVED
|
The module no longer exists in GEOS-Chem.
|
PARTIALLY REMOVED
|
The module still exists in GEOS-Chem, but much legacy code has been deleted from it.
|
SOME CONTENTS MERGED WITH ANOTHER MODULE
|
The module was removed from GEOS-Chem, but some variables or routines were merged into a different module for the sake of efficiency or clarity.
|
RENAMED
|
The module is still present in GEOS-Chem, but with a different filename than in prior versions.
|
--Bob Yantosca (talk) 16:26, 8 November 2016 (UTC)
Completely removed
The following files in Headers/ have been completely from GEOS-Chem v10-01 and higher versions:
Module(s)
|
StatusR
|
- Headers/CMN_mod.F
- Headers/CMN_NOX_mod.F
- Headers/smv_physconst_mod.F
|
COMPLETELY REMOVED.
|
|
COMPLETELY REMOVED; SOME CONTENTS MERGED WITH ANOTHER MODULE.
- Removed from: GEOS-Chem v10-01
- Reason: HEMCO has rendered everything obsolete in Headers/commsoil_mod.F except the following 3 arrays:
- DEP_RESERVOIR
- DRY_TOTN
- WET_TOTN
- These 3 arrays have now been added to module GeosCore/get_ndep_mod.F as PUBLIC module variables.
- NOTE: The ND49 timeseries diagnostics for soil NOx quantities are now broken. HEMCO keeps track of these quantities via its own diagnostic archiving system.
|
- Headers/gigc_input_opt_mod.F90
|
RENAMED.
- Removed from: GEOS-Chem v11-01g
- Reason: The "GIGC" (grid-independent GEOS-Chem) is now obsolete terminology. This module was renamed from gigc_input_opt_mod.F90 to simply input_opt_mod.F90.
|
- Headers/gigc_state_chm_mod.F90
|
RENAMED.
- Removed from: GEOS-Chem v11-01g
- Reason: The "GIGC" (grid-independent GEOS-Chem) is now obsolete terminology. This module was renamed from gigc_state_chm_mod.F90 to simply state_chm_mod.F90.
|
- Headers/gigc_state_met_mod.F90
|
RENAMED.
- Removed from: GEOS-Chem v11-01g
- Reason: The "GIGC" (grid-independent GEOS-Chem) is now obsolete terminology. This module was renamed from gigc_state_met_mod.F90 to simply state_met_mod.F90.
|
- Headers/gigc_state_phy_mod.F90
|
COMPLETELY REMOVED.
|
- Headers/smv_dimension_mod.F
|
COMPLETELY REMOVED; SOME CONTENTS MERGED WITH ANOTHER MODULE.
- Removed from: GEOS-Chem v10-01
- Reason: No longer needed. Some PARAMETER declarations from this module were moved to physconsts.F.
|
|
RENAMED.
|
- Headers/comode_loop_mod.F90
|
COMPLETELY REMOVED.
- Removed from: GEOS-Chem v11-01g
- Reason: This SMVGEAR-specific module was rendered obsolete by the new FlexChem implementation.
|
--Bob Yantosca (talk) 16:23, 8 November 2016 (UTC)
Partially removed
The following files in Headers/ have been partially removed from GEOS-Chem v10-01 and higher versions. These modules still exist in GEOS-Chem, but a significant amount of legacy code has been deleted from them.
Module(s)
|
Status
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v11-01g
- Reason: Removed obsolete code, including
- References to parameter NNPAR
- Obsolete PDxx parameters. These were used to dimension the various diagnostic arrays. But many diagnostics are now archived via HEMCO, thus rendering these obsolete.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v11-01g
- Reason: The following module variables were removed, as these were made obsolete by HEMCO:
- Integer variables: NEMPARA, NEMPARB, NOXLEVELS, NOXEXTENT
- Scale factor variables: TODH, TODN, TODB, SCNR89, FTOTCO2, FLIQCO2, FSCALYR
- Emissions arrays: EMISR, EMISRN, EMIST, EMISTN, EMISTNOX, EMISTETHE, EMISTCO, EMISTPRPE, EMISTC3H8, EMISTALK4, EMISTC2H6, EMISTSOX, EMISTACET, EMISTMEK, EMISTBENZ, EMISTTOLU, EMISTXYLE, EMISTC2H4, EMISTC2H2, EMISTNAP, EMISTNAP
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v11-01g
- Reason: The following module variables were removed, as these were made obsolete by HEMCO:
- Parameters: NEMPARA, NEMPARB, NOXLEVELS, NOXEXTENT
|
--Bob Yantosca (talk) 16:08, 21 July 2016 (UTC)
Modules removed from the GeosCore subdirectory
Completely removed
The following files in GeosCore/ have been completely removed from GEOS-Chem v10-01 and higher versions:
--Bob Yantosca (talk) 18:57, 20 July 2016 (UTC)
Partially removed
The following files in GeosCore/ have been partially removed from GEOS-Chem v10-01 and higher versions. These modules still exist in GEOS-Chem, but a significant amount of legacy code has been deleted from them.
Module(s)
|
Status
|
- GeosCore/aerosol_mod.F
- GeosCore/diag_pl_mod.F
- GeosCore/land_mercury_mod.F
- GeosCore/mercury_mod.F
- GeosCore/ocean_mercury_mod.F
|
PARTIALLY REMOVED.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: Dry deposition is now applied to carbon aerosol tracers in GeosCore/mixing_mod.F90. Therefore, we have removed the application of dry deposition (and the archiving of the ND44 drydep diagnostic) from the following routines. In some cases, these routines were significantly simplified:
- CHEM_BCPO, CHEM_BCPI, CHEM_OCPO, CHEM_OCPI
- Routine SOA_DEPO has been removed, as it is now obsolete.
|
- GeosCore/diag49_mod.F
- GeosCore/diag51_mod.F
- GeosCore/diag51b_mod.F
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: We had to disable certain timeseries diagnostics which are now archived by HEMCO. We need to think about how to introduce these as netCDF diagnostics.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v11-01g
- Reason: The prod/loss diagnostic is now handled by KPP and passed to GEOS-Chem in flexchem_mod.F90. The code for setting up and computing the ND65 diagnostic is no longer needed. We do still utilize much of the code for ND20 (O3 prod/loss), so code specific to ND20 has been moved to a new module GeosCore/diag20_mod.F.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: Dry deposition is now applied to sea salt aerosol tracers in GeosCore/mixing_mod.F90. Therefore, we have removed the following routines:
|
|
PARTIALLY REMOVED; SOME CONTENTS MERGED WITH ANOTHER MODULE.
- Modified in: GEOS-Chem v10-01
- Reason: The Ginoux dust source function is now implemented as a HEMCO extension.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: We no longer read the directory paths O3_PL_DIR and OH_DIR. The data contained in these paths are now read in via HEMCO.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: Several variables have now been replaced by fields of Input_Opt
- Module variable LINOZ_NLEVELS is now replaced by Input_Opt%LINOZ_NLEVELS.
- Module variable LINOZ_NLAT is now replaced by Input_Opt%LINOZ_NLAT.
- Module variable LINOZ_NMONTHS is now replaced by Input_Opt%LINOZ_NMONTHS.
- Module variable LINOZ_NFIELDS is now replaced by Input_Opt%LINOZ_NFIELDS.
- Module variable LINOZ_TPARM is now replaced by Input_Opt%LINOZ_TPARM.
|
|
PARTIALLY REMOVED.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: Dry deposition is now applied to sea salt aerosol tracers in GeosCore/mixing_mod.F90. Therefore, we have removed the following routines:
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason:
- The following module variables were removed, as these were made obsolete by HEMCO:
- Emissions arrays: ENH3_an, ENH3_bb, ENH3_bf, ENH3_na, ESO2_ac, ESO2_an, ESO2_ev, ESO2_nv, ESO2_bb, ESO2_bf, ESO2_sh, ESO4_an
- Dry deposition is now applied to sulfate aerosol tracers in GeosCore/mixing_mod.F90. Therefore, we have removed the application of dry deposition (and the archiving of the ND44 drydep diagnostic) from the following routines. In some cases, these routines were significantly simplified:
- CHEM_DMS, CHEM_SO2, CHEM_SO4, CHEM_MSA, CHEM_NIT
- CHEM_NH3 and CHEM_NH4 have been removed, as these are now obsolete.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: Dry deposition is now applied to tagged O3 tracers in GeosCore/mixing_mod.F90. Therefore, we have removed the application of dry deposition (and the archival of the ND44 dry deposition diagnostic) from the following routines:
|
|
MOSTLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason:
- The ITS_A_*_SIM functions are now replaced by fields of the Input_Opt derived-type object.
- N_TRACERS is now replaced by Input_Opt%N_TRACERS, and again later by State_Chm%nAdvect.
- Function GET_SIM_NAME has now been replaced by Input_Opt%SIM_NAME.
- The CHECK_STT* functions were left intact.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason:
- PBL routines are now called from GeosCore/mixing_mod.F90.
- We have removed all references to EMIS_SAVE, which used to pass emissions into the non-local PBL mixing routine.
|
|
PARTIALLY REMOVED.
- Modified in: GEOS-Chem v10-01
- Reason: The following module variables were removed, as these were made obsolete by HEMCO:
- Parameters MAXTRACERS
- Arrays: EMIS_SAVE
|
--Bob Yantosca (talk) 18:37, 20 July 2016 (UTC)
Modules removed from the GeosUtil subdirectory
The following files in GeosUtil/ have been completely or partially removed from GEOS-Chem v10-01 and higher versions:
Module(s)
|
Status
|
- GeosUtil/directory_mod.F
- GeosUtil/unix_cmds_mod.F
|
COMPLETELY REMOVED.
- Removed from: GEOS-Chem v10-01
- Reason: The data stored in these modules are now stored in the Input_Opt derived-type object.
|
- GeosUtil/global_grid_mod.F90
- GeosUtil/regrid_1x1_mod.F
|
COMPLETELY REMOVED.
|
|
MOSTLY UNUSED.
|
|
MOVED TO A DIFFERENT DIRECTORY.
- Removed from: GEOS-Chem v10-01
- Reason: This module has been moved to the NcdfUtil directory.
|
--Bob Yantosca (talk) 18:25, 21 July 2016 (UTC)
Modules that are on the chopping block
The following modules will be removed from GEOS-Chem shortly, once new software is integrated.
Module(s)
|
Status
|
- Headers/CMN_DIAG_mod.F
- GeosCore/diag03_mod.F
- GeosCore/diag04_mod.F
- GeosCore/diag1.F
- GeosCore/diag3.F
- GeosCore/diag41_mod.F
- GeosCore/diag42_mod.F
- GeosCore/diag48_mod.F
- GeosCore/diag49_mod.F
- GeosCore/diag50_mod.F
- GeosCore/diag51_mod.F
- GeosCore/diag51b_mod.F
- GeosCore/diag53_mod.F
- GeosCore/diag56_mod.F
- GeosCore/diag63_mod.F
- GeosCore/diag2pm_mod.F
- GeosCore/diagoh.F
- GeosCore/initialize.F
- GeosCore/ndxx_setup.F
- GeosCore/ohsave.F
- GeosUtil/bpch2_mod.F
- GeosUtil/hdf_mod.F
|
TO BE REPLACED BY netCDF DIAGNOSTICS
- These modules (which save diagnostic output to binary punch file format) will eventually be removed when we start converting GEOS-Chem's diagnostics to COARDS-compliant netCDF format.
- There will be a transition period when both binary punch and netCDF diagnostics will exist side-by-side. This will facilitate testing and debugging.
|
--Bob Yantosca (talk) 18:27, 21 July 2016 (UTC)