No project description provided

These details have been verified by PyPI

Project links

Homepage

GitHub Statistics

Maintainers

1fish2 abq seancheah youdonotexist

These details have not been verified by PyPI

Development Status
- 3 - Alpha
License
- OSI Approved :: MIT License
Programming Language
Topic
- Scientific/Engineering

Project description

Arrow

“... even if the previous millisecond is closer to us than the birth of the universe, it is equally out of reach.” ― Jean-Christophe Valtat, Luminous Chaos

Concept

This library implements a generalized version of the Gillespie Algorithm, a stochastic approach to numerically solving discrete systems. Each iteration, the algorithm will calculate the propensities for each reaction given a rate and the counts of the reactants present in the current state of the system, then selects one reaction to occur and the interval of time between the previous reaction and the current reaction. Iterating this produces a trajectory (or history) of the state vector over the course of the simulation.

Installation

Add the following to your requirements.txt, or run pip install stochastic-arrow to install it from PyPI:

stochastic-arrow

NOTE: If upgrading from a version older than 1.0.0, check if the arrow datetime package is installed. If so, uninstall arrow before upgrading stochastic-arrow, then reinstall arrow.

> pip show arrow
> pip uninstall arrow
> pip install stochastic-arrow
> pip install arrow

Usage

The stochastic_arrow library presents a single class as an interface, StochasticSystem, which operates on a set of reactions (encoded as a numpy matrix of stoichiometrix coefficients) and associated reaction rates:

from stochastic_arrow import StochasticSystem
import numpy as np

# Each row is a reaction and each column is a molecular species (or other
# entity). The first reaction here means that the first and second elements
# combine to create the third, while the fourth is unaffected.
stoichiometric_matrix = np.array([
    [1, 1, -1, 0],
    [-2, 0, 0, 1],
    [-1, -1, 1, 0]], np.int64)

# Once we have a matrix of reactions, we can
# construct the system.
system = StochasticSystem(stoichiometric_matrix)

Now that the system has been instantiated, we can invoke it with any initial state vector and set of reaction rates and then run it for a given time interval:

# This gives the initial state of the system (counts of each molecular species,
# for instance).
import numpy as np
state = np.array([1000, 1000, 0, 0])

# We also specify how long we want the simulation to run. Here we set it to one
# second.
duration = 1

# Each reaction has an associated rate for how probable that reaction is.
rates = np.array([3.0, 1.0, 1.0])

Once we have an initial state and rates, we can run the simulation for the given duration. evolve returns a dictionary with five keys:

steps - the number of steps the simulation took
time - at what time point each event took place
events - the events that occurred
occurrences - the number of times each event occurred (derived directly from events)
outcome - the final state of the system

result = system.evolve(duration, state, rates)

If you are interested in the history of states for plotting or otherwise, these can be derived from the list of events and the stoichiometric matrix, along with the inital state. reenact_events will do this for you:

from stochastic_arrow import reenact_events

history = reenact_events(stoichiometric_matrix, result['events'], state)

Building

> make clean compile

This builds the extension package and installs it in editable mode.

NOTE: make compile without an explicit clean might not fully build the extension.

Testing

stochastic_arrow uses pytest. To run the main tests, in the source tree:

> make test

> pytest

There are additional command line features in test_arrow:

> python -m test.test_arrow --help
> python -m test.test_arrow --complexation
> python -m test.test_arrow --complexation --runs 3
> python -m test.test_arrow --obsidian
> python -m test.test_arrow --memory
> python -m test.test_arrow --time
> python -m test.test_arrow --pickle
> python -m test.test_arrow --test-fail-flagella
> python -m test.test_arrow --test-fail-stdout
> python -m test.test_hang

This test requires installing a version of matplotlib that's compatible with the installed numpy:

> python -m test.test_arrow --plot

More examples:

> pytest -k flagella

Changelog

Version 1.1.0

Update build toolchain and automatically build/publish wheels for all major platforms and recent Python versions.
Build wheels with Numpy 2+ support

Version 1.0.0

Rename module to stochastic_arrow to avoid name conflict (Issue #51). All users must update their import statements to use stochastic_arrow instead of arrow.

Version 0.5.2

Update to Cython 0.29.34. (Cython 3.0.0 is now in beta.)

Version 0.5.1

Update to Cython 3.0.0a11 for compatibility with Python 3.11. Add arrow.pxd to work around a Cython 3.0.0 bug.
Stop using deprecated numpy.distutils to avoid warnings and prepare for its removal in Python 3.12.
Make test_arrow.py --plot compatible with Python 3.
Fix PytestReturnNotNoneWarning warnings from pytest 7.2.0.

Version 0.5.0

Add the arrow_hang unit test which catches a nasty edge-case (Issue #48), fix the bug, and make the code more robust to some other potential bugs.

Version 0.4.4

Can pickle StochasticSystem instances.

Version 0.3.0

Introduced backwards-incompatible API change for supplying rates at evolve() time rather than __init__() for StochasticSystem.

Project details

These details have been verified by PyPI

Project links

Homepage

GitHub Statistics

Maintainers

1fish2 abq seancheah youdonotexist

These details have not been verified by PyPI

Development Status
- 3 - Alpha
License
- OSI Approved :: MIT License
Programming Language
Topic
- Scientific/Engineering

Release history Release notifications | RSS feed

This version

1.1.0

Dec 12, 2024

1.0.0

Jun 30, 2023

0.5.2

Apr 9, 2023

0.5.0

Dec 22, 2021

0.4.4

Oct 29, 2021

0.4.3

Jul 15, 2020

0.4.2

Jul 12, 2020

0.4.1

Mar 29, 2020

0.4.0

Mar 5, 2020

0.3.1

Mar 4, 2020

0.3.0

Feb 12, 2020

0.2.1

Feb 11, 2020

0.2.0

Oct 16, 2019

0.1.8

Mar 4, 2019

0.1.7

Feb 26, 2019

0.1.6

Feb 26, 2019

0.1.5

Feb 24, 2019

0.1.4

Feb 1, 2019

0.1.3

Feb 1, 2019

0.1.2

Feb 1, 2019

0.1.1

Feb 1, 2019

0.1.0

Jan 31, 2019

0.0.18

Jan 31, 2019

0.0.17

Jan 31, 2019

0.0.16

Jan 26, 2019

0.0.15

Jan 23, 2019

0.0.14

Jan 23, 2019

0.0.13

Jan 23, 2019

0.0.12

Jan 11, 2019

0.0.11

Jan 7, 2019

0.0.9

Dec 21, 2018

0.0.8

Dec 21, 2018

0.0.7

Dec 21, 2018

0.0.6

Dec 21, 2018

0.0.5

Dec 21, 2018

0.0.4

Dec 21, 2018

0.0.3

Dec 19, 2018

0.0.2

Dec 17, 2018

0.0.1

Dec 17, 2018

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stochastic_arrow-1.1.0.tar.gz (22.0 kB view details)

Uploaded Dec 12, 2024 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

stochastic_arrow-1.1.0-cp313-cp313t-win_amd64.whl (94.6 kB view details)

Uploaded Dec 12, 2024 CPython 3.13tWindows x86-64

stochastic_arrow-1.1.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (510.8 kB view details)

Uploaded Dec 12, 2024 CPython 3.13tmanylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp313-cp313t-macosx_11_0_arm64.whl (93.3 kB view details)

Uploaded Dec 12, 2024 CPython 3.13tmacOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp313-cp313t-macosx_10_13_x86_64.whl (97.7 kB view details)

Uploaded Dec 12, 2024 CPython 3.13tmacOS 10.13+ x86-64

stochastic_arrow-1.1.0-cp313-cp313-win_amd64.whl (84.0 kB view details)

Uploaded Dec 12, 2024 CPython 3.13Windows x86-64

stochastic_arrow-1.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (493.3 kB view details)

Uploaded Dec 12, 2024 CPython 3.13manylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp313-cp313-macosx_11_0_arm64.whl (87.5 kB view details)

Uploaded Dec 12, 2024 CPython 3.13macOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp313-cp313-macosx_10_13_x86_64.whl (92.8 kB view details)

Uploaded Dec 12, 2024 CPython 3.13macOS 10.13+ x86-64

stochastic_arrow-1.1.0-cp312-cp312-win_amd64.whl (90.5 kB view details)

Uploaded Dec 12, 2024 CPython 3.12Windows x86-64

stochastic_arrow-1.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (513.9 kB view details)

Uploaded Dec 12, 2024 CPython 3.12manylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp312-cp312-macosx_11_0_arm64.whl (93.8 kB view details)

Uploaded Dec 12, 2024 CPython 3.12macOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp312-cp312-macosx_10_13_x86_64.whl (99.4 kB view details)

Uploaded Dec 12, 2024 CPython 3.12macOS 10.13+ x86-64

stochastic_arrow-1.1.0-cp311-cp311-win_amd64.whl (89.5 kB view details)

Uploaded Dec 12, 2024 CPython 3.11Windows x86-64

stochastic_arrow-1.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (521.2 kB view details)

Uploaded Dec 12, 2024 CPython 3.11manylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp311-cp311-macosx_11_0_arm64.whl (92.7 kB view details)

Uploaded Dec 12, 2024 CPython 3.11macOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp311-cp311-macosx_10_9_x86_64.whl (97.5 kB view details)

Uploaded Dec 12, 2024 CPython 3.11macOS 10.9+ x86-64

stochastic_arrow-1.1.0-cp310-cp310-win_amd64.whl (89.4 kB view details)

Uploaded Dec 12, 2024 CPython 3.10Windows x86-64

stochastic_arrow-1.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (483.1 kB view details)

Uploaded Dec 12, 2024 CPython 3.10manylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp310-cp310-macosx_11_0_arm64.whl (92.7 kB view details)

Uploaded Dec 12, 2024 CPython 3.10macOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp310-cp310-macosx_10_9_x86_64.whl (97.4 kB view details)

Uploaded Dec 12, 2024 CPython 3.10macOS 10.9+ x86-64

stochastic_arrow-1.1.0-cp39-cp39-win_amd64.whl (90.0 kB view details)

Uploaded Dec 12, 2024 CPython 3.9Windows x86-64

stochastic_arrow-1.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (485.8 kB view details)

Uploaded Dec 12, 2024 CPython 3.9manylinux: glibc 2.17+ x86-64

stochastic_arrow-1.1.0-cp39-cp39-macosx_11_0_arm64.whl (93.3 kB view details)

Uploaded Dec 12, 2024 CPython 3.9macOS 11.0+ ARM64

stochastic_arrow-1.1.0-cp39-cp39-macosx_10_9_x86_64.whl (97.9 kB view details)

Uploaded Dec 12, 2024 CPython 3.9macOS 10.9+ x86-64

File details

Details for the file stochastic_arrow-1.1.0.tar.gz.

File metadata

Download URL: stochastic_arrow-1.1.0.tar.gz
Upload date: Dec 12, 2024
Size: 22.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for stochastic_arrow-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`4b8b21ac2873673a97442439b4681963917230b54110b88282a7cff4d4a9dd8c`
MD5	`86757d6b14ae0131f6d9eaf8187d690d`
BLAKE2b-256	`749fff40066fb2795eb8ede816d35e274f3e14e8e0f6eb5cfe8a36e7371dd735`

Algorithm	Hash digest
SHA256	`e63e523c5b6da100de7794e14481325f7115d245672ebc2a13598d7fb6390f38`
MD5	`56c4f59df3eb4629232178e38bcac16f`
BLAKE2b-256	`2e262adca3335e507c61a43470634972e46d6f4c06320e9a4a1eaae089f56696`

Algorithm	Hash digest
SHA256	`f1a4c1d588f7eb54157e97990795584223b7097f660dfd7e4489642a554de1a3`
MD5	`3266e26fc8a3964525f6211e7c9ae3d9`
BLAKE2b-256	`7aef158f911a30fc9491069e525f54965a4d107f98d8045cc0728755e0982f0f`

Algorithm	Hash digest
SHA256	`641731ee7998cce3434d53a051f917b25067facc5e5f611fb222a74fcde9a550`
MD5	`cfe761444749df72186d1028b4672524`
BLAKE2b-256	`33999512d472201f537df1d211d7c544462f0caa57874683cfd88efbefe00e08`

Algorithm	Hash digest
SHA256	`3abe2064fecdf944cc1383e956468b954a68035aaf37d1540265d0bb36f15404`
MD5	`9f01e488b5fa42f66790d4a0ac3d6961`
BLAKE2b-256	`1e5c39985945b96477ab9f4fa1068350a920113d630008fdf4a50055f3ae28a1`

Algorithm	Hash digest
SHA256	`b48cd692f1e496525b3ebf624e17cc19bc50dfa8d516afe2259b19892c14abe8`
MD5	`cc4632b6e3e358653aa4ac9646726e11`
BLAKE2b-256	`71575aef141d2fbdb5b13ea479debff156130d4e1e1b876df4bd2d6c18adf449`

Algorithm	Hash digest
SHA256	`801aadb34316950846534427217d195233b7f9528818e42b68775f852c54f7c5`
MD5	`ca8b96d7d5cd3fb0fd582bfeb1b5f099`
BLAKE2b-256	`3d7af715de71af2825654c232a14e9cce6e52e8d390189188f88f2b36a170c14`

Algorithm	Hash digest
SHA256	`b58d85ea53f219101e0f8344ceb8e4250fc333b66930ae00a586803a8fb164d1`
MD5	`8b7f1658f1381efefe7396172b12e56b`
BLAKE2b-256	`0922a1149d5a8e2c9d535e4aafcd1fb16deffb4f0f070351f3d79ba156f30299`

Algorithm	Hash digest
SHA256	`f05893d012bb85927f0b84e97b8175e4a53e9f4b617b17a6ede2f0b48d3be2dc`
MD5	`42efdcc362a3186575b59492b36e0bf0`
BLAKE2b-256	`6c6afd44370f2ef8eb31a82a690a7a1c69e75293fdbef495e60511e84a102485`

Algorithm	Hash digest
SHA256	`f07ae6ffeee5c2a330778a1a8bdbf41b7a73235b3bc02a0fe6f265ebcaf1d63c`
MD5	`02b92435a4c45654b92bbe0f18ffd615`
BLAKE2b-256	`2af50534ec782efec47cf575b944a378065ed7890e8ea670f807d311694a53aa`

Algorithm	Hash digest
SHA256	`2886367f77e796589d2c0d91c4efe50af1006dc8e6f2a885aa9befe609e9e381`
MD5	`3146ce7bd6c08a4a057e4f7c10e48290`
BLAKE2b-256	`833ceec2529c87dd022e3cf537dfabd32ea0084f8029eb2e560930c78ee7b805`

Algorithm	Hash digest
SHA256	`097da7d5cfc54209ab74b735c80c5ae5b9c296949e2564feb9647619d142365f`
MD5	`656d3b8c18af8e57f60b3070e294c79d`
BLAKE2b-256	`4f87be7b45e55562e32432ac67ebc324f53b6a06f6f31fb284ffea991dc147ae`

Algorithm	Hash digest
SHA256	`cc02ae5216008ca88c5b15b0c1ae9912ea5c450927de804f67c9295874057791`
MD5	`5b8c515f69acab8ae449ff22e528d8af`
BLAKE2b-256	`7322897f62ad220c5e7c67d5cd17798231a90965d714f5e5651adef309fb0ebf`

Algorithm	Hash digest
SHA256	`7c2810fbf3afd5d97d6337d3da668416f0eea2a2e6ebdf02baaeef8fd9980fb0`
MD5	`51f16e9b08f387db26e9ecddb98393de`
BLAKE2b-256	`7e18c8c6a44f5564e370e142cc2719bcc1f66f4b841aa2d110c3cc993127b390`

Algorithm	Hash digest
SHA256	`0335709c093173407121fbd01d319a5d187c1031fbdda4f017c7c531a94f3ec6`
MD5	`06604ffb5e046517f7947d71974064fc`
BLAKE2b-256	`d32fa922a0c34dd308f1816654b6743e957df3202e9fede3921c2a4d7a26f017`

Algorithm	Hash digest
SHA256	`d8014755b71a88e5f02858f31585cbaa379371c34629d754d5d4d6ae85128fc3`
MD5	`6c3e2dd89b49d8aecbf695b1c5915e59`
BLAKE2b-256	`4346aec4cd2784f77b6b55e0de169c6961711efbd6798abf7875fc15332dfd91`

Algorithm	Hash digest
SHA256	`b19079f2b49eefd3c4f87036b631fb995cecb5cc662bc3e15662e2a361b2ea81`
MD5	`8a721200a497f3fbde24a18e232f53ec`
BLAKE2b-256	`1b03dd3b283ddac7ef9c9b6ba8401ae4b9b593d01c64f684098a36e07521c9e1`

Algorithm	Hash digest
SHA256	`6683bf5c9f4cb38e5092f6982d4358bec72ed297041461bbc903b7be28128ff4`
MD5	`e20529667838acb8bd51d3c581818867`
BLAKE2b-256	`a888efb4005b339b18693caf7592b09ad95b59fc91801db8336554fcc7d446c3`

Algorithm	Hash digest
SHA256	`ae89e9145a636b8bd11c306161b55c1bef37bf617520c47782373fd64cf2fce6`
MD5	`04b902e35b10bcefdb3bc17dc0621e1e`
BLAKE2b-256	`efb95331a6ae5618f73e4f59c6b9fa41f677b672eb82cdd3e5f320e17d151783`

Algorithm	Hash digest
SHA256	`4e6dcbe7216184c5cc9f8652b8833927cc8bd842f57a872e50dbe24bda7e6553`
MD5	`c9b45a5efdf4b21b66554c82d8e20b80`
BLAKE2b-256	`34c7cf4515cd746884f19c417a961692e1a6854e0b1455c69ede737a3e394572`

Algorithm	Hash digest
SHA256	`97112391abcc3826b1723e0b01752611df5446170228f0f834fc57ea260b7e1f`
MD5	`113635d5fd0982eb3a5a94b8706e0679`
BLAKE2b-256	`e9a270c9577e33c405babd3240b2eba975604f49253962f30feb86164b588709`

stochastic-arrow 1.1.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

Arrow

Concept

Installation

Usage

Building

Testing

Changelog

Version 1.1.0

Version 1.0.0

Version 0.5.2

Version 0.5.1

Version 0.5.0

Version 0.4.4

Version 0.3.0

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Algorithm	Hash digest
SHA256	`5478f969ceabaa7650e17d11ca3ed827f6f0bfbbd9fe6881e931b20eee0921b0`
MD5	`ab680da844f8436dca79bdbbd0482fd9`
BLAKE2b-256	`3fd544d4f976b755489e6f056b0479f5930e598026810c7edab6b19ed5dfeffc`

Algorithm	Hash digest
SHA256	`4a13feb247b01e542561f4a67aaef76cfc64020ae80a7e9d312cfdf542511000`
MD5	`bbbc36e793295359df0ad50eaef33370`
BLAKE2b-256	`9cf36ad0e4ece17b8ca69ee57aad4690cec88f1eef5209d9dce27a448bd15876`

Algorithm	Hash digest
SHA256	`7a7ba739a593871a572ee67c339bd279dd0b7efddf3b9cff77768eb2df125ca8`
MD5	`bf424151a2b0b00dfd246e3ac1ed6dec`
BLAKE2b-256	`b2e0b912bb6ec445452a4ce2b1f7affba54e42c3c5d831785d5bd08b860e6e35`

Algorithm	Hash digest
SHA256	`2705dca51ac230704767690d0c7a77762499408268787cf4e8ff6ec406e12c0e`
MD5	`22e3b6267939fcaa82d885f29fbfbb97`
BLAKE2b-256	`277cf3e9ee650d9ebd90df93192e30ec3161e4346fd0e8cf4cab6a9dc3a98d0f`