sclib format

[rciric]

Here we find ourselves again: the .sclib format is degenerate and not intuitive to build. This isn't going to be ready for the prerelease but should probably be available for v0.7.0.

Attributes of a seed or coordinate:

• Name: name of the seed or coordinate or of the region/network to which it belongs.
• Space: exactly what it says on the tin
• Voxel: for coor type only. Boolean indicating whether the coordinates are in voxel space or physical space.
• Coor: for coor type only. array or tuple specifying [x,y,z] for the coordinate.
• Map: for mask type only. path to the map of the seed.
• Radius: for coor type only. default radius of the seed.
• Citation: Path to bibtex citation for the coordinate, where applicable.
• NeurosynthID: ID in Neurosynth database, where applicable.

A conversion between the old and new formats should be available to continue legacy support.

[rciric]

Moving this here from #109 :

For consideration when revising the sclib format, it appears that Neurosynth uses a standard txt/tsv to store spatial coordinates:

id  doi x   y   z   space   peak_id table_id    table_num   title   authors year    journal
9106283 10.1016/S0028-3932(96)00104-2   -2.0    -98.0   -8.0    MNI 279430  14219   1   The functional anatomy of verbal initiation and suppression using the Hayling Test. Nathaniel-James DA, Fletcher P, Frith CD    1997    Neuropsychologia
9106283 10.1016/S0028-3932(96)00104-2   -34.0   18.0    4.0 MNI 279431  14219   1   The functional anatomy of verbal initiation and suppression using the Hayling Test. Nathaniel-James DA, Fletcher P, Frith CD    1997    Neuropsychologia
9106283 10.1016/S0028-3932(96)00104-2   -46.0   -42.0   4.0 MNI 279432  14219   1   The functional anatomy of verbal initiation and suppression using the Hayling Test. Nathaniel-James DA, Fletcher P, Frith CD    1997    Neuropsychologia
. . .
9412517     -28.0   42.0    9.0 TAL 334351  17512   1.  Masked presentations of emotional facial expressions modulate amygdala activity without explicit knowledge. Whalen PJ, Rauch SL, Etcoff NL, McInerney SC, Lee MB, Jenike MA 1998    The Journal of neuroscience : the official journal of the Society for Neuroscience
9465007     -40.0   24.0    36.0    UNKNOWN 334352  17513   1.  Transition of brain activation from frontal to parietal areas in visuomotor sequence learning.  Sakai K, Hikosaka O, Miyauchi S, Takino R, Sasaki Y, Putz B 1998    The Journal of neuroscience : the official journal of the Society for Neuroscience
9465007     -6.0    8.0 48.0    UNKNOWN 334353  17513   1.  Transition of brain activation from frontal to parietal areas in visuomotor sequence learning.  Sakai K, Hikosaka O, Miyauchi S, Takino R, Sasaki Y, Putz B 1998    The Journal of neuroscience : the official journal of the Society for Neuroscience

So changing the sclib either to json or csv seems reasonable for the next major update round.