NAME

     ijkscalarinfo - output information about  a  regular  scalar
     grid

SYNOPSIS

     ijkscalarinfo [OPTIONS] {input filename}

DESCRIPTION

     ijkscalarinfo is a program to  output  information  about  a
     regular  scalar grid.  Information includes grid dimensions,
     number of grid vertices, number of grid cubes,  minimum  and
     maximum  scalar values, number of vertices with scalar value
     zero  and  the  minimum  interval  between  distinct  scalar
     values.   The  input file should be a Nearly Raw Raster Data
     (nrrd) file.  With the -plot option,  ijkscalarinfo  outputs
     gnuplot  (.gplt)  files containing frequency plots of scalar
     grid properties.

OPTIONS

     -plot
          Create gnuplot (.gplt) files of  each  output  measure-
          ment.

     -freq
          Output  frequency  of  grid   vertex   scalar   values.
          (Default.)

     -iso Output isosurface area as a function of scalar  values.
          Isosurface  area  is  measured as number of intersected
          edges/cubes. (Default.)

     -iso Output volume of  interval  volume  as  a  function  of
          scalar  intervals.   Isosurface  volume  is measured as
          number of intersected edges/cubes.  (Default.)

     -gradient
          Output total and mean gradients as a function of scalar
          values.    Gradients  are  measured  as  the  spans  of
          edges/cubes. (Default.)

     -zero_gradient
          Output number of zero gradient edges as a  function  of
          scalar values.

     -components
          Output number of connected components as a  funcion  of
          scalar values.

     -edge
          Output area/volume based on grid edges. (Default.)

     -cube
          Output area/volume based on grid cubes.

     -edge_dim
          Output fractal edge dimension as a function  of  scalar
          value.  The fractal edge dimension is log2(m1)-log2(m2)
          where m1 is the number of intersected edges in the ori-
          ginal grid and m2 is the number of intersected edges in
          a subsampled grid with subsample resolution 2.

     -box_dim
          Output fractal box dimension as a  function  of  scalar
          value.   The fractal box dimension is log2(m1)-log2(m2)
          where m1 is the number of intersected cubes in the ori-
          ginal grid and m2 is the number of intersected cubes in
          a subsampled grid with subsample resolution 2.

     -edge_span
          Output frequency plots of  edge  span  magnitudes.   If
          min_scalar is set, only edges with some endpoint scalar
          value at least the minimum are  included  in  the  edge
          span  frequencies.   If  max_scalar  is set, only edges
          with some endpoint scalar value at most the maximum are
          included in the edge span frequencies.

     -cube_span
          Output frequency plots of  cube  span  magnitudes.   If
          min_scalar  is  set, only cubes with some vertex scalar
          value at least the minimum are  included  in  the  cube
          span  frequencies.   If  max_scalar  is set, only cubes
          with some vertex scalar value at most the  maximum  are
          included in the cube span frequencies.

     -min_scalar min
          Minimum  scalar  values.  Used   with   -edge_span   or
          -cube_span.

     -max_scalar max
          Maximum  scalar  values.  Used   with   -edge_span   or
          -cube_span.

     -laplace
          Compute gradient on isosurface by summing Laplacian.

     -sum_from0
          Sum Laplacian from minimum value.

     -sum_to0
          Sum Laplacian from maximum value.

     -all Output all measurements.

     -none
          Output no table measurements.

     -normalize
          Normalize frequencies by dividing by total.  Normalized
          values are between 0.0 and 1.0.

     -interval I
          Bucket interval.  Must be  a  positive  floating  point
          number.

     -num_buckets n
     -numb n
          Number of buckets.  Must be a positive integer.

     -iv vertex_index
          Output information about vertex vertex_index.

     -cc "cube_coordinates"
          Output  information   about   cube   with   coordinates
          cube_coordinates.    The   cube   coordinates  must  be
          enclosed between double apostrophes.

     -subsample n
          Compute information for subsampled grid with  subsample
          resolution n.  Cannot be used with -iv or -cc options.

     -o output_filename
          Output measurements  to  file  output_filename.   Note:
          Without  the -o option, each measurement is placed in a
          separate file.

     -file_label file_label
          Add file_label to all file names.

     -help
          Print help message (and exit.)

AUTHOR

     Rephael Wenger