cortix


Namecortix JSON
Version 1.1.63 PyPI version JSON
download
home_pagehttps://cortix.org
SummaryCortix is a Python library for network dynamics modeling and HPC simulation.
upload_time2024-12-19 06:18:26
maintainerNone
docs_urlNone
authorCortix Computing
requires_python>=3.09
licenseNone
keywords simulation math
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Cortix
A Python library for network dynamics modeling and HPC simulation.
  + [Cortix on Jupyter notebook examples](https://github.com/dpploy/cortix-nb)
  + [Documentation on the web](https://cortix.org)

![Website](https://img.shields.io/website/https/github.com/dpploy/cortix.svg)
[![Repo Size](https://img.shields.io/github/repo-size/dpploy/cortix.svg?style=flat)](https://cortix.org)
[![PyPI version](https://badge.fury.io/py/cortix.svg)](https://badge.fury.io/py/cortix)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Django.svg)](https://badge.fury.io/py/cortix)

[![codecov](https://codecov.io/gh/dpploy/cortix/branch/master/graph/badge.svg)](https://codecov.io/gh/dpploy/cortix)

![](cortix/docs/cortix-cover.png)

## What is Cortix?

* Cortix is a massively parallel Python library for system-level module coupling, execution, and
  analysis of dynamical system models that exchange time-dependent data.
* Cortix takes as input a collection of computational modules and provides an 
  environment for the coupling of these modules into a single simulation.
* Cortix supports:
    - Module decoupling
    - Communication between modules
    - Data visualization
* Cortix runs on top of [MPI](https://www.open-mpi.org/) and scales across many cores.


## Installation: start by installing [MPI](https://www.open-mpi.org/)

## Installing via PyPI
```
pip install --user cortix
```
if updating to a new version, you may need to specify the version
```
pip install --user cortix=="<version>"
```
NB: this will not install the GraphViz executables but only the python wrapper. Install the GraphViz library on your system by yourself.
## Installing via Conda
In a `Anaconda` environment (MacOS terminal conda, or Windows Anaconda powershell) do:
```
pip install cortix
conda install graphviz
```
if updating to a new version, you may need to specify the version
```
pip install cortix=="<version>"
```
## Installing from source
1. Clone this repository to install the latest version of Cortix 
```
git clone https://github.com/dpploy/cortix.git
```
2. Install the required dependencies listed in `requirements.txt`
```
pip install --user -r cortix/requirements.txt
```
3. Add ```cortix```'s parent path to your ```$PYTHONPATH``` variable
```
export PYTHONPATH=$PYTHONPATH:$(pwd)
```
Note: you may want to add this line to your ```.bashrc``` in order for it to be persistent

### Verify your Cortix install by running the Droplet example
```
mpiexec -n xx examples/run_droplet_swirl.py
```
where xx is the number of MPI processes which must match the number of modules plus 1. If there are
10 droplets and 1 vortex, use $xx = 12$.

## Testing

Testing is facilitated by [PyTest](http://pytest.org). Tests can be run locally from within the `tests` directory
```
cd tests && py.test
```

## Using Cortix

Please refer to the [documentation](https://cortix.org/contents.html) for more on getting started!

## Team 

- Valmor F. de Almeida: valmor\_dealmeida@uml.edu
- Taha M. Azzaoui: tazzaoui@cs.uml.edu
- Seamus D. Gallagher: seamus\_gallagher@student.uml.edu
- Austin Rotker: austin_rotker@student.uml.edu
- Gilberto E. Alas: gilberto\_alas@student.uml.edu

## Contributing

Pull requests are welcome. For major changes, please open an [issue](https://github.com/dpploy/cortix/issues) first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## Location 

Cortix Group

c/o [UMass Innovation Hub](https://www.uml.edu/Innovation-Hub/)

110 Canal St., 3rd Floor

Lowell, MA  01852

            

Raw data

            {
    "_id": null,
    "home_page": "https://cortix.org",
    "name": "cortix",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.09",
    "maintainer_email": null,
    "keywords": "simulation, math",
    "author": "Cortix Computing",
    "author_email": "valmor_dealmeida@uml.edu",
    "download_url": "https://files.pythonhosted.org/packages/64/7a/472796ef57c05c9e24af5a3dba2391bbbd62f86f5d4e855a2710afe75aac/cortix-1.1.63.tar.gz",
    "platform": null,
    "description": "# Cortix\nA Python library for network dynamics modeling and HPC simulation.\n  + [Cortix on Jupyter notebook examples](https://github.com/dpploy/cortix-nb)\n  + [Documentation on the web](https://cortix.org)\n\n![Website](https://img.shields.io/website/https/github.com/dpploy/cortix.svg)\n[![Repo Size](https://img.shields.io/github/repo-size/dpploy/cortix.svg?style=flat)](https://cortix.org)\n[![PyPI version](https://badge.fury.io/py/cortix.svg)](https://badge.fury.io/py/cortix)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Django.svg)](https://badge.fury.io/py/cortix)\n\n[![codecov](https://codecov.io/gh/dpploy/cortix/branch/master/graph/badge.svg)](https://codecov.io/gh/dpploy/cortix)\n\n![](cortix/docs/cortix-cover.png)\n\n## What is Cortix?\n\n* Cortix is a massively parallel Python library for system-level module coupling, execution, and\n  analysis of dynamical system models that exchange time-dependent data.\n* Cortix takes as input a collection of computational modules and provides an \n  environment for the coupling of these modules into a single simulation.\n* Cortix supports:\n    - Module decoupling\n    - Communication between modules\n    - Data visualization\n* Cortix runs on top of [MPI](https://www.open-mpi.org/) and scales across many cores.\n\n\n## Installation: start by installing [MPI](https://www.open-mpi.org/)\n\n## Installing via PyPI\n```\npip install --user cortix\n```\nif updating to a new version, you may need to specify the version\n```\npip install --user cortix==\"<version>\"\n```\nNB: this will not install the GraphViz executables but only the python wrapper. Install the GraphViz library on your system by yourself.\n## Installing via Conda\nIn a `Anaconda` environment (MacOS terminal conda, or Windows Anaconda powershell) do:\n```\npip install cortix\nconda install graphviz\n```\nif updating to a new version, you may need to specify the version\n```\npip install cortix==\"<version>\"\n```\n## Installing from source\n1. Clone this repository to install the latest version of Cortix \n```\ngit clone https://github.com/dpploy/cortix.git\n```\n2. Install the required dependencies listed in `requirements.txt`\n```\npip install --user -r cortix/requirements.txt\n```\n3. Add ```cortix```'s parent path to your ```$PYTHONPATH``` variable\n```\nexport PYTHONPATH=$PYTHONPATH:$(pwd)\n```\nNote: you may want to add this line to your ```.bashrc``` in order for it to be persistent\n\n### Verify your Cortix install by running the Droplet example\n```\nmpiexec -n xx examples/run_droplet_swirl.py\n```\nwhere xx is the number of MPI processes which must match the number of modules plus 1. If there are\n10 droplets and 1 vortex, use $xx = 12$.\n\n## Testing\n\nTesting is facilitated by [PyTest](http://pytest.org). Tests can be run locally from within the `tests` directory\n```\ncd tests && py.test\n```\n\n## Using Cortix\n\nPlease refer to the [documentation](https://cortix.org/contents.html) for more on getting started!\n\n## Team \n\n- Valmor F. de Almeida: valmor\\_dealmeida@uml.edu\n- Taha M. Azzaoui: tazzaoui@cs.uml.edu\n- Seamus D. Gallagher: seamus\\_gallagher@student.uml.edu\n- Austin Rotker: austin_rotker@student.uml.edu\n- Gilberto E. Alas: gilberto\\_alas@student.uml.edu\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an [issue](https://github.com/dpploy/cortix/issues) first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## Location \n\nCortix Group\n\nc/o [UMass Innovation Hub](https://www.uml.edu/Innovation-Hub/)\n\n110 Canal St., 3rd Floor\n\nLowell, MA  01852\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Cortix is a Python library for network dynamics modeling and HPC simulation.",
    "version": "1.1.63",
    "project_urls": {
        "Homepage": "https://cortix.org"
    },
    "split_keywords": [
        "simulation",
        " math"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "42683838e2e5014686389b915dea0d091b0a813c034f87e3e90fef6181677d08",
                "md5": "b3ddc7eb2da5eee0543419fad49f9cf7",
                "sha256": "15b1f5977145d998320e09a30bea37049e625cdb76ba89f4d9e771265c29e20e"
            },
            "downloads": -1,
            "filename": "cortix-1.1.63-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b3ddc7eb2da5eee0543419fad49f9cf7",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.09",
            "size": 577651,
            "upload_time": "2024-12-19T06:18:23",
            "upload_time_iso_8601": "2024-12-19T06:18:23.798358Z",
            "url": "https://files.pythonhosted.org/packages/42/68/3838e2e5014686389b915dea0d091b0a813c034f87e3e90fef6181677d08/cortix-1.1.63-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "647a472796ef57c05c9e24af5a3dba2391bbbd62f86f5d4e855a2710afe75aac",
                "md5": "e04f84ec41d71f757ed797cf7e750fc7",
                "sha256": "59bcfe3e60e153753a2dc712423bd0db9122edf64989e280963dc3c5b1be9bca"
            },
            "downloads": -1,
            "filename": "cortix-1.1.63.tar.gz",
            "has_sig": false,
            "md5_digest": "e04f84ec41d71f757ed797cf7e750fc7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.09",
            "size": 523955,
            "upload_time": "2024-12-19T06:18:26",
            "upload_time_iso_8601": "2024-12-19T06:18:26.787216Z",
            "url": "https://files.pythonhosted.org/packages/64/7a/472796ef57c05c9e24af5a3dba2391bbbd62f86f5d4e855a2710afe75aac/cortix-1.1.63.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-19 06:18:26",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "cortix"
}
        
Elapsed time: 0.40322s