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

Individual Modality Map Data (vertex colors)

The six ASCII files in here:

  % ls -al
  -rw-r--r-- 1 sereno 742  223504 Mar 24 00:56 lh-mapsaud.cols
  -rw-r--r-- 1 sereno 742  510208 Mar 24 00:56 lh-mapssom.cols
  -rw-r--r-- 1 sereno 742 1027531 Mar 24 00:56 lh-mapsvis.cols
  -rw-r--r-- 1 sereno 742  239221 Mar 24 00:56 rh-mapsaud.cols
  -rw-r--r-- 1 sereno 742  507200 Mar 24 00:56 rh-mapssom.cols
  -rw-r--r-- 1 sereno 742 1012271 Mar 24 00:56 rh-mapsvis.cols

should be placed in the "label" subdirectory of the FreeSurfer average
subject, fsaverage.

N.B.: these are already included in the "label" subdirectory in the
fsaverage tarfiles here:

  https://pages.ucsd.edu/~msereno/csurf/fsaverage-ADDITIONS.tgz  (just adds)
  https://pages.ucsd.edu/~msereno/csurf/fsaverage.tgz           (fs5.3 + adds)

Each file contains vertexwise colors representing average topological
mapping data for the visual, auditory, and somatomotor modalities in
the left and right hemisphere.  The original publication describing the
stimuli and data analysis is here:

  Sood, M. and M.I. Sereno (2016) 
  Areas activated during naturalistic reading comprehension overlap
  topological visual, auditory, and somatotomotor maps.
  Human Brain Mapping 37:2784-2810.
  https://pages.ucsd.edu/~msereno/papers/LangMaps16.pdf

The files specify RGB vertex colors in the range 0-1 of (a subset of)
vertices in the FreeSurfer fsaverage surface (7th subtessellation of
an icosahedron).

The vertex colors are 'intrinsic' colors, *before* lighting calculations
have been applied, so the colors are an accurate report of the map
coordinate in each modality (visual: lower/middle/upper visual field;
auditory: low/mid/high frequencies; somatomotor: foot/hand/face), which
corresponds to the phase of the periodic response.

Therefore, the same *.cols file will be correctly displayed on differently
shaped (and lit) surfaces (the display program is responsible for the
lighting calculations).  The text file format is:

  #!ascii
  <num-vertices-in-file>
  <vtxnum> <r:0-1> <g:0-1> <b:0-1>
  ...

Here is a example fragment of such a file:

  -------------------------------------------
  #!ascii , from subject fsaverage
  10287
  509     0.000   0.522   0.960
  510     0.072   0.000   1.000
  519     0.868   0.019   0.576
  520     0.996   0.001   0.504
  ...
  -------------------------------------------

In csurf tksurfer, a vertex color file in a subject's label directory
can be read and displayed by selecting it from the "label:" dropdown,
and then doing a middle-click on the "R" button on the "label:" line.

Here is an example of how the same operation can be done in a csurf
tksurfer tcl script:

  set vclabal $SUBJECTS_DIR/fsaverage/label/lh-mapsvis.cols
  read_vtxcol_label
  redraw

