pynamicalsys 1.0.1__py3-none-any.whl → 1.2.2__py3-none-any.whl

pynamicalsys/core/discrete_dynamical_systems.py

@@ -16,94 +16,93 @@
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 
-import numpy as np
 from numbers import Integral, Real
-from typing import Optional, Tuple, Union, Callable, List, Dict, Sequence, Any
+from typing import Any, Callable, Dict, List, Optional, Sequence, Tuple, Union
+
+import numpy as np
 from numpy.typing import NDArray
 
 from pynamicalsys.common.recurrence_quantification_analysis import RTEConfig
+from pynamicalsys.common.utils import finite_difference_jacobian, householder_qr
 from pynamicalsys.discrete_time.dynamical_indicators import (
-    lyapunov_er,
-    lyapunov_qr,
-    finite_time_lyapunov,
-    lyapunov_1D,
+    RTE,
     SALI,
     LDI_k,
-    lagrangian_descriptors,
     dig,
-    hurst_exponent,
     finite_time_hurst_exponent,
-    RTE,
+    finite_time_lyapunov,
     finite_time_RTE,
+    hurst_exponent,
+    lagrangian_descriptors,
+    lyapunov_1D,
+    lyapunov_er,
+    lyapunov_qr,
 )
 from pynamicalsys.discrete_time.models import (
-    standard_map,
-    standard_map_backwards,
-    standard_map_jacobian,
-    unbounded_standard_map,
+    extended_standard_nontwist_map,
+    extended_standard_nontwist_map_backwards,
+    extended_standard_nontwist_map_jacobian,
     henon_map,
     henon_map_jacobian,
+    leonel_map,
+    leonel_map_backwards,
+    leonel_map_jacobian,
     logistic_map,
     logistic_map_jacobian,
+    lozi_map,
+    lozi_map_jacobian,
+    rulkov_map,
+    rulkov_map_jacobian,
+    standard_map,
+    standard_map_backwards,
+    standard_map_jacobian,
     standard_nontwist_map,
     standard_nontwist_map_backwards,
     standard_nontwist_map_jacobian,
-    extended_standard_nontwist_map,
-    extended_standard_nontwist_map_backwards,
-    extended_standard_nontwist_map_jacobian,
-    leonel_map,
-    leonel_map_jacobian,
-    leonel_map_backwards,
     symplectic_map_4D,
     symplectic_map_4D_backwards,
     symplectic_map_4D_jacobian,
-    lozi_map,
-    lozi_map_jacobian,
-    rulkov_map,
-    rulkov_map_jacobian,
+    unbounded_standard_map,
 )
 from pynamicalsys.discrete_time.trajectory_analysis import (
-    generate_trajectory,
-    ensemble_trajectories,
     bifurcation_diagram,
-    period_counter,
+    calculate_manifolds,
+    classify_stability,
+    eigenvalues_and_eigenvectors,
+    ensemble_time_average,
+    ensemble_trajectories,
     escape_basin_and_time_entering,
     escape_time_exiting,
-    survival_probability,
     find_periodic_orbit,
     find_periodic_orbit_symmetry_line,
-    eigenvalues_and_eigenvectors,
-    classify_stability,
-    calculate_manifolds,
-    rotation_number,
+    generate_trajectory,
     iterate_mapping,
-    ensemble_time_average,
+    period_counter,
+    rotation_number,
+    survival_probability,
 )
 from pynamicalsys.discrete_time.transport import (
-    diffusion_coefficient,
     average_vs_time,
-    root_mean_squared,
+    cumulative_average_vs_time,
+    diffusion_coefficient,
     mean_squared_displacement,
     recurrence_times,
-    cumulative_average_vs_time,
+    root_mean_squared,
 )
-
-from pynamicalsys.common.utils import finite_difference_jacobian, householder_qr
-
-from .time_series_metrics import TimeSeriesMetrics as tsm
-
 from pynamicalsys.discrete_time.validators import (
+    validate_and_convert_param_range,
+    validate_axis,
+    validate_finite_time,
     validate_initial_conditions,
-    validate_parameters,
     validate_non_negative,
-    validate_transient_time,
-    validate_and_convert_param_range,
+    validate_parameters,
     validate_positive,
     validate_sample_times,
-    validate_axis,
-    validate_finite_time,
+    validate_transient_time,
 )
 
+from .time_series_metrics import TimeSeriesMetrics as tsm
+
 
 class DiscreteDynamicalSystem:
     """Class representing a discrete dynamical system with various models and methods for analysis.

pynamicalsys/discrete_time/trajectory_analysis.py

@@ -15,10 +15,11 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-from typing import Optional, Callable, Union, Tuple, Dict, List, Any, Sequence
-from numpy.typing import NDArray
+from typing import Any, Callable, Dict, List, Optional, Sequence, Tuple, Union
+
 import numpy as np
 from numba import njit, prange
+from numpy.typing import NDArray
 
 
 @njit(cache=True)

{pynamicalsys-1.0.1.dist-info → pynamicalsys-1.2.2.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: pynamicalsys
-Version: 1.0.1
-Summary: A Python toolkit for chaotic analysis and dynamical systems
+Version: 1.2.2
+Summary: A Python toolkit for the analysis of dynamical systems
 Author-email: Matheus Rolim Sales <rolim.sales.m@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
                                Version 3, 29 June 2007
@@ -689,6 +689,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: numpy>=1.21
 Requires-Dist: matplotlib>=3.4
 Requires-Dist: numba>=0.55
+Requires-Dist: scipy>=0.6
 
 # pynamicalsys: A Python toolkit for the analysis of dynamical systems
 
@@ -698,28 +699,28 @@ Requires-Dist: numba>=0.55
 
 ## Overview
 
-**pynamicalsys** is designed to provide a fast, flexible, and user-friendly environment for analyzing **nonlinear dynamical systems**. It is designed for students, researchers, educators, and enthusiasts who want to explore the world of chaos and dynamical systems. Beyond standard tools like trajectory generation and Lyapunov exponents calculation, pynamicalsys includes advanced features such as
+**pynamicalsys** is designed to provide a fast, flexible, and user-friendly environment for analyzing **nonlinear dynamical systems**. It is intended for students, researchers, educators, and enthusiasts who want to explore the world of chaos and dynamical systems. Beyond standard tools like trajectory generation and Lyapunov exponents calculation, **pynamicalsys** includes advanced features such as
 
--   **Linear dependence index** for chaos detection.
--   **Recurrence plots** and recurrence time statistics.
--   Chaos indicators based on **weighted Birkhoff averages**.
--   Statistical measures of **diffusion and transport** in dynamical systems.
--   Computation of **periodic orbits**, their **stability** and their **manifolds**.
--   Basin metric for **quantifying** the structure of **basins of attraction**.
--   **Plot styling** for consistent and customizable visualizations.
+- **Linear dependence index** for chaos detection.
+- **Recurrence plots** and recurrence time statistics.
+- Chaos indicators based on **weighted Birkhoff averages**.
+- Statistical measures of **diffusion and transport** in dynamical systems.
+- Computation of **periodic orbits**, their **stability** and their **manifolds**.
+- Basin metric for **quantifying** the structure of **basins of attraction**.
+- **Plot styling** for consistent and customizable visualizations.
 
-pynamicalsys is built on top of NumPy and Numba, ensuring high performance and efficiency. Thanks to Numba accelerated computation, pynamicalsys offers speedups up to **130x** compared to the original Python implementation of the algorithms. This makes it suitable for large-scale simulations and analyses.
+**pynamicalsys** is built on top of NumPy and Numba, ensuring high performance and efficiency. Thanks to Numba accelerated computation, **pynamicalsys** offers speedups up to **130x** compared to the original Python implementation of the algorithms. This makes it suitable for large-scale simulations and analyses.
 
 ## Installation
 
 ### Prerequisites
 
--   Python 3.8 or higher
--   pip (Python package installer)
+- Python 3.8 or higher
+- pip (Python package installer)
 
 ### Install via PyPI
 
-To install the latest stable release, run:
+To install the latest stable release, run in your command line:
 
 ```bash
 $ pip install pynamicalsys
@@ -727,6 +728,13 @@ $ pip install pynamicalsys
 
 > **Note:** On **Windows**, it is **strongly recommended** to use [Anaconda](https://www.anaconda.com). It simplifies dependency management and avoids potential issues with scientific libraries during installation. Be sure to run the command from the **Anaconda Prompt**, not from Command Prompt or PowerShell, to ensure the correct environment is activated.
 
+### Upgrade via PyPI
+
+To upgrade your current version of **pynamicalsys** to the latest stable release, run in your command line:
+
+```bash
+$ pip install **pynamicalsys** --upgrade
+```
 
 ### Install from source
 
@@ -757,7 +765,19 @@ $ pip install --upgrade pip build
 
 ## Citation
 
-Currently, our research paper is under review, but in the mean time, if you use **pynamicalsys** in your work, you can cite the arXiv version:
+Currently, our research paper is under review, but in the mean time, if you use **pynamicalsys** in your work, you can cite the [arXiv](https://arxiv.org/abs/2506.14044) version:
+
+```bibtex
+@misc{pynamicalsys,
+  title={pynamicalsys: A Python toolkit for the analysis of dynamical systems},
+  author={Matheus Rolim Sales and Leonardo Costa de Souza and Daniel Borin and Michele Mugnaine and José Danilo Szezech Jr. and Ricardo Luiz Viana and Iberê Luiz Caldas and Edson Denis Leonel and Chris G. Antonopoulos},
+  year={2025},
+  eprint={2506.14044},
+  archivePrefix={arXiv},
+  primaryClass={nlin.CD},
+  url={https://arxiv.org/abs/2506.14044},
+}
+```
 
 ## Contributing
 

{pynamicalsys-1.0.1.dist-info → pynamicalsys-1.2.2.dist-info}/RECORD

@@ -1,23 +1,28 @@
-pynamicalsys/__init__.py,sha256=YKyJciyZ94-ULnQWSGk8Us6yJsNX_2HSNi_Akvnc4tE,1078
-pynamicalsys/__version__.py,sha256=2Cl9kcQGg7NiH_eHRcv8wDYSW0X4uS5J0mGdZFO9-h0,511
+pynamicalsys/__init__.py,sha256=IBHDcCD7wX8pULFXLk0yvF3uuNodvDKGirJektm1nR4,1215
+pynamicalsys/__version__.py,sha256=o0zEAUXpMoJZCULVYplCdjcZuIQ-3sIIZKyfNu_loQE,511
 pynamicalsys/common/__init__.py,sha256=W4OESm7TA-EUTGUOtIgBgvSd1n80Mgl0KA2dCkw8yIw,721
 pynamicalsys/common/basin_analysis.py,sha256=teGEOMPPOdzKNZsN0_OvkzBlcV-UOANRjcdFyI2-FLM,5473
 pynamicalsys/common/recurrence_quantification_analysis.py,sha256=neBolgoWrGJYOQta71Jf2ZMwNK1RoaZb_wNHqb1mM7I,14356
 pynamicalsys/common/utils.py,sha256=ezNMSGTDVjtHpAa95Dr0r09s5CR_h9AShLU_ZuLMM44,10189
 pynamicalsys/continuous_time/__init__.py,sha256=W4OESm7TA-EUTGUOtIgBgvSd1n80Mgl0KA2dCkw8yIw,721
+pynamicalsys/continuous_time/chaotic_indicators.py,sha256=rwstGDMx2ynT7woezVqaOQ10HJpblp0dJvheLjpCnBg,9891
+pynamicalsys/continuous_time/models.py,sha256=YJtmsVZqSn3GDNqV0IKSQBHWZSCDY_EJ5Sgh4ulDc9I,5339
+pynamicalsys/continuous_time/numerical_integrators.py,sha256=pSsDIlxhSntLxfHLRNduqjExdiUEY6yNpQRyvLBraqk,9667
+pynamicalsys/continuous_time/trajectory_analysis.py,sha256=1Eh4WEIlLT_fFGfgEorSgN1qGZ9ym0kVEPbWcRRXNKQ,4406
+pynamicalsys/continuous_time/validators.py,sha256=dvtlcWbn2w5_vNUB68f7ywFPyFrPKe3cUDqGCk52mhw,3834
 pynamicalsys/core/__init__.py,sha256=W4OESm7TA-EUTGUOtIgBgvSd1n80Mgl0KA2dCkw8yIw,721
 pynamicalsys/core/basin_metrics.py,sha256=sqSj-UCzBQdRaTvOBtzo8SCgJN90T3GiWy4nlLsbg5c,7604
-pynamicalsys/core/continuous_dynamical_systems.py,sha256=V5VbnYoGe3rtCS3cUxTt_Qi2j9tNLOhABghdbO2zNkc,779
-pynamicalsys/core/discrete_dynamical_systems.py,sha256=54eZaEmu1-KccbkFmqDHtidVKRXR7OzX8-GBe7qY3-Q,135875
+pynamicalsys/core/continuous_dynamical_systems.py,sha256=nkESGfuxBT_UmoY_2tJv1fMY4hK1J0M74aQpLgNVEyI,30482
+pynamicalsys/core/discrete_dynamical_systems.py,sha256=AhxyAOZFnkjf4KnJiaReN5ZRndkFFEG_GOT2_PeLpXs,135874
 pynamicalsys/core/plot_styler.py,sha256=sVX_rb1HSt340U3zyPlXojylhma9cKCOgYirMIge18M,5647
 pynamicalsys/core/time_series_metrics.py,sha256=7fwXO1I6lIjmv_MzYxBn-9k2gjjnhm_y_Tp3diE1z68,5102
 pynamicalsys/discrete_time/__init__.py,sha256=W4OESm7TA-EUTGUOtIgBgvSd1n80Mgl0KA2dCkw8yIw,721
 pynamicalsys/discrete_time/dynamical_indicators.py,sha256=Ck6orYxy09NHsVYnTSmkROq33csiyiePdsqzOAJCKcs,43057
 pynamicalsys/discrete_time/models.py,sha256=u9MlaCzBzR_OomWRYbEC2sS2qpfDg7qzZjX8YDijVe0,10756
-pynamicalsys/discrete_time/trajectory_analysis.py,sha256=5m-cVQ5XZ2e-fmyNVWSGa1Nik2vGbNeU56qHvLSBMmQ,48668
+pynamicalsys/discrete_time/trajectory_analysis.py,sha256=W3nqLJgqJYMV9DbBbSSOpzNDQ7XlroP3lC0sgSoFztY,48669
 pynamicalsys/discrete_time/transport.py,sha256=29leQue2ReRbFzT_riqWXTZDvf2O7jMsMOUnAQPBrBU,15972
 pynamicalsys/discrete_time/validators.py,sha256=4eWQAlZgCzFsrmijzVF10CZuoIMiu-jvrrvRokBFTkY,10013
-pynamicalsys-1.0.1.dist-info/METADATA,sha256=opnr3I_CdkY8EArhayU--Aq-v3Piipx921gOy2sTtSc,45108
-pynamicalsys-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pynamicalsys-1.0.1.dist-info/top_level.txt,sha256=1AqoHXye_hGRkvqu4KY0SdEuNTgqf3xyTlV8xhiJJFU,13
-pynamicalsys-1.0.1.dist-info/RECORD,,
+pynamicalsys-1.2.2.dist-info/METADATA,sha256=UQDElv3HVAqJDDUM0251dJVDbQZPhyLTMe-hnHfPK-E,45834
+pynamicalsys-1.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pynamicalsys-1.2.2.dist-info/top_level.txt,sha256=1AqoHXye_hGRkvqu4KY0SdEuNTgqf3xyTlV8xhiJJFU,13
+pynamicalsys-1.2.2.dist-info/RECORD,,