The traceur.def Input File - Revision history

Milcareck: /* Initialisation */

2026-02-24T11:15:19Z

‎Initialisation

Milcareck: /* In 3D */

2026-02-24T11:14:15Z

‎In 3D

Milcareck: /* In 1D */

2026-02-24T11:13:24Z

‎In 1D

Milcareck: /* In 3D */

2026-02-24T11:08:52Z

‎In 3D

Milcareck: /* In 3D */

2026-02-24T11:07:18Z

‎In 3D

Milcareck: /* In 3D */

2026-02-24T11:06:56Z

‎In 3D

Milcareck at 14:00, 21 January 2026

2026-01-21T14:00:09Z

Aurelien.falco at 09:51, 5 March 2025

2025-03-05T09:51:59Z

SandrineSaturne: /* In 1D */

2024-09-18T13:59:26Z

‎In 1D

SandrineSaturne at 13:32, 18 September 2024

2024-09-18T13:32:14Z

← Older revision		Revision as of 11:15, 24 February 2026
Line 148:		Line 148:

	== Initialisation ==		== Initialisation ==
−
−	~~[In development 21/01/2026]~~

	=== In 3D ===		=== In 3D ===

@@ Line 157: / Line 157: @@
 <ul>
    <li>For the first method, you can choose between initialising to a constant ('''q=x''') or to a profile ('''q=profile'''). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the constant value (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify. The values must be in '''kg/kg'''.</li>
-   <li>For the second method, by using the option '''chemistry_ini''', the newstart read the traceur.def file. With '''qx=...''', you initialise to a constant value and with '''qxf=profile_<tracer name>''', you initialise to a profile. The values must be in '''mol/mol'''.</li>
+   <li>For the second method, by using the option '''chemistry_ini''', the newstart read the traceur.def file. With '''qx=...''', you initialise to a constant value and with '''qxf=profile_<tracer name>''', you initialise to a profile. The values must be in '''mol/mol'''. The profiles must be located in the folder chemical_profiles/ in your datadir. If the folder does not exist, create it.</li>
 </ul>

@@ Line 164: / Line 164: @@
 === In 1D ===
-In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in kg/kg).
+In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in '''kg/kg''').
-If you only want to initialise to a constant value, you must add '''qx=...''' on your traceur.def file.
+If you want to initialise by using the traceur.def file, you must add '''qx=...''' for a constant value or '''qxf=profile_<tracer name>''' for a profile (in '''mol/mol'''). The profiles must be located in the folder chemical_profiles/ in your datadir. If the folder does not exist, create it.
 For '''giant planets''', as there is no condensation at the surface and as we evaporate the condensates above the bottom of the model (we set the bottom level as deep as necessary for it to be a dry level), the total column of the tracer (initialized with profile_xxx_vap) should be conserved during the run. Hence the choice of initial profile matters a lot.

@@ Line 156: / Line 156: @@
 <ul>
-   <li>For the first method, you can choose between initialising to a constant ('''q=x''') or to a profile ('''q=profile'''). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the value of the constant (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify. The values must be in '''kg/kg'''.</li>
+   <li>For the first method, you can choose between initialising to a constant ('''q=x''') or to a profile ('''q=profile'''). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the constant value (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify. The values must be in '''kg/kg'''.</li>
-   <li>For the second method, by using the option chemistry_ini, the newstart read the traceur.def file. With '''qx=...''', you initialise to a constant value and with '''qxf=profile_<tracer name>''', you initialise to a profile. The values must be in '''mol/mol'''.</li>
+   <li>For the second method, by using the option '''chemistry_ini''', the newstart read the traceur.def file. With '''qx=...''', you initialise to a constant value and with '''qxf=profile_<tracer name>''', you initialise to a profile. The values must be in '''mol/mol'''.</li>
 </ul>

@@ Line 156: / Line 156: @@
 <ul>
-   <li>For the first method, you can choose between initialising to a constant (q=x) or to a profile (q=profile). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the value of the constant (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify. The values must be in '''kg/kg'''.</li>
+   <li>For the first method, you can choose between initialising to a constant ('''q=x''') or to a profile ('''q=profile'''). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the value of the constant (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify. The values must be in '''kg/kg'''.</li>
    <li>For the second method, by using the option chemistry_ini, the newstart read the traceur.def file. With '''qx=...''', you initialise to a constant value and with '''qxf=profile_<tracer name>''', you initialise to a profile. The values must be in '''mol/mol'''.</li>
 </ul>

@@ Line 153: / Line 153: @@
 === In 3D ===
-WARNING: Contrary to what is written in the '''ModernTrac-v1''' documentation, tracers cannot be initialised in the '''traceur.def''' file (qx is not read in 3D).
+To initialise the tracers in 3D, you must run a newstart. There is two options for initialising tracers: initialize with the option '''q=x / q=profile''' or with the option '''chemistry_ini'''.
-To initialise the tracers in 3D, you must run a newstart. During the newstart, when you are asked to change the tracers, you can choose between initialising to a constant (q=x) or to a profile (q=profile). Next, a list of all the tracers is displayed and you must enter the number of the tracer you want to change. After making this choice, simply enter the value of the constant (+surface value for this case) or the file name of the profile. You must repeat this for each tracer you want to modify.
+<ul>
 On dynamico, there is no newstart for now. You can add only tracers by hand by using the tracer_settings.py in the start.nc file of your first run (the makestart run).
 === In 1D ===

@@ Line 148: / Line 148: @@
 == Initialisation ==
 === In 3D ===
-In 3D, the initial distribution of tracers is in the '''start.def''' file. In order to change it, you have to modify the '''start.def''', for example using newstart.
+WARNING: Contrary to what is written in the '''ModernTrac-v1''' documentation, tracers cannot be initialised in the '''traceur.def''' file (qx is not read in 3D).
 === In 1D ===
 In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in kg/kg).
 For '''giant planets''', as there is no condensation at the surface and as we evaporate the condensates above the bottom of the model (we set the bottom level as deep as necessary for it to be a dry level), the total column of the tracer (initialized with profile_xxx_vap) should be conserved during the run. Hence the choice of initial profile matters a lot.
 For giant planets as well: you can additionally set '''qvap_deep = value''' to force the deep specific concentration to remain constant (bottomless planet) (works with either the generic tracer or the water = .true. option). In that case, note that the total column of the tracer will not remain the same as the column set from the initial profile_xxx_vap.
 [[Category:Inputs]]
 [[Category:Generic-Model]]

← Older revision		Revision as of 09:51, 5 March 2025
Line 4:		Line 4:

	Characteristics of the tracers can be also specified in ''traceur.def''.		Characteristics of the tracers can be also specified in ''traceur.def''.
		+
		+	It should not be confused with [[tracer.def]], which is the configuration file for [[DYNAMICO]].

	== What is a tracer? ==		== What is a tracer? ==

@@ Line 155: / Line 155: @@
 In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in kg/kg).
-For '''giant planets''', as there is no condensation at the surface and as we evaporate the condensates at the bottom of the model, the total column of the tracer (initialized with profile_xxx_vap) should be conserved during the run. Hence the choice of initial profile matters a lot.
+For '''giant planets''', as there is no condensation at the surface and as we evaporate the condensates above the bottom of the model (we set the bottom level as deep as necessary for it to be a dry level), the total column of the tracer (initialized with profile_xxx_vap) should be conserved during the run. Hence the choice of initial profile matters a lot.
-For giant planets as well: you can additionally set '''qvap_deep = value''' to force the deep mass mixing ratio to remain constant (bottomless planet) (works with either the generic tracer or the water = .true. option). In that case, note that the total column of the tracer will not remain the same as the column set from the initial profile_xxx_vap.
+For giant planets as well: you can additionally set '''qvap_deep = value''' to force the deep specific concentration to remain constant (bottomless planet) (works with either the generic tracer or the water = .true. option). In that case, note that the total column of the tracer will not remain the same as the column set from the initial profile_xxx_vap.
 === Using photochemistry ===

← Older revision		Revision as of 13:32, 18 September 2024
Line 154:		Line 154:

	In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in kg/kg).		In 1D, the initial distribution of each tracer can be read from a file named "'''profile_<tracer name>'''" (e.g. '''profile_h2o_vap''' for the water vapour initial profile), located in the run directory. This file has Nlayer + 1 lines (with Nlayer the number of horizontal layers): its first line is the surface value (in kg/m^2), and then each line is the value at the corresponding level (in kg/kg).
		+
		+	For '''giant planets''', as there is no condensation at the surface and as we evaporate the condensates at the bottom of the model, the total column of the tracer (initialized with profile_xxx_vap) should be conserved during the run. Hence the choice of initial profile matters a lot.
		+	For giant planets as well: you can additionally set '''qvap_deep = value''' to force the deep mass mixing ratio to remain constant (bottomless planet) (works with either the generic tracer or the water = .true. option). In that case, note that the total column of the tracer will not remain the same as the column set from the initial profile_xxx_vap.
		+

	=== Using photochemistry ===		=== Using photochemistry ===