Wave project file

Wave | Development

A Wave project file (*.wvp) is a text file that can be used to quickly load multiple series from multiple files at once.

The basic format is as follows:

file=path\to\file1
 series=series1
 series=series2: optional title
file=path\to\file2
 series=series3: optional title
 series=series4

Note: If the series name contains a colon (:), the name has to be enclosed in quotes, e.g.:

file=path\to\file
 series="series:name":"custom title"

Example

This is a basic example that loads multiple series from multiple different files of different types:

# Read multiple file types
#-------------------------
file=REG_SMUSI\N74235_Mue_10aV2.reg
file=UVF\42960.0_q_28.uvf
file=WEL\DEMONA_PSI.wel
 series=S3  _1AB: "S3_1AB"
 series=S3  _1ZU: "S3_1ZU"
file=WEL_GISMO\BEK_WEL.asc
 series=BEK_NH4Bek: "NH4 concentration"
file=WEL_TALSIM\TALSIM.wel
 series=S103_1AB
file=ZRE\Olef_Zufl_gem.zre
file=ZRXP\Q2.1440.zrx

Custom import settings

It is also possible to specify custom import settings. This is useful for generic text or csv files.

Example with all possible settings:

file=myrandom.csv
 # custom import settings
 isColumnSeparated=True
 separator=;
 dateformat=dd.MM.yyyy HH:mm:ss
 decimalSeparator=,
 iLineHeadings=1
 iLineUnits=8
 iLineData=12
 useUnits=True
 columnWidth=
 dateTimeColumnIndex=0
 # series to import
 series=myseries1
 series=myseries2

The accepted import settings are described below:

• isColumnSeparated: whether the columns are separated by a character (True) or are fixed width (False). Default: True
• separator: the column separator (only relevant if isColumnSeparated=True). Default: ;, possible values: space, tab, ,, or any other single-character string
• columnWidth: the column width (only relevant if isColumnSeparated=False). Default: 16
• dateformat: the date format (see help). Default: dd.MM.yyyy HH:mm
• decimalSeparator: the decimal separator for numbers. Default: .
• iLineHeadings: the number of the line containing the headings. Default: 1
• iLineUnits: the number of the line containing the units. Default: 2
• iLineData: the number of the first line of data. Default: 3
• useUnits: whether to read units from the file. Default: True
• dateTimeColumnIndex: The 0-based index of the column containing date time values. Default: 0

Notes

• all whitespace apart from linebreaks in the project file is optional
• the path to the file can be specified as an absolute path or as a relative path (relative to the project file)
• if a file is specified without specifying which series should be imported, all series contained in the file will be imported
• lines starting with # are ignored (treated as comments)
• support for this file was added in v1.6.1 (r445)
• support for specifying custom import settings was added in v1.6.2 (r481)