Jadrian Miles: New page: This Job Jar request is for a non-interactive command line program that reads in a collection of streamlines and the name of a streamline measurement, and op...

2010-01-26T23:09:32Z

New page: This Job Jar request is for a non-interactive command line program that reads in a collection of streamlines and the name of a streamline measurement, and op...

New page

This Job Jar request is for a non-interactive command line program that reads in a [[Job Jar/Streamline library|collection of streamlines]] and the name of a streamline measurement, and optionally one or more relevant raster images, and computes statistics over the collection for the specified measurement.

Example measurements of a given streamline might include:
* Length
* Distance between the ends of the streamline
* Average curvature
* Average value of the specified raster image along the streamline
* Total length, weighted by the value of the raster image at each point

=== Output Formats ===
The final program should be able to create output in the following formats, chosen by a command line option:
* '''Standard output''': print out the mean, standard deviation, median, quartiles, min, and max of the requested value.
* '''CSV''': export values for each streamline to a CSV (comma-separated value) plain text file. Such files can be imported by just about any software, such as Excel, SAS, or Matlab, for further analysis.
* '''Streamline''': assign values, as appropriate, to the points of each streamline or to the streamlines themselves, and export these assignments as a [[Job Jar/Streamline library|streamline collection file]].

=== Example Call ===
<pre>
streamline_stats my_streamlines.trk -length -silent -csv lengthstats.csv -streamlines lengths.trk
</pre>

This call would read in the streamline file <tt>my_streamlines.trk</tt>, compute the lengths of the streamlines, and export them as a CSV file <tt>lengthstats.csv</tt> as well as a streamline collection file <tt>lengths.trk</tt>, but generate no output on the command line (as specified by the <tt>-silent</tt> option).

=== Dependencies ===
This job depends on the completion of [[Job Jar/Streamline library]].

Job Jar/Streamline statistics program - Revision history

Jadrian Miles: New page: This Job Jar request is for a non-interactive command line program that reads in a collection of streamlines and the name of a streamline measurement, and op...