maxwell-bloch-studio 10.0.0__tar.gz

maxwell_bloch_studio-10.0.0/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_studio-10.0.0/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: maxwell-bloch-studio
+Version: 10.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-studio
+Project-URL: Repository, https://github.com/vahid-anari/maxwell-bloch-studio
+Project-URL: Issues, https://github.com/vahid-anari/maxwell-bloch-studio/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: mbsolver~=0.2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Maxwell Bloch Studio
+
+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-studio/main/assets/main_window.png" width="1512" alt="Maxwell Bloch Studio main window">
+
+## Features
+
+- Interactive GUI for Maxwell-Bloch model configuration and visualization.
+- Numba-accelerated numerical solver using Runge-Kutta time stepping, from the [mbsolver](https://github.com/vahid-anari/mbsolver) 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-studio
+```
+
+If you work in a conda or virtual environment, install it there with pip instead:
+
+```bash
+pip install maxwell-bloch-studio
+```
+
+## Running the application
+
+```bash
+maxwell-bloch-studio
+```
+
+(`mbstudio` is a shorter name for the same command, and `python -m mbstudio` 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-studio
+```
+
+or `pip install -U maxwell-bloch-studio` in the environment where you installed it.
+
+## Using the solver from Python
+
+Parameter files saved by the app can be solved in your own scripts. Install the
+app with `pip` in the Python you run the script with (a `pipx` install is kept
+separate from your own Python):
+
+```python
+import mbstudio
+
+f = mbstudio.ParamsFile("run_1.json")       # File → Save Parameters As…
+params = f.params()                          # a fresh dict, safe to change
+params["solve.sample"]["l"] = 1.0e13         # change anything
+res = mbstudio.solve(params)                 # same numbers as the app
+
+res["time"]             # time grid
+res["intensity"][-1]    # intensity at the exit of the medium
+```
+
+For the parameter file of a data folder, `f.velocities` lists the velocity
+components and `f.params(12.3)` picks one. `f.metadata` and `f.app_version`
+tell who saved the file, when, and with which version.
+
+`params` is a plain dictionary keyed by the names the app uses
+(`"solve.grid.nt"`, `"solve.sample"`, `"solve.pump.pulse1"`, …). η and θ₀ are
+computed from the sample values (ν, Γ, T₀, L, n₀), as in the app;
+`mbstudio.scaling(nu=…, gamma=…, t0=…, l=…, n0=…)` returns them and the other
+derived quantities. The result holds `time`, `intensity` and `w` (one row per
+stored z plane), `lambda_n` (pump), `A0` (boundary field), `t1` and `t2`, in the
+solver's dimensionless units; the app's flux scaling and offsets are not applied.
+
+A commented example script listing all keys ships with the app: open
+*Help → Use from Python…* to copy or save it, or read
+[`example_script.py`](https://github.com/vahid-anari/maxwell-bloch-studio/blob/main/src/mbstudio/resources/example_script.py).
+To build the parameters in code instead, use the
+[mbsolver](https://github.com/vahid-anari/mbsolver) package directly.
+
+## 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-studio.git
+cd maxwell-bloch-studio
+pip install -e .
+mbstudio
+```
+
+`python main.py` in the repository root also starts the app from the source
+folder. The code lives in `src/mbstudio/`:
+
+```text
+src/mbstudio/
+├── 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 [mbsolver](https://github.com/vahid-anari/mbsolver)
+package; the widgets come from [sciwidgets](https://github.com/vahid-anari/sciwidgets).
+
+## Earlier name
+
+Up to version 9.1 the app was called **Maxwell Bloch Solver** (`pip install
+maxwell-bloch-solver`, command `mbsolver`). The name `mbsolver` now belongs to
+the solver package. To move over:
+
+```bash
+pipx uninstall maxwell-bloch-solver
+pipx install maxwell-bloch-studio
+```
+
+(with pip: `pip uninstall maxwell-bloch-solver`, then `pip install
+maxwell-bloch-studio`). Saved settings and parameter files carry over; in
+scripts, change `import mbsolver` to `import mbstudio`.
+
+## License
+
+This project is released under the MIT License. See [`LICENSE`](https://github.com/vahid-anari/maxwell-bloch-studio/blob/main/LICENSE) for details.

maxwell_bloch_studio-10.0.0/README.md

@@ -0,0 +1,182 @@
+# Maxwell Bloch Studio
+
+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-studio/main/assets/main_window.png" width="1512" alt="Maxwell Bloch Studio main window">
+
+## Features
+
+- Interactive GUI for Maxwell-Bloch model configuration and visualization.
+- Numba-accelerated numerical solver using Runge-Kutta time stepping, from the [mbsolver](https://github.com/vahid-anari/mbsolver) 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-studio
+```
+
+If you work in a conda or virtual environment, install it there with pip instead:
+
+```bash
+pip install maxwell-bloch-studio
+```
+
+## Running the application
+
+```bash
+maxwell-bloch-studio
+```
+
+(`mbstudio` is a shorter name for the same command, and `python -m mbstudio` 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-studio
+```
+
+or `pip install -U maxwell-bloch-studio` in the environment where you installed it.
+
+## Using the solver from Python
+
+Parameter files saved by the app can be solved in your own scripts. Install the
+app with `pip` in the Python you run the script with (a `pipx` install is kept
+separate from your own Python):
+
+```python
+import mbstudio
+
+f = mbstudio.ParamsFile("run_1.json")       # File → Save Parameters As…
+params = f.params()                          # a fresh dict, safe to change
+params["solve.sample"]["l"] = 1.0e13         # change anything
+res = mbstudio.solve(params)                 # same numbers as the app
+
+res["time"]             # time grid
+res["intensity"][-1]    # intensity at the exit of the medium
+```
+
+For the parameter file of a data folder, `f.velocities` lists the velocity
+components and `f.params(12.3)` picks one. `f.metadata` and `f.app_version`
+tell who saved the file, when, and with which version.
+
+`params` is a plain dictionary keyed by the names the app uses
+(`"solve.grid.nt"`, `"solve.sample"`, `"solve.pump.pulse1"`, …). η and θ₀ are
+computed from the sample values (ν, Γ, T₀, L, n₀), as in the app;
+`mbstudio.scaling(nu=…, gamma=…, t0=…, l=…, n0=…)` returns them and the other
+derived quantities. The result holds `time`, `intensity` and `w` (one row per
+stored z plane), `lambda_n` (pump), `A0` (boundary field), `t1` and `t2`, in the
+solver's dimensionless units; the app's flux scaling and offsets are not applied.
+
+A commented example script listing all keys ships with the app: open
+*Help → Use from Python…* to copy or save it, or read
+[`example_script.py`](https://github.com/vahid-anari/maxwell-bloch-studio/blob/main/src/mbstudio/resources/example_script.py).
+To build the parameters in code instead, use the
+[mbsolver](https://github.com/vahid-anari/mbsolver) package directly.
+
+## 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-studio.git
+cd maxwell-bloch-studio
+pip install -e .
+mbstudio
+```
+
+`python main.py` in the repository root also starts the app from the source
+folder. The code lives in `src/mbstudio/`:
+
+```text
+src/mbstudio/
+├── 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 [mbsolver](https://github.com/vahid-anari/mbsolver)
+package; the widgets come from [sciwidgets](https://github.com/vahid-anari/sciwidgets).
+
+## Earlier name
+
+Up to version 9.1 the app was called **Maxwell Bloch Solver** (`pip install
+maxwell-bloch-solver`, command `mbsolver`). The name `mbsolver` now belongs to
+the solver package. To move over:
+
+```bash
+pipx uninstall maxwell-bloch-solver
+pipx install maxwell-bloch-studio
+```
+
+(with pip: `pip uninstall maxwell-bloch-solver`, then `pip install
+maxwell-bloch-studio`). Saved settings and parameter files carry over; in
+scripts, change `import mbsolver` to `import mbstudio`.
+
+## License
+
+This project is released under the MIT License. See [`LICENSE`](https://github.com/vahid-anari/maxwell-bloch-studio/blob/main/LICENSE) for details.

maxwell_bloch_studio-10.0.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "maxwell-bloch-studio"
+version = "10.0.0"
+description = "Desktop app for simulating and fitting Maxwell-Bloch models of astrophysical maser light curves"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Vahid Anari", email = "vahid.anari8@gmail.com" }]
+keywords = [
+    "maxwell-bloch", "maser", "superradiance", "astrophysics",
+    "light-curve", "fitting", "pyside6", "gui",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Environment :: X11 Applications :: Qt",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Physics",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "PySide6>=6.5,<7",
+    "numpy>=1.24",
+    "matplotlib>=3.7",
+    "psutil>=5.9",
+    "pygments>=2.0",
+    "sciwidgets~=0.5.0",
+    "mbsolver~=0.2.0",
+]
+
+[project.optional-dependencies]
+dev = ["build", "twine"]
+
+[project.gui-scripts]
+maxwell-bloch-studio = "mbstudio.main:main"
+mbstudio = "mbstudio.main:main"
+
+[project.urls]
+Homepage = "https://github.com/vahid-anari/maxwell-bloch-studio"
+Repository = "https://github.com/vahid-anari/maxwell-bloch-studio"
+Issues = "https://github.com/vahid-anari/maxwell-bloch-studio/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"mbstudio.resources" = ["*.json", "*.pdf", "*.py", "icons/*.png"]

maxwell_bloch_studio-10.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+