Metadata-Version: 2.1
Name: hermesv3-gr
Version: 2.0.2
Summary: HERMESv3 Global/Regional
Home-page: https://earth.bsc.es/gitlab/es/hermesv3_gr
Author: Carles Tena Medina
Author-email: carles.tena@bsc.es
License: GNU GPL v3
Description: # Hermesv3_gr for TM5MP @ Aether
        
        <sup><sup> Updated on 27.02.2023
        
        The original README file from the upstream hermesv3_gr repository at [https://earth.bsc.es/gitlab/es/hermesv3_gr](https://earth.bsc.es/gitlab/es/hermesv3_gr) has been renamed README.orig.
        
        ## Introduction
        
        HERMES was added to be used with the CTM TM5MP. For this some details compared to the original HERMES were changed:
        
        - grid: HERMES now contains a new grid called tm5_global. Compared to the original global the border grid cells are full cells not half cells.
        - logs: To enable simultaneous running of multiple sectors the log files were slightly renamed
        - profiles: To match the mCB05 Speciation in TM5 a new Speciation file was created, please check the corresponding readme for more information
        - regridding: The Regridding was changed to match the tm5 regridding, TM5 regridding is only used in TM5 cases
        - models: TM5MP is now model to be selected in hermes.conf
        - preprocessors: For running HERMES for TM5MP many inventories were added, with corresponding preprocessors. These should be universal and usable also for WRF-CHEM.
        
        ## Usage
        
        To use HERMES with TM5MP (and the other way around) one has first to make sure, that TM5MP is reading HERMES data instead of the original inventory data.
        Since TM5 reads the emission data sector-wise the user has to create on HERMES file per Sector. The Naming has to follow: `HERMESv3_INVENTORY_SECTOR_DATE.nc`.
        To simplify things two scripts (`split_into_multi_runs_new.py` and `run_hermes_single_runs.sh`) were created.
        `run_hermes_single_runs.sh` reads an `EI_configuration.csv` and created one file per sector. Also corresponding `hermes.conf` files are created.
        Using the run script all runs are started automatically after each other.
        
        Run example case:
        
        1. Make sure `EI_configuration_example.csv` and `hermes_example.csv` exist, edit paths if needed
        2. `module load conda/hermesv3_gr` to load a python enviroment suitable for hermes
        3. `srun python split_into_multi_runs_new.py` to split Files by sector
        4. edit `run_hermes_single_runs.sh` to read the just created files
        5. `srun run_hermes_single_runs.sh` to run all files in the given directory
        
        
        ### hermes.conf
        
        The `hermes.conf` was slightly edited compared to the original.
        
        - `output_model` now also takes `TM5MP`
        - `domain_type` has to be set to `global_tm5` for use with tm5
        - The output resolution is given with `inc_lat` and `inc_lon` these can we used from the former global section
        - The `gph_data_path` gives the gph data from tm5 for vertical regridding (not supported by tm5 currently)
        - The `meteo_data_path` ...
        
        ## Installation
        
        To use HERMES on Aether is first has to be cloned and afterwards installed.
        Step 1: load conda module lamos 2020.1 with `module load conda/lamos_2020.1`
        Step 2: go into the just cloned HERMES directory
        Step 3: install HERMES using `python setup.py install --user --record files.txt`
        
        Info: the created records file `files.txt` creates a list of created python files, this list is needed to simply remove those later if needed
        
        ## Uninstal
        
        If you want to uninstall HERMES again you simple use `xargs rm -rf < files.txt`, while files.txt is the file created in the installation.
        
Keywords: emissions,cmaq,monarch,wrf-chem,atmospheric composition,air quality,earth science
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Description-Content-Type: text/markdown
