Project

General

Profile

Output file renaming

Specifying a %-format specifier in the fileName parameter of a particular output module configuration is sufficient to trigger the file renaming.

Output File Format Specifiers.

Specifier Meaning
%# Sequence number1 (i.e. the third file written to this output stream will have sequence number 3).
%ifb Base name of input file without extension.
%ifd Fully-resolved path of input file without file name.
%ife Extension of input file.
%ifn Base name of input file with extension.
%ifp Fully-resolved path with file name of input file.
%ifs%<match>%<format>%[ig]% Regex-based substitutions of input file (ECMAScript with % delimiter). For ease of processing, literal % characters in match or format clauses are forbidden.
%l Label of output module.
%p art's process name from FHiCL or command-line.
%r Lowest run # of run records written to this file1.
%R Highest run # of run records written to this file1.
%s Lowest subrun # of subrun records written to this file1.
%S Highest subrun # of subrun records written to this file1.
%to Time2 of file-open.
%tc Time2 of file-close.
%ts Start time2 of SubRun corresponding to the %s specifier3.
%tS Start time2 of SubRun corresponding to the %S specifier3.
%tr Start time2 of Run corresponding to the %r specifier3.
%tR Start time2 of Run corresponding to the %R specifier3.

1 Also accepts printf-style fill modifiers (e.g. %05s for a substitution that is zero-filled to 5 digits).

2 The format is "YYYYMMDDTHHMMSS", where "T" separates the date and time.

3 Supported as of art 3.01.00.

Implementation of the following specifiers has been deferred to a later date.
Specifier Meaning
%te Timestamp of lowest-numbered event of lowest-numbered run to be written to this file.
%tE Timestamp of highest-numbered event of highest-numbered run to be written to this file.