#########################################################################################
https://pages.ucsd.edu/~msereno/csurf/fsaverage-labels/CsurfMaps1-parcellation/README.txt
#########################################################################################

CsurfMaps1 parcellations (LH/RH), mapdata

The left and right hemisphere CsurfMaps1 and HCP-MMP1 parcellations here
are MGH format binary surface 'annotation' files that can be used in
either csurf or MGH freesurfer.  They specify a region idnum, region name,
and a color for each vertex in the fsaverage surfaces.  The CsurfMaps1
parcellation files were also converted to GIFTI (*.label.gii) files.
The ASCII color lookup table used to assemble the annotation files (for
either csurf or freesurfer) and the final sequential color table with
ID num 'holes' removed are also included here.

The 3D cortical ribbon files are provided in AFNI (short,
*.BRIK,HEAD) and Freesurfer (int, *.mgz) formats (registered with
the FreeSurfer orig.mgz volume). These were made using the tcl script
$CSURF_DIR/lib/tcl/annot2roi.tcl (makes popup if run from tksurfer)
and contain region id numbers of voxels sampled by points along surface
normals of the FreeSurfer fsaverage "orig" surface from 0.0 to 1.1 of
the average local cortical thickness.  The csurf tksurfer function,
fill_idnumbrik_holes was used to remove holes (on gyri, surface normals
spread apart near the pial surface).  CsurfColorLUT-both.txt is a
sequential hemi-specific color lookup table giving the names and colors
of the region ID numbers in the 3D files.

See README.txt's in the subdirectories for more details on files there.

  Abbreviations-Table1.pdf  -- table of abbreviations on one page
  CsurfColorLUT.txt         -- directs construct csurf/freesurf annot ('holes')
  CsurfMapsl.ctab.txt       -- final sequential color table w/ID 'holes' rm'd
  lh-CsurfMaps1.annot       -- native freesurfer annotation
  lh-CsurfMaps1.label.gii   -- GIFTI via mris_convert
  rh-CsurfMaps1.annot       -- native freesurfer annotation
  rh-CsurfMaps1.label.gii   -- GIFTI via mris_convert
  CsurfMaps1+orig.BRIK,HEAD -- 3D cortical ribbon ROIs (short region id's)
  CsurfMaps1.mgz            -- 3D cortical ribbon ROIs (int region id's)
  CsurfColorLUT-both.txt    -- sequential hemi-specific col lookup table for 3D
  orig+orig.BRIK,HEAD       -- for viewing overlay in AFNI (from orig.mgz)

  mapdata
    README.txt
    lh-mapsaud.cols         -- auditory areas (ASCII vertex color file)
    lh-mapssom.cols         -- somatosensory areas (ASCII vertex color file)
    lh-mapsvis.cols         -- visual areas (ASCII vertex color file)
    rh-mapsaud.cols         -- same, for RH 
    rh-mapssom.cols         -- same, for RH
    rh-mapsvis.cols         -- same, for RH

  mapdata-labels:
    README.txt              -- [phase adjust details]
    lh-mapsvisADJPHA.label  -- FreeSurfer label file w/adjusted polar angle
    rh-mapsvisADJPHA.label  -- FreeSurfer label file w/adjusted polar angle

  simple-annot:
    README.txt
    CsurfMaps_newcurv-lh.w     -- newcurv wfile vers annot ID nums (all vtxs)
    CsurfMaps_old3byte-lh.w    -- old wfile version (only vtxs w/non-0 vals)
    CsurfMaps_newcurv-rh.w     -- [same: rh]
    CsurfMaps_old3byte-rh.w    -- [same: rh]
    lh-CsurfMaps1_MNI152.label -- x,y,z: MNI152 plus 0.4 of ctx thk along normal
    lh-CsurfMaps1_MNI305.label -- x,y,z: MNI305 plus 0.4 of ctx thk along normal
    rh-CsurfMaps1_MNI152.label -- [same: rh]
    rh-CsurfMaps1_MNI305.label -- [same: rh]

For details of the parcellation, see:

  Sereno MI, Sood MR and Huang R-S (2022)
  Topological Maps and Brain Computations From Low to High.
  Frontiers in System Neuroscience 16:787737
  https://pages.ucsd.edu/~msereno/papers/MapsLowToHigh22.pdf
  (doi: 10.3389/fnsys.2022.787737)

