LABORATORY OF NEURO IMAGING 3D VISUALIZATION TOOL

LONI Visualization Tool (LONI_Viz)®

Curves-As-Trees (CAT) Object File Format

LONI_Viz WILL read and write curve/contour files of the following ASCII type/synthax (Curves-As-Trees (CAT) Object File Format) CAT or cat). Example of a CAT file: example.cat

Note:

Curves-As-Graphs (CAG's)

Only leaf-nodes contain point-data!

Modeled by the MAP Atlas and BrainTree Hierarchical Organization

Allows us to easily split one predefined contour into several pieces (Children),
for cytoarchitectonic labeling

Convertors between CAT <--> UCF (universal contour file, a single contour file format) and CAT <--> MCF files will be written:

MergeCAT_files_drive [[file.cat/ucf]] combined_file.cat
CAT_2_UCF_drive plane_z_level contour_index file_input.cat file_output.ucf
CAT_2_MCF_drive plane_z_level contour_index file_input.cat file_output.ucf

Curve As Tree Class Organization

class CurveAsTreeNode
{     public:
            CurveAsTreeNode();
            CurveAsTreeNode(Vector _Parents);
            CurveAsTreeNode(Vector _Children);

/** All public interface methods for the private/protected members **/

        protected:
               SingleContourObject SCO;    // Only leaf-nodes of CAT objects contain data points. To build
                                                                // the entire curve one grabs the SCO's from the children leaf-nodes
                                                                // and puts them together.

// Vector_Of(x, y, z; vx, vy, vz; stringAtributes), only the first
// 3 arg's, (x, y, z) are required. A SCO need not be planar!

// string atributes could be used to demarkate tag-points
// critical for registration purposes, starting/ending curve descriptors, etc.

Vector Parents; // We want multiple parents since one curve may be part
// of several curve-objects for example one contour serves as boundary to many regions //

Vector Children;

string history;

string auxhiliary;

string orientation; // axial/sagittal/coronal/3D

                                    // Coordinate organization
                double width_v;             // Voxel/World string width & height. Both are interchangable
                double height_v;
                string depth_v;

                double width_w;
                double height_w;
                double depth_w;

double xrange_min_v, xrange_max_v;
double xrange_min_w, xrange_max_w;

double yrange_min_v, yrange_max_v;
double yrange_min_w, yrange_max_w;

double zrange_min_v, zrange_max_v;
double zrange_min_w, zrange_max_w;

double x_start, y_start, z_start;

int number_of_parents;
int number_of_children;

}

EXAMPLE
myFile.cat

# "#", the sharp character denotes comments, parser bypasses them
# "[", "]" and multiple (nested) blocks enclose possibly repeating blocks
<orientation=>
axial
<width=>
384
<height=>
280
<depth=>
120
<xrange=>
-112.500000 79.500000
<yrange=>
-60.000000 80.000000
<zrange=>
-95.500000 95.500000
<total_z_levels=>
150
[
<level_number=>
1.000000
<total_contours=>
15
[[
<contour_index=>
1
<contour_colors=>
19 94 94
<contour_name=>
some ROI name
<point_num=>
100
<contour_data=>
-52.000000 2.856786 2.500000
.
.
.
# In general we can add atributes by
1 2 3 atr=atribute_string_1 atr=atribute_string_2 ... atr=atribute_string_N
.
.
.

-52.000000 2.856786 2.500000
<end_of_contour>
]]
<end of level>
]
<end>
#
#
#Point3D <-- AttributePoint3D <-- SingleContourObject <-- MultiContourObject
#
#
#

http://www.loni.ucla.edu/~dinov/LONI_Vis.dir/CurveObjectTree_Format.html

)