Plotting

plot [data] [--options]
Argument Explanation
data <column> Selects the data to plot. The format is outlined in the column section.
--xlabel <text> Sets the x-axis label. You can use \(\LaTeX\) formatting with $text$
--ylabel <text> Sets the y-axis label. You can use \(\LaTeX\) formatting with $text$
--title <text> Sets the title of the plot. You can use \(\LaTeX\) formatting with $text$
--xlim <range> Sets the x plotting range.
--ylim <range> Sets the y plotting range.
--vshift <value> Draws each consecutive plot vertically shifted by the given amount, relative to the previous. Default is 0, does not shift.
--colorby <value> Chooses a variable to color the data by, such as --colorby .fn or --colorby E0. See the metadata section for the default variable names.
--figure <figure> Selects a specific figure to plot within. You can specify the figure number and the subplot position as such: 3:1.2 will plot the data in the figure number 3, in the subplot at position 1,2. By default creates a new figure.
--color <color> Colors the spectra with the given color or colormap. The colormap names are defined by matplotlib. You can specify a linear colormap as a sequence of colors, such as --color red yellow green blue.
--alpha <value> Specify the opacity of the plots. Must be between 0 (transparent) and 1(fully visible). Default is 1.
--show If set, immediately shows the selected figure, and waits for it to close. By default, all figures are shown at the end of the program.
--linewidth <value> Specify the width of the lines. Default is 1.
--xxthick Convenience method to set the line width. Equivalent to --linewidth 8
--xthick Convenience method to set the line width. Equivalent to --linewidth 4
--thick Convenience method to set the line width. Equivalent to --linewidth 2
--thin Convenience method to set the line width. Equivalent to --linewidth 0.5
--xthin Convenience method to set the line width. Equivalent to --linewidth 0.25
--xxthin Convenience method to set the line width. Equivalent to --linewidth 0.125
--linestyle <value> Specify the line style of the spectra. Default is solid. Can be either a named style(solid,dotted,dashed,dashdot) or a sequence of numbers separated by ., indicating the length of each drawn section.
--solid Convenience method to set the line style. Equivalent to --linestyle solid
--dotted Convenience method to set the line style. Equivalent to --linestyle dotted
--dashed Convenience method to set the line style. Equivalent to --linestyle dashed
--dashdot Convenience method to set the line style. Equivalent to --linestyle dashdot

Column

When plotting, you can specify the data columns and apply transformations directly using a concise syntax. The basic syntax is as follows:

axis:column

where axis represents the x axis, such as E, e, k or R, and column represents the y values, such as a, mu, x, pre and I0.

Transformations

You can apply operations to both the x and y axes by chaining operators with a dot (.). Each side of the : (x-axis and y-axis) supports independent transformation chains.

Operator Requires argument x-axis y-axis Explanation
r Takes the real part of the column.
i Takes the imaginary part of the column.
a Takes the absolute value of the column.
p Calculates the complex phase of the column.
s Smooths the column. The number identifies the window width.
d Calculates the n-th derivative of the column, with respect to the x axis.
k Weighs the y axis by the x axis with the specified power.
w Subtracts the constant value of 1, then weighs the y axis by the x axis, then adds 1.
W Subtracts the average of the data, then weighs the y axis by the x axis, then adds back the average.

Examples

Example Explanation
plot E:d1.x Plots the first derivative of \(\chi(E)\).
plot k:k2.x Plots the data weighed by \(k^{2}\): \(k^{2}\cdot\chi(k)\)
plot R:a.f Plots the absolute value of the fourier transform against the R axis.
plot r.f:a.f Plots the imaginary value of the fourier transform against its real value.