| 30 | # Manage output using XIOS # |
| 31 | XIOS is used by default in v6 configurations. |
| 32 | |
| 33 | All files need by INCA model for manage outputs are in the directory INCA/src/INCA_XML/. In this directory you will find several types of files |
| 34 | * iodef.xml: Main input file for XIOS |
| 35 | * context_inca.xml: Axis and domain information, include field and file def |
| 36 | * field_def_inca.xml: Definition for each variable send from INCA |
| 37 | * file_def_inca.xml: Definition of all output files and there variables |
| 38 | |
| 39 | ## definition in file_def_inca ## |
| 40 | In fact there are two files of type `file_def_inca.xml` for each inca configuration (NMHC, NMHC_AER, etc.) (except for NMHC_AER_S that are using same files than NMHC_AER). |
| 41 | * file_def_inca_${chem}_daily.xml --> output files will have a daily frequency |
| 42 | * file_def_inca_${chem}_monthly.xml --> output files will have a monthly frequency |
| 43 | with chem={NMHC, NMHC_AER, AER, GES, DUSS} |
| 44 | [[BR]] |
| 45 | The choice between daily or monthly output frequency is manage by the card `config.card` of your simulation |
| 46 | {{{ |
| 47 | #======================================================================== |
| 48 | #D-- CHM - |
| 49 | [CHM] |
| 50 | #D-- choose inca writefrequency between 1D or 1M. it is not possible to cumulate both of them |
| 51 | #D-- you can also manage the writefrequency in INCA/src/INCA_XML/file_*.xml files |
| 52 | WriteFrequency="1D 1M" |
| 53 | }}} |
| 54 | [[BR]] |
| 55 | In files file_def_inca.xml you will find keywords '''AUTO''' |
| 56 | {{{ |
| 57 | <file id="forcage1" name="inca1d_forcage" output_freq="1d" enabled="_AUTO_"> |
| 58 | }}} |
| 59 | They are replaced automatically by the driver `inca.driver` of your simulation. Be careful if you define new outputs files, you need to put the correct value for the parameter '''enabled''', and not '''AUTO'''. (TRUE if you want to write this file in output, FALSE if not) |
| 60 | |
| 61 | ## groups in field_def_inca ## |
| 62 | Each configuration of Inca model NMHC, AER, etc.) has differents tracers from the other ones. For each tracers we want to write on output several diagnostics or values link with it (ex: concentration, emission, deposit velocity, etc.). To avoid to list all these possible output and forget one of them, we work with XIOS groups. For each family of output we create a group, and the code will interactively construct it with all tracers use by it. |
| 63 | {{{ |
| 64 | <field_group id="emi_species" /> <!-- species emissions --> |
| 65 | <field_group id="photo_rate" axis_ref="presnivs" /> <!-- rate of photolysis reaction --> |
| 66 | }}} |
| 67 | Then in the file_def_inca file we can ask to write a sublist (by listing variable one by one) or all the group |
| 68 | {{{ |
| 69 | <file id="emissions1" name="inca1d_emi" output_freq="1d" enabled=".TRUE."> |
| 70 | <field field_ref="Emi_O3" /> |
| 71 | <field field_ref="Emi_O" /> |
| 72 | <field field_ref="Emi_O1D" /> |
| 73 | <field field_ref="Emi_H" /> |
| 74 | <field field_ref="Emi_OH" /> |
| 75 | <field field_ref="Emi_HO2" /> |
| 76 | <field field_ref="Emi_H2O2" /> |
| 77 | <field field_ref="Emi_N2O" /> |
| 78 | </file> |
| 79 | }}} |
| 80 | |
| 81 | or |
| 82 | |
| 83 | {{{ |
| 84 | <file id="emissions1" name="inca1d_emi" output_freq="1d" enabled=".TRUE."> |
| 85 | <field_group group_ref="emi_species" /> |
| 86 | </file> |
| 87 | }}} |
| 88 | |
| 89 | To help the user to know all variables create by groups function, you create an output file ̀ inca_IDxml.out` we are stored all groups variables names. |
| 90 | |
| 91 | ## Output in CMIP6 ## |
| 92 | For CMIP6 we cannot use groups, we need to have the explicit list in field and file xml. For this you can use the file `inca_IDxml.out` describe previously, or use example stored in src/INCA_XML/CMIP6 directory. |