[.cfg] file format

[.cfg] files are human-readable text files containing fieldname/fieldvalue pairs using the syntax:

#fieldname

fieldvalue1

fieldvalue2

      etc....

Field names are entered following the character #

They can only include letters/numbers and cannot start with a number (e.g. #variable01)

Field names can also contain multiple levels separated by the dot character (e.g. #denoising.filter). Multiple levels will be interpreted as structure fields/subfields

Field values can be numeric (entered as arrays or two-dimensional matrices) or alphanumeric (interpreted as lists / cell-arrays separated by newline characters)

Comments can be included following the character %

[.cfg] files can be read in Matlab using the function conn_loadcfgfile. For example:

  >> data = conn_loadcfgfile('example.cfg')

data = 

   struct with fields:

     pi: 3.1416

     hadamard: [4×4 double]

     phrase: {'hello world'}

     files: {2×1 cell}

     disk: [1×1 struct]

They can also be created from a Matlab structure using the function conn_savecfgfile. For example:

  >> conn_savecfgfile('example2.cfg', data); 

#pi

3.1416

#hadamard

1  1  1  1

1 -1  1 -1

1  1 -1 -1

1 -1 -1  1

#phrase

hello world

#files

/disk/file1

/disk/file2

#disk.name

large

#disk.number

3

#disk.avail

0.5

Last, they can also be exported to [.json] file format using the syntax:

  >> spm_jsonwrite('example2.json', data); 

{

 "pi": 3.14159265,

 "hadamard": [[1,1,1,1],[1,-1,1,-1],[1,1,-1,-1],[1,-1,-1,1]],

 "phrase": ["hello world"],

 "files": [

  "/disk/file1",

  "/disk/file2"

 ],

 "disk": {

  "name": ["large"],

  "number": 3,

  "avail": 0.5

 }

}