v0.3.4: Windows and MSVC support

v0.3.4: Windows and MSVC support

• Fix incorrect reading of binary data under Windows/MSVC, run unit tests under Windows on CI system.
• Fix lots of minor warnings on higher WARN levels during compilation (implicit size_t <-> int32_t casts).

v0.3.3: Submeshes

v0.3.3: Submeshes

• Add function libfs::Mesh::submesh_vertex to create a submesh based on given vertex indices.
• Add static function libfs::Mesh::curv_data_for_orig_mesh to map per-vertex data for a submesh back to the full, original mesh.

v0.3.2: Version information

v0.3.2: Version information

• Add a define LIBFS_VERISION, which makes the version available.

Logging and smoothing of per-vertex data

v0.3.1: Logging and smoothing of per-vertex data

• Add fs::Mesh::construct_grid function to construct 2D grids.
• Add fs::Mesh::construct_pyramid function.
• Add option to control logging via log levels. See API docs main page for usage info.
• Add support for smoothing per-vertex data on meshes, see new function fs::Mesh::smooth_pvd_nn.
• Related to fs::Mesh::smooth_pvd_nn, add new mesh functions fs::Mesh::as_adjlist, fs::Mesh::as_matrix, and fs::Mesh::as_edgeset.

v0.3.0: Fully documented

• Finish API documentation: all members and functions documented, many with example usage in the doc string.
• Add support for writing FreeSurfer brain meshes in surf format, see function fs::write_surf.
• Add support for constructing basic meshes, see fs::Mesh::construct_cube. Mainly for examples.
• Add general wrapper function for writing meshes in different formats, auto-detected from file extension, see fs::write_mesh.
• BREAKING: Remove duplicate fs::fullpath function. Use fs::util::fullpath instead.

v0.2.2: Exceptions for the world

v0.2.2

• add read_subjectsfile function
• throw exceptions in all places where exit() was still being called. document potentially thrown exceptions in function doc strings.
• fix mesh indexing bug

v0.2.1: Annot support and much better docs

v0.2.1

• Finish API documentation
• Add structs Annot and Colortable with many convenience member functions that model brain parcellations.
• Add support for reading brain surface parcellations from annot files.
• Add example for reading annot files.

v0.2.0 Streaming and MGZ support

v0.2.0

• BREAKING: change order of arguments for all functions reading streams.
• BREAKING: rename all sread_ function to read_ and use overloading.
• add stream-based versions for reading various formats, including MGH. This allows for MGZ support, see examples/read_mgz/.
• add many new member functions to structs and use them throughout the library
• add Curv struct and new read_curv function that reads into it.
• BREAKING: rename old read_curv function that reads only the data part to read_curv_data.

v0.1: Initial release

This is the first release, features:

• read and write FreeSurfer per-vertex data from and to binary curv format files (like $SUBJECTS_DIR/surf/lh.thickness).
• read FreeSurfer brain surface meshes from binary surf format files (like $SUBJECTS_DIR/surf/lh.white).
• read FreeSurfer ASCII label files (like $SUBJECTS_DIR/label/lh.cortex.label).
• read and write FreeSurfer 4D volume files (typically 3D voxels + a fourth time/subject dimension) from binary MGH format files (like $SUBJECTS_DIR/mri/brain.mgh or $SUBJECTS_DIR/surf/lh.thickness.fwhm5.fsaverage.mgh).