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...]]]
[--tofile FILENAME] [--fontscalefac FAC] [--saveres DPI]
[--starttime START] [--endtime END] [--numskip NUM] [--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).
- --numskip
Skip NUM lines at the beginning of each file (to get past header lines).
Default: 0
- --debug
Output additional debugging information.
Default: False
General plot appearance options
- --title
Use TITLE as the overall title of the graph.
Default: “”
- --xlabel
Label for the plot x axis.
Default: “”
- --ylabel
Label for the plot y axis.
Default: “”
- --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.
- --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