Parameters
The following parameters are currently available:
-
traceFile
Name of the.txt
carbon footprint report containing the energy consumption, the estimated CO₂ emission, and other relevant metrics for each task.
Default:co2footprint_trace_<timestamp>.txt
-
summaryFile
Name of the.txt
carbon footprint summary file containing the total energy consumption and the total estimated CO₂ emission of the pipeline run.
Default:co2footprint_summary_<timestamp>.txt
-
reportFile
Name of the HTML report containing information about the entire carbon footprint, overview plots and more detailed task-specific metrics.
Default:co2footprint_report_<timestamp>.html
-
location
Specifies the zone code for the location where computations are run, based on the available zone codes in the zones overview section on the Electricity Maps website. If the provided location does not match any listed zone codes, it will be set tonull
.
Default:null
-
ci
Set this parameter only if you know the carbon intensity (ci) value for your location and prefer not to use the Electricity Maps API. However, using the API is recommended to retrieve real-time data for more accurate calculations.
Default:null
-
apiKey
Your Electricity Maps API token.
First, create a Nextflow secret with the nameEM_API_KEY
for your API key using:
nextflow secrets set EM_API_KEY "paste_api_key_here"
. Then, set the config parameter tosecrets.EM_API_KEY
.
Default:null
-
pue
Power usage effectivenes efficiency coefficient of the data centre. For local cluster you can usually find out your specific PUE at the system administrators or system managers. Also the current yearly worldwide average could be used.
Default: 1.00 -
powerdrawMem
power draw from memory.
Default: 0.3725. -
customCpuTdpFile
Input CSV file containing custom CPU TDP data. This should contain the following columns:name
,tdp (W)
,cores
. Note that this overwrites TDP values for already provided CPU models. You can find the by default used TDP data here.
Default:null
.Example custom CPU TDP file:
name tdp (W) cores Intel(R) Xeon(R) CPU E5-2670 v3 120 12 AMD EPYC 7742 225 64 Intel(R) Core(TM) i7-9700K 95 8 -
ignoreCpuModel
Ignore the retrieved Nextflow tracecpu_model
name and use the default CPU power draw value. This is useful, if the cpu model information provided by the linux kernel is not correct, for example, in the case of VMs emulating a different CPU architecture.
Default:false
. -
powerdrawCpuDefault
The default value used as the power draw from a computing core. This is only applied if the parameterignoreCpuModel
is set or if the retrievedcpu_model
could not be found in the given CPU TDP data.
Default: 12.0. -
machineType
The type of machine the computation is executed upon. It determines thepue
if the parameter is not explicitly specified in the config file. Must be one of:'compute cluster'
,'local'
, or''
.
If not specified (null
), the plugin infersmachineType
from the Nextflowprocess.executor
setting, mapping it to either'compute cluster'
or'local'
.
''
can be used if you want to bypass this behavior.
Default:null
'local'
: setspue
to 1.0'compute cluster'
: setspue
to 1.67''
: setspue
to 1.0