{ "info": { "author": "Fabian Peter Hammerle", "author_email": "fabian@hammerle.me", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Healthcare Industry", "Intended Audience :: Science/Research", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Scientific/Engineering :: Medical Science Apps.", "Topic :: Utilities" ], "description": "freesurfer-stats\n================\n\n.. image:: https://travis-ci.org/fphammerle/freesurfer-stats.svg?branch=master\n :target: https://travis-ci.org/fphammerle/freesurfer-stats\n.. image:: https://coveralls.io/repos/github/fphammerle/freesurfer-stats/badge.svg?branch=master\n :target: https://coveralls.io/github/fphammerle/freesurfer-stats?branch=master\n.. image:: https://img.shields.io/pypi/v/freesurfer-stats.svg\n :target: https://pypi.org/project/freesurfer-stats/#history\n.. image:: https://img.shields.io/pypi/pyversions/freesurfer-stats.svg\n :target: https://pypi.org/project/freesurfer-stats/\n\nPython Library to Read FreeSurfer's Cortical Parcellation Anatomical Statistics\n`subject/stats/[rl]h.aparc.*.stats`\n\nFreesurfer https://surfer.nmr.mgh.harvard.edu/\n\nInstall\n-------\n\n.. code:: sh\n\n pip3 install --user freesurfer-stats\n\nReleases follow the `semantic versioning ` scheme.\n\nUsage\n-----\n\n.. code:: python\n\n >>> from freesurfer_stats import CorticalParcellationStats\n >>> stats = CorticalParcellationStats.read('tests/subjects/fabian/stats/lh.aparc.DKTatlas.stats')\n >>> stats.headers['subjectname']\n 'fabian'\n >>> stats.headers['CreationTime'].isoformat()\n '2019-05-09T21:05:54+00:00'\n >>> stats.headers['cvs_version']\n 'Id: mris_anatomical_stats.c,v 1.79 2016/03/14 15:15:34 greve Exp'\n >>> stats.headers['cmdline'][:64]\n 'mris_anatomical_stats -th3 -mgz -cortex ../label/lh.cortex.label'\n >>> stats.hemisphere\n 'left'\n >>> stats.whole_brain_measurements['estimated_total_intracranial_volume_mm^3']\n 0 1.670487e+06\n Name: estimated_total_intracranial_volume_mm^3, dtype: float64\n >>> stats.whole_brain_measurements['white_surface_total_area_mm^2']\n 0 98553\n Name: white_surface_total_area_mm^2, dtype: int64\n >>> stats.structural_measurements[['structure_name', 'surface_area_mm^2',\n ... 'gray_matter_volume_mm^3']].head()\n structure_name surface_area_mm^2 gray_matter_volume_mm^3\n 0 caudalanteriorcingulate 1472 4258\n 1 caudalmiddlefrontal 3039 8239\n 2 cuneus 2597 6722\n 3 entorhinal 499 2379\n 4 fusiform 3079 9064\n\nLoad Multiple Stats Files\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n >>> import glob, pandas\n >>> from freesurfer_stats import CorticalParcellationStats\n >>> def load_whole_brain_measurements(stats_path) -> pandas.DataFrame:\n ... stats = CorticalParcellationStats.read(stats_path)\n ... stats.whole_brain_measurements['subject'] = stats.headers['subjectname']\n ... stats.whole_brain_measurements['source_basename'] = os.path.basename(stats_path)\n ... stats.whole_brain_measurements['hemisphere'] = stats.hemisphere\n ... return stats.whole_brain_measurements\n ...\n >>> whole_brain_measurements = pandas.concat(\n ... map(load_whole_brain_measurements, glob.glob('tests/subjects/fabian/stats/*h.aparc*.stats')),\n ... sort=False)\n >>> whole_brain_measurements.reset_index(drop=True, inplace=True)\n >>> whole_brain_measurements[['subject', 'source_basename', 'hemisphere',\n ... 'white_surface_total_area_mm^2', 'pial_surface_total_area_mm^2']]\n subject source_basename hemisphere white_surface_total_area_mm^2 pial_surface_total_area_mm^2\n 0 fabian lh.aparc.DKTatlas.stats left 98553.0 NaN\n 1 fabian rh.aparc.stats right 99468.9 NaN\n 2 fabian rh.aparc.a2009s.stats right 99494.9 NaN\n 3 fabian rh.aparc.DKTatlas.stats right 99494.9 NaN\n 4 fabian lh.aparc.stats left 98536.5 NaN\n 5 fabian lh.aparc.pial.stats left NaN 118601.0\n 6 fabian rh.aparc.pial.stats right NaN 121260.0\n 7 fabian lh.aparc.a2009s.stats left 98553.0 NaN\n >>>\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fphammerle/freesurfer-stats", "keywords": "anatomy,aparc,area,brain,cortex,dataframe,freesurfer,mris_anatomical_stats,neuroimaging,pandas,parcellation,reader,statistics,surface,volume", "license": "", "maintainer": "", "maintainer_email": "", "name": "freesurfer-stats", "package_url": "https://pypi.org/project/freesurfer-stats/", "platform": "", "project_url": "https://pypi.org/project/freesurfer-stats/", "project_urls": { "Homepage": "https://github.com/fphammerle/freesurfer-stats" }, "release_url": "https://pypi.org/project/freesurfer-stats/1.0.0/", "requires_dist": [ "pandas (<1,>=0.21)" ], "requires_python": "", "summary": "Python Library to Read FreeSurfer's cortical parcellation anatomical statistics", "version": "1.0.0" }, "last_serial": 5455777, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "0855335b1846e999de4b312ab289a072", "sha256": "504d94ac321ac151a0f252c556317a2924409abaf1904791e7fb0dba7741d31f" }, "downloads": -1, "filename": "freesurfer_stats-1.0.0-py3-none-any.whl", "has_sig": true, "md5_digest": "0855335b1846e999de4b312ab289a072", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7520, "upload_time": "2019-06-27T08:33:02", "url": "https://files.pythonhosted.org/packages/fb/06/77efcb9901f51ddba9b564cf121bce910e4ad3db097c93a4a6d4b72a622b/freesurfer_stats-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "533c613ee686bbd908e8b9f988f4a63d", "sha256": "285d7247b39ea1d7dbc566746d2016432b97dad031aa6c28b2181775177e3a76" }, "downloads": -1, "filename": "freesurfer-stats-1.0.0.tar.gz", "has_sig": true, "md5_digest": "533c613ee686bbd908e8b9f988f4a63d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26434, "upload_time": "2019-06-27T08:33:07", "url": "https://files.pythonhosted.org/packages/ce/0e/1e65e066f898c86c9d51a88a9d243d530ab9decf4784d176c55edfe9f35d/freesurfer-stats-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0855335b1846e999de4b312ab289a072", "sha256": "504d94ac321ac151a0f252c556317a2924409abaf1904791e7fb0dba7741d31f" }, "downloads": -1, "filename": "freesurfer_stats-1.0.0-py3-none-any.whl", "has_sig": true, "md5_digest": "0855335b1846e999de4b312ab289a072", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7520, "upload_time": "2019-06-27T08:33:02", "url": "https://files.pythonhosted.org/packages/fb/06/77efcb9901f51ddba9b564cf121bce910e4ad3db097c93a4a6d4b72a622b/freesurfer_stats-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "533c613ee686bbd908e8b9f988f4a63d", "sha256": "285d7247b39ea1d7dbc566746d2016432b97dad031aa6c28b2181775177e3a76" }, "downloads": -1, "filename": "freesurfer-stats-1.0.0.tar.gz", "has_sig": true, "md5_digest": "533c613ee686bbd908e8b9f988f4a63d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26434, "upload_time": "2019-06-27T08:33:07", "url": "https://files.pythonhosted.org/packages/ce/0e/1e65e066f898c86c9d51a88a9d243d530ab9decf4784d176c55edfe9f35d/freesurfer-stats-1.0.0.tar.gz" } ] }