Metadata-Version: 2.1
Name: phaseportrait
Version: 1.1.2
Summary: A python package for visualizing non-linear dynamics and chaos. (2D phase portraits, 3D chaotic trajectories, Maps, Cobweb plots...)
Author-email: Víctor Loras <vhloras@gmail.com>, Unai Lería <unaileria@gmail.com>
Maintainer-email: Víctor Loras <vhloras@gmail.com>, Unai Lería <unaileria@gmail.com>
License: MIT license
Project-URL: Documentation, https://phaseportrait.github.io/
Project-URL: GitHub, https://github.com/phaseportrait/phaseportrait
Project-URL: GUI, https://github.com/phaseportrait/phaseportrait-gui
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Documentation

To check out *phaseportrait*'s documentation, view some examples and read more about it, check our website or try our Graphical User Interface:


[Documentation](https://phaseportrait.github.io/)

[Graphical User Interface](https://github.com/phaseportrait/phaseportrait-gui)


# Installation
**Installing via pip:**

Phaseportrait releases are available as wheel packages for macOS, Windows and Linux on PyPI. Install it using pip:
```
$ pip install phaseportrait
```

**Installing from source:**

Open a terminal on desired route and type the following:
```
$ git clone https://github.com/phaseportrait/phaseportrait
```
**Manual installation**

Visit [phase-portrait](https://github.com/phaseportrait/phaseportrait) webpage on GitHub. Click on green button saying *Code*, and download it in zip format.
Save and unzip on desired directory.

# What's this?
The idea behind this project was to create a simple way to make phase portraits in 2D and 3D in Python, as we couldn't find something similar on the internet, so we got down to work. (Update: found [jmoy/plotdf](https://github.com/jmoy/plotdf), offers similar 2D phase plots but it is very limited).

Eventually, we did some work on bifurcations, 1D maps and chaos in 3D trayectories.

This idea came while taking a course in non linear dynamics and chaos, during the 3rd year of physics degree, brought by our desire of visualizing things and programming.



We want to state that we are self-taught into making this kind of stuff, and we've tried to make things as *professionally* as possible, any comments about improving our work are welcome!

<!-- ## **Disclaimer:**

**Today's date (July 2021), we've decided to cease our work on this project (for the moment, as we have to move on other things). Therefore, this is the 'final' version of the project, there are no more features incoming. We've tried to leave the code documentated and with good organisation in case someone wants to carry on with some idea! Cheers** -->

# Authors

- Víctor Loras Herrero (vhloras@gmail.com)
- Unai Lería Fortea (unaileria@gmail.com)


# Contributing
This proyect is open-source, everyone can download, use and contribute. To do that, several options are offered:

* Fork the project, add a new feature / improve the existing ones and pull a request via GitHub.
* Contact us on our emails:
    * [vhloras@gmail.com](mailto:vhloras@gmail.com)
    * [unaileria@gmail.com](mailto:unaileria@gmail.com)
