STICKFIG
Home ›
Software ›
Manual Pages ›
STICKFIG
Section: User Commands (1)
Updated:
Index
Return to Main Contents
NAME
stickfig - generate stick figure from ProAnalyst's exported limb coordinates
SYNOPSIS
stickfig
[-n num]
[-s rec]
[-e rec]
[-c col]
[-f nf]
[-x fn]
[-y fn]
[-m mul]
[-g gap]
[-b]
[-v]
input.csv
>
output.plt
DESCRIPTION
Stickfig
reads X and Y coordinates for limb positions from an ASCII text file of
comma-separated values exported from the
ProAnalyst
motion capture software, and generates an HPGL plot file of stick figures
showing limb movement over time.
Output is sent to the standard output, which should be redirected to a file
or piped to an HPGL viewer such as
xhpgl.
Options
- -n num
-
specifies a frame rate divisor for reducing the amount of
output, such that only the first of each "num" input records
will appear in the output (default is 10).
- -s rec
-
specifies the starting record number (default is 1).
- -e rec
-
specifies the ending record number (default is all).
Only the records between the specified start and end will
be included in the output. If instead of a record number,
the start or end is specified as a time value followed by "s"
(for seconds), then the record with a matching time value in
column 2 will be used as the start or end. If the record number
is followed by "i" (for index) the record with a matching index
value in column 1 will be used. If the number is followed by
"ss" it is taken as seconds from the start, i.e. the first
record.
- -c col
-
specifies the starting column for the first X coordinate
(default is 3).
- -f nf
-
specifies the number of features (coordinate pairs) in the
input file (default is the number of pairs in the first record).
- -x fn
-
specifies a feature number on which to normalize the X position
(default is 0, meaning no normalization).
- -y fn
-
specifies a feature number on which to normalize the height (Y)
(default is 0, meaning no normalization).
- -m mul
-
specifies the scaling factor by which the coordinates will be
multiplied (default is 1). By default, the figures are scaled
so that they occupy the middle third of a plotter page, and are
spaced apart to fill the whole width. Increasing the scaling
will cause them to appear larger but be spaced closer together.
The multiplier is relative to the automatic scaling that will
be used to convert the input coordinates to the HPGL coordinate
system. You can specify an absolute scaling factor by appending
the string "abs" to the number, e.g. 120abs, to get fixed
scaling of the data across several data sets.
- -g gap
-
specifies the x-axis spacing or gap between successive limb
figures, overriding the automatic spacing calculation.
The gap is specified in HPGL plotter units.
(default is automatic).
- -b
-
specifies that a scale bar should be shown at the bottom left.
- -v
-
specifies verbose output, which will show some calculated parameters.
This can be helpful when trying to figure out the correct values for the
start or end of the range, or suitable absolute scaling factors (for -m
option) or spacing for the -g option.
FILES
input.csv the file exported from ProAnalyst
output.plt the HPGL plot file to which output is redirected
EXAMPLES
- stickfig -s 1800 -e 2400 -m 0.3 -f 5 -b h3_w9_base1.txt > h3w9b1.plt
-
Generate a plot using the first 5 coordinate pairs, scaling the figures
to be 30% of the default size, and specifying the data range using start
and end record numbers. Output is saved in a .plt file, and includes a
scale bar.
- stickfig -s 1.7s -e 4.1s -m 0.3 -f 5 -b h3_w9_base1.txt > h3w9b1.plt
-
Same example but specifying the start and end records using the time values
from column 2 in the input.
- stickfig -n5 -s7.5ss -e10.5ss h2_w6_ns3_stickfig.txt | xhpgl
-
Generate and view a plot using every 5th record in the data, with the range
specifies as seconds from start (ss).
SEE ALSO
proa2run(1), emuhpgl(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- Options
-
- FILES
-
- EXAMPLES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 17:58:07 GMT, February 20, 2019
Copyright © G. R. Detillieux,
Spinal Cord Research Centre,
The University of Manitoba.