{ "info": { "author": "Jun Zhuang @ Allen Institute for Brain Science", "author_email": "junz@alleninstitute.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "# retinotopic_mapping package\r\n\r\nby Jun Zhuang\r\n© 2016 Allen Institute\r\nemail: junz<AT>alleninstitute<DOT>org\r\n\r\nFor a more thorough introduction and explanation of the module please\r\nsee our [documentation](http://retinotopic-mapping.readthedocs.io/).\r\nIf the online version of documentation looks incomplete. Please refer\r\nto the locally built html version in `/doc/build/html/` folder under\r\n`doc` branch.\r\n\r\nThe retinotopic mapping package is a self-contained module\r\nfor display visual stimuli in visual physiology experiments and\r\nfor data analysis on the results of those experiments. This package is\r\nused to display visual stimulus and to analyze data for the study\r\nZhuang et al., 2017 (7)\r\n\r\nThe visual stimuli generation and display is implemented in the modules\r\n`MonitorSetup.py`, `StimulusRoutines.py` and `DisplayStimulus.py`.\r\nThese modules allow you to display flashing circle, sparse noise,\r\nlocally sparse noise, drifting grading circle, static grading circle\r\nand others with spherical correction. The method for spherical\r\ncorrection is the same as Marshel et al. 2011 (2). These stimulus\r\nroutines are highly customizable and designed to give the user\r\nsignificant flexibility and control in creative experimental design.\r\n\r\nPlease check the '\\examples\\visual_stimulation' folder for\r\nexample script `example_stimulation.py` of visual stimulation.\r\n\r\nOne specific analysis this package can perform is automated\r\nsegmentation of the mouse visual cortex, which is implemented in\r\n`RetinotopicMapping.py` module.\r\nThe experimental setup and analysis routine was\r\nmodified from Garrett et al. 2014 (1), and closely follows\r\nthe protocols and procedures documented in Juavinett et al. 2016\r\n(2).\r\n\r\nThe analysis takes visual altitude and azimuth maps of mouse cortex\r\nas inputs, calculates the visual sign of each pixel and auto-segments\r\nthe cortical surface into primary visual cortex and multiple higher\r\nvisual cortices. Ideally, the visual altitude and azimuth maps can be\r\ngenerated by fourier analysis of population cortical responses to\r\nperiodic sweeping checker board visual stimuli (3, 4).\r\n\r\nThe package also provides some useful plotting functions to visualize\r\nthe results.\r\n\r\nPlease check the '\\examples\\signmap_analysis' folder for a [jupyter\r\nnotebook](https://github.com/zhuangjun1981/retinotopic_mapping/blob/master/retinotopic_mapping/examples/signmap_analysis/retinotopic_mapping_example.ipynb)\r\nshowing automated visual area segmentation of mouse cortex.\r\n\r\n### Contributors:\r\n* Jun Zhuang @zhuangj\r\n* John Yearseley @yearsj\r\n* Derric Williams @derricw\r\n\r\n### Level of support\r\nWe are planning on occasional updating this tool with no fixed schedule. Community involvement is encouraged through both issues and pull requests.\r\n\r\n#### Language:\r\n\r\n1. python 2.7\r\n\r\n\r\n#### Install:\r\n```\r\ncd \r\nconda env create -f environment.yml (this will take a while)\r\nactivate retinotopic_mapping (Windows)\r\nsource activate retinotopic_mapping (Mac or Linux)\r\npython setup.py install\r\n```\r\n\r\n\r\n#### Dependencies:\r\n\r\n1. numpy, version 1.13.1 or later\r\n2. scipy, version 0.17.1 or later\r\n3. matplotlib, version 1.5.1 or later\r\n4. psychopy, version 1.85.2 or later\r\n5. pyglet, version 1.2.4 or later\r\n6. OpenCV-Python, version >= 2.4.8, <= 2.4.10\r\n7. scikit-image, version 0.12.3 or later\r\n8. PIL, version 4.3.0 or later\r\n9. PyDAQmx, version 1.3.2 or later\r\n * requires National Instruments DAQmx driver, version 15.0 or later\r\n\r\n#### References:\r\n\r\n1. Garrett ME, Nauhaus I, Marshel JH, Callaway EM (2014) Topography and areal organization of mouse visual cortex. J Neurosci 34:12587-12600.\r\n\r\n2. Juavinett AL, Nauhaus I, Garrett ME, Zhuang J, Callaway EM (2017). Automated identification of mouse visual areas with intrinsic signal imaging. Nature Protocols. 12: 32-43.\r\n\r\n3. Kalatsky VA, Stryker MP (2003) New paradigm for optical imaging: temporally encoded maps of intrinsic signal. Neuron 38:529-545.\r\n\r\n4. Marshel JH, Kaye AP, Nauhaus I, Callaway EM (2012) Anterior-posterior direction opponency in the superficial mouse lateral geniculate nucleus. Neuron 76:713-720.\r\n\r\n5. Sereno MI, Dale AM, Reppas JB, Kwong KK, Belliveau JW, Brady TJ, Rosen BR, Tootell RB (1995) Borders of multiple visual areas in humans revealed by functional magnetic resonance imaging. Science 268:889-893.\r\n\r\n6. Sereno MI, McDonald CT, Allman JM (1994) Analysis of retinotopic maps in extrastriate cortex. Cereb Cortex 4:601-620.\r\n\r\n7. Zhuang J, Ng L, Williams D, Valley M, Li Y, Garrett M, Waters J (2017) An extended retinotopic map of mouse cortex. eLife 6: e18372.\r\n\r\n\r\n#### Issues:\r\n\r\n1. Most image analysis parameters are defined as number of pixels, not microns.\r\n2. Works in windows, but not fully tested on Mac and Linux.\r\n\r\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/zhuangjun1981/retinotopic_mapping", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "retinotopic-mapping", "package_url": "https://pypi.org/project/retinotopic-mapping/", "platform": "any", "project_url": "https://pypi.org/project/retinotopic-mapping/", "project_urls": { "Homepage": "https://github.com/zhuangjun1981/retinotopic_mapping" }, "release_url": "https://pypi.org/project/retinotopic-mapping/2.7.0/", "requires_dist": [ "tifffile (==0.10.0)", "numpydoc (>=0.7.0)", "sphinx (>=1.6.3)", "psychopy (>=1.85.2)", "PyDAQmx (>=1.3.2)", "pyglet (==1.2.4)", "configobj (>=5.0.6)", "opencv-python (>=3.1.0)", "pillow", "h5py", "scikit-image", "matplotlib", "scipy", "numpy", "pytest" ], "requires_python": "", "summary": "retinotopic mapping tools", "version": "2.7.0" }, "last_serial": 3674312, "releases": { "2.2.3": [ { "comment_text": "", "digests": { "md5": "5031592650042cea56fc4a7b9abdffa0", "sha256": "fc1874d65a7cd1e232acc30b3f68a435072909cc0c7409e1da5461d1c812965d" }, "downloads": -1, "filename": "retinotopic_mapping-2.2.3.tar.gz", "has_sig": false, "md5_digest": "5031592650042cea56fc4a7b9abdffa0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 108541, "upload_time": "2017-12-07T19:52:28", "url": "https://files.pythonhosted.org/packages/17/20/e30577984faeb6671a980ef89303009510ff6cacbfa0f5eebe36e1d51951/retinotopic_mapping-2.2.3.tar.gz" } ], "2.7.0": [ { "comment_text": "", "digests": { "md5": "6627ef4102bde6339ebb48c595121c7f", "sha256": "7c995e9be20ddfe7f27ec3244efd6a36f0cacab83f8a484a301176726abd7429" }, "downloads": -1, "filename": "retinotopic_mapping-2.7.0-py2-none-any.whl", "has_sig": false, "md5_digest": "6627ef4102bde6339ebb48c595121c7f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 13057745, "upload_time": "2018-03-15T22:12:15", "url": "https://files.pythonhosted.org/packages/66/62/fa07771f2a9971e57817756f84f7029f9fbc4cab615178f6b5b18f521908/retinotopic_mapping-2.7.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ed80ab551a490f10013df032a0cbb3a5", "sha256": "62c89c60c05d69ebf1e61a1132ba55d75b5fd4ae96a6c8514547e935572e8a8f" }, "downloads": -1, "filename": "retinotopic_mapping-2.7.0.tar.gz", "has_sig": false, "md5_digest": "ed80ab551a490f10013df032a0cbb3a5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12989554, "upload_time": "2018-03-15T22:12:20", "url": "https://files.pythonhosted.org/packages/5b/09/14089170c5e6ab66302f34eb2ec28f825236ce5d39ce615aea48331c0116/retinotopic_mapping-2.7.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6627ef4102bde6339ebb48c595121c7f", "sha256": "7c995e9be20ddfe7f27ec3244efd6a36f0cacab83f8a484a301176726abd7429" }, "downloads": -1, "filename": "retinotopic_mapping-2.7.0-py2-none-any.whl", "has_sig": false, "md5_digest": "6627ef4102bde6339ebb48c595121c7f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 13057745, "upload_time": "2018-03-15T22:12:15", "url": "https://files.pythonhosted.org/packages/66/62/fa07771f2a9971e57817756f84f7029f9fbc4cab615178f6b5b18f521908/retinotopic_mapping-2.7.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ed80ab551a490f10013df032a0cbb3a5", "sha256": "62c89c60c05d69ebf1e61a1132ba55d75b5fd4ae96a6c8514547e935572e8a8f" }, "downloads": -1, "filename": "retinotopic_mapping-2.7.0.tar.gz", "has_sig": false, "md5_digest": "ed80ab551a490f10013df032a0cbb3a5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12989554, "upload_time": "2018-03-15T22:12:20", "url": "https://files.pythonhosted.org/packages/5b/09/14089170c5e6ab66302f34eb2ec28f825236ce5d39ce615aea48331c0116/retinotopic_mapping-2.7.0.tar.gz" } ] }