Previous: cemit
Up: References
Next: combine
Previous Page: cemit
Next Page: combine

column

htmlonly

• name:
  column
• synopsis: column inputfile outputfile [-first_column= integer[," name"]] [-second_column= integer[," name"]] [-n_points= integer] [-n_header_lines= integer] [-l1_skip= integer] [-l2_skip= integer] [-show_lines] [-spaces_to_skip] [-standard_format[=" name1"," name2",[" name_sig1"," name_sig2"]]] [-match_label=" string_to_match"[,invert]] [-filter_by=" name", lower, upper[,invert]] [-swap_xy] [-verbose] [-xlabel=" string"] [-ylabel=" string"] [-title=" string"] [-topline=" string"] [-format=" format-string"]
• description:
  column extracts data from non- mpl multi-column files into mpl format. Two types of input file format are supported. The first is a generic table with regular placement of data in rows and columns; basically any ASCII text file with data is rows and columns falls into this category. The second, called ``standard'' format, is a self-describing data-set format known as column format; it is described in Section 4 of this document.
• files:
  inputfile is the file containing the multi-column data. outputfile is the file in which the mpl-format data extracted from inputfile will be placed.
• options: --- Generic input files.

  first_column, second_column

  
  Specifies the column numbers for the data that will go into the first and second column of the output file. Columns are numbered starting with 0. The default is 0 and 1, respectively.

  n_points

  
  Specifies the maximum number of data point pairs to extract. The default is 100.

  n_header_lines

  
  Specifies the number of input lines to skip before extracting data.

  l1_skip

  
  Specifies the number of lines to skip after scanning the item for the first column to reach the line from which the item for the second column will be scanned. The default is 0, indicating that the two items are scanned from the same line.

  l2_skip

  
  Specifies the number of lines to skip after scanning the item for the second column to reach the line from which the next item for the first column will be scanned. The default is 0, indicating that the next input line is used.

  swap_xy

  
  Requests that the two columns of the output file be swapped. This is needed in the event that the desired abscissa data comes on a line after the desired ordinate data.

  show_lines

  
  Requests that each line that is scanned be echoed to the terminal.

  spaces_to_skip

  
  Specifies the number of spaces to skip at the beginning of each input line before scanning data. This is useful if the beginning of the input lines contains non-numeric data. The default is 0.

• options: --- Standard-format input files.

  standard_format

  
  Specifies the names of the data columns to be extracted and sent to the output file. Optionally, the user may request output of one or two sigma values in addition to the ordinate and abscissa values.

  match_label

  
  Specifies an optionally wildcard-containing string by which to select data rows for output. Only one of these is allowed per command.

  filter_by

  
  Specifies that input rows are to be filtered according to the values of a specified quantity. By default, only rows for which the named quantity is on [ lower, upper] will be output. If the invert keyword is given, only those rows for which the named quantity is outside this interval will be output. Any number of these may be given per command.

• options: --- Both input formats.

  xlabel

  
  Specifies the x-axis label for the output file.

  ylabel

  
  Specifies the y-axis label for the output file.

  title

  
  Specifies the title label for the output file.

  topline

  
  Specifies the topline label for the output file.

  format

  
  Specifies a C-style format string for printing the data to the output file.

  verbose

  
  Requests output of additional information during processing.