Caret:Documentation/FileNamingConventions

From Van Essen Lab

Jump to: navigation, search

Contents

Caret File Naming Conventions

By following the Caret file naming conventions, newly created files are properly named.

Do NOT use spaces in file names.

Examples of Files Properly Named

  • Human.1582.L.REGISTER-with-ATLAS.65950.spec
  • Human.1582.L.Eye_movements_attention.65950.metric
  • Human.1582.L.CartesianGrid.71785.borderproj
  • deformed_Human.1582.L.REGISTER-with-ATLAS.71785.deform_map

Caret File Name Components

In Caret, a file name consists of a group of components separated by periods. As a result, the use of periods within the individual components is strongly discouraged. Within the components consider underscores or dashes in place of period. These components are:

  • Species (see below for a list of species)
  • Subject (Name of subject, ie: Control_Case01)
  • Structure (see below for a list of structures)
  • Description (A description of the file's contents, ie: fMRI, Partitioning_Schemes)
  • Date (Used at one time, but its use is no longer recommended)
  • Number of Nodes (Include if the file is node related such as coordinates, topology, metric, shape, labels, etc).
  • Extension (The extension identifying the data file, type).

Assembling the components results in "Species.Subject.Structure.Description.NumberOfNodes.Extension".

Species Component

For species use:

  • Baboon
  • Chimpanzee
  • Ferret
  • Galago
  • Biggon
  • Gorilla
  • Human
  • Macaque
  • Mouse
  • Orangutan
  • Rat

Structure Component

For structure use a one or two letter abbreviation. Descriptions are in parenthesis:

  • L (Left Cerebral Cortex)
  • R (Right Cerebral Cortex)
  • LR (Both Left and Right Cerebral Cortex)
  • C (Cerebellum)
  • S (Subcortical)

Extension Component

Common File Extensions (All extensions are listed in the Open Data File and Save Data File Dialog file filters):

  • .areacolor
  • .border
  • .bordercolor
  • .borderproj
  • .coord
  • .foci
  • .focicolor
  • .fociproj
  • .metric
  • .nii
  • .nii.gz
  • .paint
  • .surface_shape
  • .topo

Creating a New Spec File

The best way to create a new spec file is to run:

  • On the command line, "caret_command -spec-file-create"
  • Window Menu->Caret Command Executor. Run SPEC FILE CREATE (The GUI interface to "caret_command -spec-file-create")
Personal tools
Sums Database