neurondm


Nameneurondm JSON
Version 0.1.8 PyPI version JSON
download
home_pagehttps://github.com/tgbugs/pyontutils/tree/master/neurondm
SummaryA data model for neuron types.
upload_time2024-01-05 19:19:07
maintainer
docs_urlNone
authorTom Gillespie
requires_python>=3.6
licenseMIT
keywords neuron types nif ontology neuroscience phenotype owl rdf rdflib data model
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            # neurondm
[![PyPI version](https://badge.fury.io/py/neurondm.svg)](https://pypi.org/project/neurondm/)

A data model for neuron types.

## Neuron Types
For a an overview of how to use neuron-lang to describing neuron types please see
[this introduction](http://github.com/SciCrunch/NIF-Ontology/blob/master/docs/Neurons.md).
For a more in-depth look at the structures that neurons translate to in OWL
and some of the modelling decisions related to which reasoner you plan to use see an
[Overview of OWL modelling decisions](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/basic-model.org)

To get started, follow the installation instructions below and
then include `from neurondm.lang import *` in your import statements.

If you want to get started quickly, take a look at the notebook of
[examples of how to use neuron-lang to create new neurons](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/NeuronLangExample.ipynb)

If you want to use neurondm in a jupyter notebook, see the docs for how to
[set up neurondm for jupyter notebooks](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/neurons_notebook.md).

## Installation
You can install `neurondm` using the following commands.

### Basics
```bash
pip install neurondm
```

Once installation is complete you should be able to run the following python code.

```python
from neurondm import *
config = Config()
n = Neuron(Phenotype('TEMP:myPhenotype'))
config.write()
config.write_python()
```

### SciGraph API
Set the API key in a separate terminal to avoid losing
additional history after setting the api key.
```bash
unset HISTFILE
ontutils set scigraph-api-key <key>
```

Once that is done you should be able to run the following.
```bash
python -m neurondm.models.huang2017
```

### NIF-Ontology
To work with the NIF-Ontology and build existing models
you need to clone the ontology repository and set your
SciGraph API key or set up a local SciGraph instance.

```bash
git clone https://github.com/SciCrunch/NIF-Ontology.git
ontutils set ontology-local-repo ./NIF-Ontology
pushd ./NIF-Ontology
git checkout neurons
popd
```

### Further configuration
If you need more details on configuration see the pyontutils
[configuration](https://github.com/tgbugs/pyontutils/#configuration) section.


## Use outside the NIF ontology
It is possible to use neurondm outside the NIF ontology and the pyontutils repository,
however it has not been fully abstracted to support that use case. If you want to do something
more complicated than the example shown in the installation section you will need to perform
some additional configuration. The way to do this is to set all the relevant values via
`neurondm.Config`. See
[`test_neruons.test_roundtrip_py`](https://github.com/tgbugs/pyontutils/blob/1805879322922b3f5e78d1abcb4b6642e22c204d/neurondm/test/test_neurons.py#L55)
for an example.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/tgbugs/pyontutils/tree/master/neurondm",
    "name": "neurondm",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "neuron types NIF ontology neuroscience phenotype OWL rdf rdflib data model",
    "author": "Tom Gillespie",
    "author_email": "tgbugs@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/91/3b/43b41bb414d69c89997527e6ab20fa2408290e5e96658ffb906366dfce72/neurondm-0.1.8.tar.gz",
    "platform": null,
    "description": "# neurondm\n[![PyPI version](https://badge.fury.io/py/neurondm.svg)](https://pypi.org/project/neurondm/)\n\nA data model for neuron types.\n\n## Neuron Types\nFor a an overview of how to use neuron-lang to describing neuron types please see\n[this introduction](http://github.com/SciCrunch/NIF-Ontology/blob/master/docs/Neurons.md).\nFor a more in-depth look at the structures that neurons translate to in OWL\nand some of the modelling decisions related to which reasoner you plan to use see an\n[Overview of OWL modelling decisions](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/basic-model.org)\n\nTo get started, follow the installation instructions below and\nthen include `from neurondm.lang import *` in your import statements.\n\nIf you want to get started quickly, take a look at the notebook of\n[examples of how to use neuron-lang to create new neurons](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/NeuronLangExample.ipynb)\n\nIf you want to use neurondm in a jupyter notebook, see the docs for how to\n[set up neurondm for jupyter notebooks](https://github.com/tgbugs/pyontutils/blob/master/neurondm/docs/neurons_notebook.md).\n\n## Installation\nYou can install `neurondm` using the following commands.\n\n### Basics\n```bash\npip install neurondm\n```\n\nOnce installation is complete you should be able to run the following python code.\n\n```python\nfrom neurondm import *\nconfig = Config()\nn = Neuron(Phenotype('TEMP:myPhenotype'))\nconfig.write()\nconfig.write_python()\n```\n\n### SciGraph API\nSet the API key in a separate terminal to avoid losing\nadditional history after setting the api key.\n```bash\nunset HISTFILE\nontutils set scigraph-api-key <key>\n```\n\nOnce that is done you should be able to run the following.\n```bash\npython -m neurondm.models.huang2017\n```\n\n### NIF-Ontology\nTo work with the NIF-Ontology and build existing models\nyou need to clone the ontology repository and set your\nSciGraph API key or set up a local SciGraph instance.\n\n```bash\ngit clone https://github.com/SciCrunch/NIF-Ontology.git\nontutils set ontology-local-repo ./NIF-Ontology\npushd ./NIF-Ontology\ngit checkout neurons\npopd\n```\n\n### Further configuration\nIf you need more details on configuration see the pyontutils\n[configuration](https://github.com/tgbugs/pyontutils/#configuration) section.\n\n\n## Use outside the NIF ontology\nIt is possible to use neurondm outside the NIF ontology and the pyontutils repository,\nhowever it has not been fully abstracted to support that use case. If you want to do something\nmore complicated than the example shown in the installation section you will need to perform\nsome additional configuration. The way to do this is to set all the relevant values via\n`neurondm.Config`. See\n[`test_neruons.test_roundtrip_py`](https://github.com/tgbugs/pyontutils/blob/1805879322922b3f5e78d1abcb4b6642e22c204d/neurondm/test/test_neurons.py#L55)\nfor an example.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A data model for neuron types.",
    "version": "0.1.8",
    "project_urls": {
        "Homepage": "https://github.com/tgbugs/pyontutils/tree/master/neurondm"
    },
    "split_keywords": [
        "neuron",
        "types",
        "nif",
        "ontology",
        "neuroscience",
        "phenotype",
        "owl",
        "rdf",
        "rdflib",
        "data",
        "model"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6804dc45c8a7d4c20cecc70a70dde8440a603589f299cfe30139ca778326c143",
                "md5": "174910b94f51c7950ea3eaa8565348d3",
                "sha256": "d795c44d1402bc9d2f152fd51cbe313cfe983f8147d04a34180580cdd6f3cc68"
            },
            "downloads": -1,
            "filename": "neurondm-0.1.8-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "174910b94f51c7950ea3eaa8565348d3",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.6",
            "size": 157971,
            "upload_time": "2024-01-05T19:19:05",
            "upload_time_iso_8601": "2024-01-05T19:19:05.555508Z",
            "url": "https://files.pythonhosted.org/packages/68/04/dc45c8a7d4c20cecc70a70dde8440a603589f299cfe30139ca778326c143/neurondm-0.1.8-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "913b43b41bb414d69c89997527e6ab20fa2408290e5e96658ffb906366dfce72",
                "md5": "ee04ac4c0b49651229f66fbb6cc855ac",
                "sha256": "54de5d252ba7da2c0ba4d4e47f42fb94698dd4662f3bde59e01ada91f67a338e"
            },
            "downloads": -1,
            "filename": "neurondm-0.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "ee04ac4c0b49651229f66fbb6cc855ac",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 179679,
            "upload_time": "2024-01-05T19:19:07",
            "upload_time_iso_8601": "2024-01-05T19:19:07.220593Z",
            "url": "https://files.pythonhosted.org/packages/91/3b/43b41bb414d69c89997527e6ab20fa2408290e5e96658ffb906366dfce72/neurondm-0.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-05 19:19:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "tgbugs",
    "github_project": "pyontutils",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": false,
    "lcname": "neurondm"
}
        
Elapsed time: 3.28329s