{ "info": { "author": "NetworkUnit authors and contributors", "author_email": "r.gutzen@fz-juelich.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering" ], "description": "===========\nNetworkUnit\n===========\n\nA SciUnit_ library for validation testing of spiking networks.\n\n.. _SciUnit: https://github.com/scidash/sciunit\n\n.. image:: https://mybinder.org/badge.svg\n :target: https://mybinder.org/v2/gh/INM-6/NetworkUnit/master?filepath=examples%2Findex.ipynb\n :alt: Binder Link\n\n.. role:: py(code)\n :language: python\n\nInstallation\n------------\n\n.. code:: bash\n\n pip install networkunit\n\nConcept\n-------\nThe NetworkUnit module builds upon the formalized validation scheme of the SciUnit package,\nwhich enables the validation of *models* against experimental data (or other models) via *tests*.\nA test is matched to the model by *capabilities* and quantitatively evaluated by a *score*.\nThe following figure illustrates a typical test design within NetworkUnit.\nThe blue boxes indicate the components of the implementation of the validation test, i.e.,\nclasses, class instances, data sets, and parameters.\nThe relation between the boxes are indicated by annotated arrows.The basic functionality is\nshown by green arrows. The difference in the test design for comparing against experimental\ndata (validation) and another simulation (substantiation) is indicated by yellow and\nred arrows, respectively. The relevant functionality of some components for the\ncomputation of test score is indicated by pseudo-code. The capability\nclass :py:`ProducesProperty` contains the function :py:`calc_property()`. The test :py:`XYTest` has a function\n:py:`generate_prediction()` which makes use of this capability, inherited by the model class,\nto generate a model prediction. The initialized test instance :py:`XYTest_paramZ` makes use of its\n:py:`judge()` function to evaluate this model prediction and compute the score :py:`TestScore`.\nThe :py:`XYTest` can inherit from multiple abstract test classes (:py:`BaseTest`),\nwhich is for example used with the :py:`M2MTest` to add the functionality of evaluating multiple model classes.\nTo make the test executable it has to be linked to a ScoreType and all free parameters need to be set\n(by a :py:`Params` dict) to ensure a reproducible result.\n\n.. image:: https://raw.githubusercontent.com/INM-6/NetworkUnit/master/figures/NetworkUnit_Flowchart_X2M_M2M.png\n :width: 500\n :alt: NetworkUnit Flowchart\n\nShowcase examples on how to use NetworkUnit can be found `in this repository`_ and interactive reveal.js slides are\naccessible via the launch-binder button at the top.\n\n.. _`in this repository`: https://web.gin.g-node.org/INM-6/network_validation\n\nOverview of tests\n-----------------\n=================================== ======================= ===================================================\nClass name Parent class Prediction measure\n=================================== ======================= ===================================================\ntwo_sample_test \\- \\-\ncorrelation_test two_sample_test \\-\ncorrelation_dist_test correlation_test correlation coefficients\ncorrelation_matrix_test correlation_test correlation coefficient matrix\ngeneralized_correlation_matrix_test correlation_matrix_test matrix of derived cross-correlation measures\neigenvalue_test correlation_test eigenvalues of the correlation coefficient matrix\ncovariance_test two_sample_test covariances\nfiring_rate_test two_sample_test firing rates\nisi_variation_test two_sample_test inter-spike-intervals, their CV, or LV\ngraph_centrality_helperclass sciunit.Test graph centrality measures of given adjacency matrix\n=================================== ======================= ===================================================\n\nInheritance order in case of multiple inheritance for derived test classes:\n\n.. code:: python\n\n class new_test(sciunit.TestM2M, graph_centrality_helperclass, )\n\n\nOverview of scores\n------------------\n\n================ =============================== ===================\nClass name Test name Comparison measure\n================ =============================== ===================\nstudents_t Student't test sample mean\nks_distance Kolmogorov-Smirnov test sample distribution\nkl_divergence Kullback-Leibler divergence sample entropy\nmwu_statistic Mann-Whitney U test rank sum\nlevene_score Levene's test sample variance\neffect_size Effect size standardized mean\nbest_effect_size Bayesian estimation effect size standardized mean\n================ =============================== ===================\n\nOverview of model classes\n-------------------------\n\n=================== =================== =============== ==================================\nModel name Capability Parent class Purpose\n=================== =================== =============== ==================================\nloaded_data \\- sciunit.Model loading simulated data\nspiketrain_data ProducesSpikeTrains simulation_data loading simulated spiking data\nstochastic_activity ProducesSpikeTrains sciunit.Model generating stochastic spiking data\n=================== =================== =============== ==================================\n\nOther validation test repositories\n----------------------------------\n\n- NeuronUnit_\n- HippoUnit_\n- BasalUnit_\n- MorphoUnit_\n- CerebellumUnit_\n\n.. _NeuronUnit: https://github.com/BlueBrain/neuronunit\n.. _HippoUnit: https://github.com/apdavison/hippounit\n.. _BasalUnit: https://github.com/appukuttan-shailesh/basalunit\n.. _MorphoUnit: https://github.com/appukuttan-shailesh/morphounit\n.. _CerebellumUnit: https://github.com/lungsi/cerebellum-unit\n\n\nAcknowledgments\n---------------\nThis open source software code was developed in part or in whole in the Human Brain Project, funded from the European Union\u2019s Horizon 2020 Framework Programme for Research and Innovation under Specific Grant Agreements No. 720270 and No. 785907 (Human Brain Project SGA1 and SGA2).\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/INM-6/NetworkUnit", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "networkunit", "package_url": "https://pypi.org/project/networkunit/", "platform": "", "project_url": "https://pypi.org/project/networkunit/", "project_urls": { "Homepage": "https://github.com/INM-6/NetworkUnit" }, "release_url": "https://pypi.org/project/networkunit/0.1.1/", "requires_dist": [ "elephant (>=0.5.0)", "sciunit (>=0.2.1)", "jupyter (>=1.0.0)", "tabulate (>=0.8.2)", "networkx (>=2.1)", "seaborn (>=0.8.1)", "numpy (>=1.15.3)", "odml (>=1.3.0)" ], "requires_python": "", "summary": "A SciUnit library for validation testing of neural network models.", "version": "0.1.1" }, "last_serial": 5759330, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "e6eef4932b79dfbf0e104e5f09f7e610", "sha256": "91dd909169451ffdcead2193346438fd62efe0ba3b58321fc8b00a20853ba764" }, "downloads": -1, "filename": "networkunit-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e6eef4932b79dfbf0e104e5f09f7e610", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 328259, "upload_time": "2018-11-06T13:53:59", "url": "https://files.pythonhosted.org/packages/6d/5c/8cb5a976653ed240b42965cae423b31063d52f3e81bb290b0a598d8ee078/networkunit-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8a9bd5df953b383111219271bd090c7c", "sha256": "2e8ae4417d927a92e0860ee79c4581811378d8c179b5202c65f501decf0848f9" }, "downloads": -1, "filename": "networkunit-0.1.0.tar.gz", "has_sig": false, "md5_digest": "8a9bd5df953b383111219271bd090c7c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 312667, "upload_time": "2018-11-06T13:54:01", "url": "https://files.pythonhosted.org/packages/08/da/3545c0dd8f5fb70bec81c5e58fd63341d67aff4c16ce227a82d54626032e/networkunit-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "6f8a029a3685b412e8bb7cfc544b016b", "sha256": "71771b6aaa4e8cbfe9565a5ee2fd182f61506cdd19f086b1021a9b5d160d2ae8" }, "downloads": -1, "filename": "networkunit-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "6f8a029a3685b412e8bb7cfc544b016b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 2552921, "upload_time": "2019-08-30T09:28:56", "url": "https://files.pythonhosted.org/packages/c9/c0/c97a69909d23c8ec198a5fa76732e4943e2efba16aabdaefa8813ca6eb66/networkunit-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e4aa74455d6ce8203391480d44398699", "sha256": "32489273c240867e35c1d226c3037648bc39a1fcc5b32ee2176a8df3691389d3" }, "downloads": -1, "filename": "networkunit-0.1.1.tar.gz", "has_sig": false, "md5_digest": "e4aa74455d6ce8203391480d44398699", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2533337, "upload_time": "2019-08-30T09:28:59", "url": "https://files.pythonhosted.org/packages/ae/27/f6933319e2ea012c3d60d969b4c321b91948822d36441ada72aec67e09a7/networkunit-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6f8a029a3685b412e8bb7cfc544b016b", "sha256": "71771b6aaa4e8cbfe9565a5ee2fd182f61506cdd19f086b1021a9b5d160d2ae8" }, "downloads": -1, "filename": "networkunit-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "6f8a029a3685b412e8bb7cfc544b016b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 2552921, "upload_time": "2019-08-30T09:28:56", "url": "https://files.pythonhosted.org/packages/c9/c0/c97a69909d23c8ec198a5fa76732e4943e2efba16aabdaefa8813ca6eb66/networkunit-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e4aa74455d6ce8203391480d44398699", "sha256": "32489273c240867e35c1d226c3037648bc39a1fcc5b32ee2176a8df3691389d3" }, "downloads": -1, "filename": "networkunit-0.1.1.tar.gz", "has_sig": false, "md5_digest": "e4aa74455d6ce8203391480d44398699", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2533337, "upload_time": "2019-08-30T09:28:59", "url": "https://files.pythonhosted.org/packages/ae/27/f6933319e2ea012c3d60d969b4c321b91948822d36441ada72aec67e09a7/networkunit-0.1.1.tar.gz" } ] }