maxwell-bloch-solver 9.0.0__py3-none-any.whl

maxwell_bloch_solver-9.0.0.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: maxwell-bloch-solver
+Version: 9.0.0
+Summary: Desktop app for simulating and fitting Maxwell-Bloch models of astrophysical maser light curves
+Author-email: Vahid Anari <vahid.anari8@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/vahid-anari/maxwell-bloch-solver
+Project-URL: Repository, https://github.com/vahid-anari/maxwell-bloch-solver
+Project-URL: Issues, https://github.com/vahid-anari/maxwell-bloch-solver/issues
+Keywords: maxwell-bloch,maser,superradiance,astrophysics,light-curve,fitting,pyside6,gui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6<7,>=6.5
+Requires-Dist: numpy>=1.24
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: psutil>=5.9
+Requires-Dist: pygments>=2.0
+Requires-Dist: sciwidgets~=0.5.0
+Requires-Dist: maxbloch~=0.1.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Maxwell Bloch Solver
+
+A PySide6 desktop application for simulating, visualizing, and fitting one-dimensional Maxwell-Bloch models to astronomical maser light-curve data. The application combines an interactive Qt interface, configurable physical and numerical parameters, Numba-accelerated time evolution, and publication-oriented plotting/export tools.
+
+## Screenshot
+
+<img src="https://raw.githubusercontent.com/vahid-anari/maxwell-bloch-solver/main/assets/main_window.png" width="1512" alt="Maxwell Bloch Solver main window">
+
+## Features
+
+- Interactive GUI for Maxwell-Bloch model configuration and visualization.
+- Numba-accelerated numerical solver using Runge-Kutta time stepping, from the [maxbloch](https://github.com/vahid-anari/maxbloch) package.
+- Interface built with [sciwidgets](https://github.com/vahid-anari/sciwidgets) (sliders, parameter panels, plot canvas).
+- Light-curve import from velocity-tagged text files.
+- Support for period-tagged source folders, e.g. multiple folded periods for the same source.
+- Adjustable source, sample, initial-condition, pump-profile, and plotting parameters.
+- Built-in visualization of fitted flux, inversion/population, pump terms, and other solver quantities.
+- Parameter saving/loading using JSON files.
+- Export to PDF, PNG, or SVG, with PDF exports including metadata and parameter reports.
+- Local user guide and equations reference.
+
+## Installation
+
+The app needs Python 3.10 or newer. The easiest way is [pipx](https://pipx.pypa.io),
+which installs the app in its own environment and puts the command on your path:
+
+```bash
+pipx install maxwell-bloch-solver
+```
+
+If you work in a conda or virtual environment, install it there with pip instead:
+
+```bash
+pip install maxwell-bloch-solver
+```
+
+## Running the application
+
+```bash
+maxwell-bloch-solver
+```
+
+(`mbsolver` is a shorter name for the same command, and `python -m mbsolver` works too.)
+Use the menu bar to load data folders, adjust parameters, run the solver and export plots.
+
+## Updating
+
+The app tells you when a new version is available. To update:
+
+```bash
+pipx upgrade maxwell-bloch-solver
+```
+
+or `pip install -U maxwell-bloch-solver` in the environment where you installed it.
+
+## Input data format
+
+The application expects light-curve files as plain text files with at least two whitespace-separated columns:
+
+```text
+time flux
+```
+
+Blank lines and lines beginning with `#` are ignored.
+
+Supported file-name patterns are:
+
+```text
+Source_v=12.3.txt
+Source_p1_v=12.3.txt
+```
+
+where:
+
+- `Source` is the source name,
+- `p1`, `p2`, etc. are optional period labels,
+- `v=12.3` is the velocity-component label.
+
+Matching parameter files can be stored as:
+
+```text
+Source_params.json
+Source_p1_params.json
+```
+
+When period-tagged files are present, the application lets the user select the period set to load.
+
+## Exporting results
+
+Plots can be exported from the GUI as:
+
+- PDF
+- PNG
+- SVG
+
+PDF exports include the plot plus a report page containing metadata and the current parameter state.
+
+## Documentation
+
+The user guide and the equations reference (PDF) are installed with the app;
+open them from the Help and Info menus.
+
+## Development
+
+```bash
+git clone https://github.com/vahid-anari/maxwell-bloch-solver.git
+cd maxwell-bloch-solver
+pip install -e .
+mbsolver
+```
+
+`python main.py` in the repository root also starts the app from the source
+folder. The code lives in `src/mbsolver/`:
+
+```text
+src/mbsolver/
+├── main.py           # application entry point
+├── app/              # main window, plotting, solver controller, update pipeline
+├── ui/               # physics parameter widgets, dialogs, splash screen, step viewer
+├── io/               # data and parameter import/export
+├── config/           # app metadata, style and UI defaults
+├── utils/            # units, constants, helper functions
+└── resources/        # settings.json, icons, user guide and equations PDFs
+```
+
+The numerical solver is the [maxbloch](https://github.com/vahid-anari/maxbloch)
+package; the widgets come from [sciwidgets](https://github.com/vahid-anari/sciwidgets).
+
+## License
+
+This project is released under the MIT License. See [`LICENSE`](https://github.com/vahid-anari/maxwell-bloch-solver/blob/main/LICENSE) for details.

maxwell_bloch_solver-9.0.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+maxwell_bloch_solver-9.0.0.dist-info/licenses/LICENSE,sha256=2LJWhyNdKcg9IB3iYNYwz5J7iP5VfXv4aDTGS15iY98,1068
+mbsolver/__init__.py,sha256=W-hO1poowO8gnJBHHyibjIGZWGwL44ONVXXfUcUXR7I,92
+mbsolver/__main__.py,sha256=yxeGUepYG02Snf7BI6nYBzWh0Flfaja1s6nqKz2A1rE,107
+mbsolver/main.py,sha256=s4c46GKuonVjJ_d1iKxLDcMvUrono1C2c2cWYEFNsjY,1927
+mbsolver/paths.py,sha256=GuxuYX7oib4g03LoqEyCoIbsI5Np9WptsV4vrNHYAQQ,1052
+mbsolver/app/__init__.py,sha256=GxCHWvxF8zBB4kmbBw7ihi3upXJBT6a-JDmZMWuuvMU,61
+mbsolver/app/main_window.py,sha256=t5VXSEtUlPgp2-7W34Yrz8JtJNDGyP2FANEH0Qf5Cbo,46943
+mbsolver/app/parameter_tabs.py,sha256=nCYrcWgivyhkqM84zfBmD8WVCkzrtjW0ouXIbayn9Ho,7970
+mbsolver/app/plot.py,sha256=Ep_ZZw_r49df2bU5LIovLk01G7VSrNYEUQ895R8whIg,24280
+mbsolver/app/settings_manager.py,sha256=d303cE1kamlpN3hTERWxDbOBsybMLiJYr7tTJqtSWF8,12041
+mbsolver/app/solver_adapter.py,sha256=gav8ryV3IXVy-7-Q0DrXP5Rh1BcyLPt9uc1lxbzYV6k,2695
+mbsolver/app/solver_controller.py,sha256=PvQwCCNxb4CdCMHlunK3MwylTLZx1s3AuiQ6Au6l98w,5896
+mbsolver/app/update_checker.py,sha256=G4ODb_-n7pZ3MffaiIaUK0Bf2rUkYq0oLeNSY3jYkjQ,4212
+mbsolver/app/update_pipeline.py,sha256=l4SX69YBKMshGwGBGw8h0YlPg6MRrjYS03L8uMdNkBE,13881
+mbsolver/app/velocity_bar_controller.py,sha256=txLicO4OZOqNaW7wZu_hYl4cfmpOs0QmRekfzUWR3_k,17846
+mbsolver/config/__init__.py,sha256=mYj8lJnXeH8Pe2W0mtiCzXP8snAbC91iBrg_HCFQrJE,62
+mbsolver/config/app_metadata.py,sha256=7vW6TfWq8UwisTtSwPbBslPB3Wig3aKUNugKSB6iFo8,1505
+mbsolver/config/app_style.py,sha256=T0AZbGWvzK7KES5DaiCUdeTVP_huPbbS3pPxDJZR0jU,3159
+mbsolver/config/splash_state.py,sha256=XnkNcJ_Om6ZLSJooPs2cNix1WbwFg49TzRlFbmeKM_A,154
+mbsolver/config/ui_defaults.py,sha256=bRQS7lRui57-HdLhRyjhl9TD3D-twVYozgr91SxG_e0,484
+mbsolver/io/__init__.py,sha256=2S7l1vEAEyt7f39lMvnG53pA8Dr08OE6inYQMhuMfgg,70
+mbsolver/io/data_io.py,sha256=qFraC8WRMl2JZft0tld9tD4CLgNFiA-i0xqXXj6oQAo,14136
+mbsolver/io/legacy_keys.py,sha256=0ZKuxX96kTKRTrV7r3Eyd_6kqVxOWWR0YaRA1n8LZ98,3778
+mbsolver/io/parameter_io.py,sha256=svXHGvBfOQKu55eT7xTeMAw_i66IArRdydQMctVpoX4,7228
+mbsolver/resources/equations_reference.pdf,sha256=6QH_guT_gAaZ_JrUBTH8KNDD1U2jxIyfIWj6BBpIDls,316302
+mbsolver/resources/settings.json,sha256=JpmRdQ8XvWFltoQSYueM7lJWhMfclkIN_cGDrRjZGM8,21991
+mbsolver/resources/user_guide.pdf,sha256=WH5EdYpcVcREDag9UNX_EIC4z07v7DnKLEWjrZnrOsM,324919
+mbsolver/resources/icons/app_icon.png,sha256=8y5_tAemdxz14JGCHNOVAP0utFeO9TCZ_jG9txKFbNs,629852
+mbsolver/resources/icons/app_image.png,sha256=QlXtkEumMnmFFW-wbP3Foh2Iq2OGd7IviJu2pNfp4Ks,1002314
+mbsolver/ui/__init__.py,sha256=3MPRmc4ttJWdSc60uZVHkgSTMXOQPl5aU73QGjz0yMI,86
+mbsolver/ui/dialogs.py,sha256=LHUkw3ojVtc1OFWxQQb1mDw8FC7MH45AH5UpKJAF1h8,6040
+mbsolver/ui/solver_step_viewer.py,sha256=nQvQ2RVuRC-C-4kr2LIw1OaCXujXnx3H4NN-4yqa80w,11215
+mbsolver/ui/splash_screen.py,sha256=1WILTVsI7dfsZ2-0hYH6OvCIizdaXgoOik1_mSNnZTo,4703
+mbsolver/ui/widgets/__init__.py,sha256=CfFJsfHrwdXR1KU_vanz5MepflwMgALonsf3MUHLAss,63
+mbsolver/ui/widgets/_common.py,sha256=qpCNHsHA0QQ9loYiO_-8WD3Xi_39W5tPKbv3f1ZIG9k,762
+mbsolver/ui/widgets/initial_conditions.py,sha256=OCJ9ftK-PboAn3bCP94rPvRHB0zpaKlOP8Hv-IaCVyo,7750
+mbsolver/ui/widgets/pulse_function.py,sha256=2yoOszXhw59JM3FPWC5tjTn4jLt1Dsl1WDp1Vwj5bmk,32891
+mbsolver/ui/widgets/sample_properties.py,sha256=FelCOJNjwaNUOKM5yZNGxxeqFFdAqW7rbhYnpvKlc4Y,9426
+mbsolver/ui/widgets/scaling_parameters.py,sha256=v65S2cTSwOC6RkcycZDXQQhTApJwCoNtjXMFtoTDjIQ,12798
+mbsolver/ui/widgets/step_function.py,sha256=IIUF63qQwZZk_i1Iv0h8fTacrCV39VhsZ0f8M3t-_rM,37832
+mbsolver/utils/__init__.py,sha256=INdnH4g-uc8KWWCdkz2rAxKMxWw6PUpexNqELCsSHJ4,58
+mbsolver/utils/constants_si.py,sha256=EZqmrWuKWf60tXqzn8Ici5qeeckoJp_wH6ZMOYSnQv0,1145
+mbsolver/utils/helper_funcs.py,sha256=yDeJXzTVqJaf5RFg_7ZGodaLf_e13JWgYggwgFVNDrA,11104
+mbsolver/utils/units.py,sha256=RYN6B1y-_EzWI4WRlOki0OD0XNHL4yoUxyxr6JSenos,487
+maxwell_bloch_solver-9.0.0.dist-info/METADATA,sha256=n2nHnpZYka1C63MbbVYjG9MsYr4qvwoOLUh8Jae62BM,5819
+maxwell_bloch_solver-9.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+maxwell_bloch_solver-9.0.0.dist-info/entry_points.txt,sha256=eA5s8gwQBtgr67w2R9i908Ensb0xzqHW4fb6UIqshEs,86
+maxwell_bloch_solver-9.0.0.dist-info/top_level.txt,sha256=IesY1KJhnA-0KgpmrT1HztFrbvqYiKLh-OVbYdbW6yc,9
+maxwell_bloch_solver-9.0.0.dist-info/RECORD,,

maxwell_bloch_solver-9.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

maxwell_bloch_solver-9.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[gui_scripts]
+maxwell-bloch-solver = mbsolver.main:main
+mbsolver = mbsolver.main:main

maxwell_bloch_solver-9.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vahid Anari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

maxwell_bloch_solver-9.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mbsolver

mbsolver/__init__.py

@@ -0,0 +1 @@
+"""Maxwell Bloch Solver: a desktop app for Maxwell-Bloch models of astrophysical masers."""

mbsolver/__main__.py

@@ -0,0 +1,5 @@
+"""Start the app with ``python -m mbsolver``."""
+
+from mbsolver.main import main
+
+raise SystemExit(main())

mbsolver/app/__init__.py

@@ -0,0 +1,2 @@
+"""Top-level application controllers and window classes."""
+