Gnuplot: An Interactive Plotting Program

Master Menu

                       GNUPLOT

            An Interactive Plotting Program
             Thomas Williams & Colin Kelley
                Version 4.6 organized by:
    Hans-Bernhard Broeker, Ethan A Merritt, and others

   Copyright (C) 1986 - 1993, 1998, 2004   Thomas Williams, Colin Kelley
           Copyright (C) 2004 - 2011  various authors

       Mailing list for comments: gnuplot-info@lists.sourceforge.net
     Mailing list for bug reports: gnuplot-bugs@lists.sourceforge.net

         This manual was originally prepared by Dick Crawford
                   Version 4.6 - December 2011


Major contributors (alphabetic order):

3.15.3.3 index

The index keyword allows you to select specific data sets in a multi-data-set file for plotting.

Syntax:

      plot 'file' index { <m>{:<n>{:<p>}} | "<name>" }

Data sets are separated by pairs of blank records. ‘index <m>‘ selects only set <m>; ‘index <m>:<n>‘ selects sets in the range <m> to <n>; and ‘index <m>:<n>:<p>‘ selects indices <m>, <m>+<p>, <m>+2<p>, etc., but stopping at <n>. Following C indexing, the index 0 is assigned to the first data set in the file. Specifying too large an index results in an error message. If <p> is specified but <n> is left blank then every <p>-th dataset is read until the end of the file. If index is not specified, the entire file is plotted as a single data set.

Example:

      plot 'file' index 4:5

For each point in the file, the index value of the data set it appears in is available via the pseudo-column ‘column(-2)‘. This leads to an alternative way of distinguishing individual data sets within a file as shown below. This is more awkward than the index command if all you are doing is selecting one data set for plotting, but is very useful if you want to assign different properties to each data set. See ‘pseudocolumns‘, ‘lc variable‘.

Example:

      plot 'file' using 1:(column(-2)==4 ? $2 : NaN)        # very awkward
      plot 'file' using 1:2:(column(-2)) linecolor variable # very useful!

‘index ’<name>’‘ selects the data set with name ’<name>’. Names are assigned to data sets in comment lines. The comment character and leading white space are removed from the comment line. If the resulting line starts with <name>, the following data set is now named <name> and can be selected.

Example:

      plot 'file' index 'Population'

Please note that every comment that starts with <name> will name the following data set. To avoid problems it may be useful to choose a naming scheme like ’== Population ==’ or ’[Population]’.

splot with indices demo.</p>