showtc
Description:
A very simple command line utility that takes a text file and plots the data in it in a matplotlib window. That’s it. A good tool for quickly seeing what’s in a file. Has some options to make the plot prettier.
Inputs:
Text files containing time series data
Outputs:
None
Usage:
Plots the data in text files.
usage: showtc [-h] [--samplerate FREQ | --sampletime TSTEP]
[--displaytype {time,power,phase}]
[--format {overlaid,separate,separatelinked}] [--waterfall]
[--voffset OFFSET] [--transpose] [--normall] [--title TITLE]
[--xlabel LABEL] [--ylabel LABEL]
[--legends LEGEND[,LEGEND[,LEGEND...]]] [--legendloc LOC]
[--colors COLOR[,COLOR[,COLOR...]]] [--nolegend] [--noxax]
[--noyax] [--linewidth LINEWIDTH[,LINEWIDTH[,LINEWIDTH...]]]
[--figurewidth WIDTH] [--aspectratio RATIO] [--tofile FILENAME]
[--fontscalefac FAC] [--saveres DPI] [--starttime START]
[--endtime END] [--forcezerostart] [--numskip NUM]
[--fullxrange] [--debug] [--version] [--detailedversion]
textfilenames [textfilenames ...]
Positional Arguments
- textfilenames
One or more input files, with optional column specifications
Named Arguments
- --samplerate
Set the sample rate of the data file to FREQ. If neither samplerate or sampletime is specified, sample rate is 1.0.
Default:
auto- --sampletime
Set the sample rate of the data file to 1.0/TSTEP. If neither samplerate or sampletime is specified, sample rate is 1.0.
Default:
auto- --displaytype
Possible choices: time, power, phase
Display data as time series (default), power spectrum, or phase spectrum.
Default:
'time'- --format
Possible choices: overlaid, separate, separatelinked
Display data overlaid (default), in individually scaled windows, or in separate windows with linked scaling.
Default:
'overlaid'- --waterfall
Display multiple timecourses in a waterfall plot.
Default:
False- --voffset
Plot multiple timecourses with OFFSET between them (use negative OFFSET to set automatically).
Default:
0.0- --transpose
Swap rows and columns in the input files.
Default:
False- --normall
Normalize all displayed timecourses to unit standard deviation and zero mean.
Default:
False- --starttime
Start plotting at START seconds (default is the start of the data).
- --endtime
Finish plotting at END seconds (default is the end of the data).
- --forcezerostart
Set the start time of the plot to zero, regardless of the actual time
Default:
False- --numskip
Skip NUM lines at the beginning of each file (to get past header lines).
Default:
0- --fullxrange
Set xrange to be the overall range of all files.
Default:
False- --debug
Output additional debugging information.
Default:
False
General plot appearance options
- --title
Use TITLE as the overall title of the graph.
- --xlabel
Label for the plot x axis.
- --ylabel
Label for the plot y axis.
- --legends
Comma separated list of legends for each timecourse.
- --legendloc
Integer from 0 to 10 inclusive specifying legend location. Legal values are: 0: best, 1: upper right, 2: upper left, 3: lower left, 4: lower right, 5: right, 6: center left, 7: center right, 8: lower center, 9: upper center, 10: center. Default is 2.
Default:
2- --colors
Comma separated list of colors for each timecourse.
- --nolegend
Turn off legend label.
Default:
True- --noxax
Do not show x axis.
Default:
True- --noyax
Do not show y axis.
Default:
True- --linewidth
A comma separated list of linewidths (in points) for plots. Default is 1.
- --figurewidth
Initial figure width in inches. Default is 8.0.
Default:
8.0- --aspectratio
Initial physical plot aspect ratio (width/height). For separate formats, this applies to each subplot and the full stacked figure is scaled accordingly. Default is 1.5.
Default:
1.5- --tofile
Write figure to file FILENAME instead of displaying on the screen.
- --fontscalefac
Scaling factor for annotation fonts (default is 1.0).
Default:
1.0- --saveres
Write figure to file at DPI dots per inch (default is 1000).
Default:
1000
Version options
- --version
Show simplified version information and exit
- --detailedversion
Show detailed version information and exit