A package for performing whole brain simulations
Project description
TVB FRAMEWORK
The Virtual Brain framework is a complete framework including:
a plugable workflow manager;
a data persistence layer (with a relational DB and File Storage);
an HTML5 based user interface;
visualizers for neuro-science related entities.
The easiest way to make use of this code, is to obtain a Distribution of TVB with Python and all the necessary packages linked, and then clone this repo nearby. More details in our documentation.
Alternatively, if you plan to develop long term with TVB, extensively modify code, add new dependencies, or you simply prefer to use your own Python installation, you may want to read this: here.
If you don’t require the framework features listed above, the simulator and associated scientific modules can be used independently; please see the tvb-library folder.
Framework structure
tvb-gdist | | tvb-library tvb-data \ / \ / tvb.config | | tvb.core | | tvb.adapters | | tvb.config.init | | tvb.interfaces
Usage
To use TVB code, clone from GitHub (https://github.com/the-virtual-brain/tvb-framework), or get from Pypi:
pip install tvb-framework python -m tvb.interfaces.web.run WEB_PROFILE tvb.config
Your port 8080 should be free, as a CherryPy service will try to run there. Your default browser should automatically open http://localhost:8080/ which is the way to interact with TVB Web Interface.
When using from sources (pypi or Github, not TVB_Distribution), if you want BCT adapters enabled, you should manually download BCT https://sites.google.com/site/bctnet/ and set env variable BCT_PATH towards the directory where you unzip BCT, plus also have Octave or Matlab installed with command line API enabled.
Testing
For testing the package, the Pytest framework is used. Pytest can be installed using pip.
Pytest will run all files in the current directory and its subdirectories of the form test_*.py or *_test.py. More generally, it follows standard test discovery rules
The command for running our tests has two forms. Recommendation when working with a git clone of tvb-framework:
cd [folder_where_tvb_framework_is] pytest tvb/test/framework [--profile=TEST_POSTGRES_PROFILE] [--junitxml=path] # default profile value is TEST_SQLITE_PROFILE
The second alternative form of running TVB tests, when installing TVB from Pypi, is:
pip install -U tvb-framework pytest --pyargs tvb.tests.framework
Coverage
A coverage report can be generated with:
pip install pytest-cov cd [folder_where_tvb_framework_is] py.test --cov=tvb tvb/tests/ --cov-branch --cov-report xml:[file_where_xml_will_be_generated]
Further Resources
For issue tracking we are using Jira: http://req.thevirtualbrain.org
For API documentation and live demos, have a look here: http://docs.thevirtualbrain.org
A public mailing list for users of The Virtual Brain can be joined and followed using: tvb-users@googlegroups.com
Raw demo IPython Notebooks can be found under: https://github.com/the-virtual-brain/tvb-root/tree/master/tvb_documentation/demos
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tvb_framework-2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 583833253e7fcdd7f0f7f32da46a5cb7f860efebe6fbe69d81174ee985fe70a2 |
|
MD5 | f44df115e316d31eb9f5d764ebe5dd5a |
|
BLAKE2b-256 | a4388080147d4dec55128f46dc8716225f11511f824e4ace910bb3fa69714600 |