Page tree

Reads ASCII files containing datasets of every kind. Considers multiple forms of notation, separation and direction of data.


  • File Path: The absolute path to one file from the sequence, possibly using '#' char to mark the sequence numbers.
    • If at least one block of one or several consecutive # is given, replace the last of such blocks with the sequence numbers using at least as many digits - using leading zeros - as #, e.g.
      • "/path/to/image_00110_#r.txt": ..., "/path/to/image_00110_9r.txt", "/path/to/image_00110_10r.txt", ...
      • "/path/to/image_#####_00001.txt": ..., "/path/to/image_00099_00001.txt", "/path/to/image_00100_00001.txt", ...
      • "/path/to/image_#####_##.txt": ..., "/path/to/image_#####_09.txt", "/path/to/image_#####_10.txt", ..., "/path/to/image_#####_100.txt", ...
    • If no # is given, look for blocks of consecutive digits, starting from the back. First, a block with at least five digits is searched for, then one with at least four, then three, etc. The first block found is replaced - using leading zeros - with the sequence numbers, e.g.
      • "/path/to/image_00110.txt": ..., "/path/to/image_00099.txt", "/path/to/image_00100.txt", ...
      • "/path/to/image_00_10.txt": ..., "/path/to/image_00_99.txt", "/path/to/image_00_100.txt", ...
  • Sequence: Which file to read out of the sequence defined by File Path
    • "10": reads only the image with sequence number 10
    • "0-": reads all images from sequence number 0 until the last file of the sequence (maximum is 99999)
    • "0-:5": same as above but reads only every fifth image (0, 5, 10, ...)
    • "10-100": reads the images from number 10 to number 100
    • "10-100:10": same as above but reads only every 10s image (10, 20, ..., 100)
    • You can combine any option by using ";" as separation. (e.g. "10;20;30;40;100-1000:10;1010-")
    • It is possible to use input ranges from high to low numbers (e.g. '100-10') to read a sequence reversed.
    • Also negative steps can be used (e.g. '100-;-10' reads 100, 90, 80, ..., 10, 0)
    • Leave empty to read the image in File Path again and again without stopping.

  • Header: Number of header lines in the file
  • data direction: if vertical, a dataset is written in a column, else in a row
  • Separator: the sign to divide columns
  • decimal sign: either a "," or a "."
  • Zero placeholder: Some instruments fill a spot with a placeholder, if no data or empty data has been written. E.g. "   " or "XXX". This value will be replaced by "0"
  • x min, x max: cutting the datasets to the limitation of x value
  • box points smooth: smoothing the dataset by this boxcar size
  • Value x/y position: Defining the rows/columns of the datasets


  • This plugin has no inputs


  • Value x as a FLOAT_1D
  • Value y as a FLOAT_1D


  • The plugin tries to catch every wrong parameter and provides an error message. However, some errors can't be properly resolved. The user has to check carefully the ASCII file to fill the input parameters.
  • No labels