gitronics 0.5.24__tar.gz → 0.6.0__tar.gz

{gitronics-0.5.24 → gitronics-0.6.0}/Cargo.lock

@@ -390,7 +390,7 @@ dependencies = [
 
 [[package]]
 name = "gitronics"
-version = "0.5.24"
+version = "0.6.0"
 dependencies = [
  "chrono",
  "clap",
@@ -636,14 +636,21 @@ dependencies = [
 
 [[package]]
 name = "migjorn"
-version = "0.1.8"
+version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d3f2fe960921f8c049fc7ac5536e96cba576e902cf040c258e8092eabb9eeaaf"
+checksum = "ce11924d4ef1f0496f0be14e68860ab11bbc0b63222057d03bc92b22b4084f3d"
 dependencies = [
- "clap",
- "memchr",
- "rayon",
- "thiserror",
+ "migjorn-syntax",
+ "rustc-hash",
+]
+
+[[package]]
+name = "migjorn-syntax"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42d3806f43fee8380cfaa0e26e9fee3a2dbece142e5314b6c7f9a0babf03fe05"
+dependencies = [
+ "rustc-hash",
 ]
 
 [[package]]
@@ -858,6 +865,12 @@ version = "0.8.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
 
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
 [[package]]
 name = "rustix"
 version = "1.1.4"

{gitronics-0.5.24 → gitronics-0.6.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "gitronics"
-version = "0.5.24"
+version = "0.6.0"
 edition = "2024"
 description = "Build MCNP neutronics models from modular components"
 license = "EUPL-1.2"
@@ -16,7 +16,7 @@ crate-type = ["cdylib", "rlib"]
 
 [dependencies]
 pyo3 = { version = "0.23", features = ["extension-module", "abi3-py39"] }
-migjorn = { version = "0.1.8" }
+migjorn = { version = "0.2.2" }
 walkdir = "2.5.0"
 serde = { version = "1.0.228", features = ["derive"] }
 serde-saphyr = "0.0.26"

{gitronics-0.5.24 → gitronics-0.6.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: gitronics
-Version: 0.5.24
+Version: 0.6.0
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 License-File: LICENSE
 Summary: Build MCNP neutronics models from modular components
-Requires-Python: >=3.8
+Requires-Python: >=3.9

{gitronics-0.5.24 → gitronics-0.6.0}/README.md

@@ -15,6 +15,8 @@ Gitronics lets you decompose a monolithic [MCNP](https://mcnp.lanl.gov/) input f
 
 **Full documentation: [fusion4energy.github.io/gitronics](https://fusion4energy.github.io/gitronics/latest/)**
 
+The Gitronics methodology is already used to maintain the most complex neutronics models of the [ITER](https://www.iter.org/) fusion reactor, and [JT-60SA](https://www.jt60sa.org/) tokamak.
+
 ## Why?
 
 | Problem with monolithic models | Gitronics solution |
@@ -98,6 +100,13 @@ The full documentation covers installation, CLI reference, configuration options
 
 **[fusion4energy.github.io/gitronics](https://fusion4energy.github.io/gitronics/latest/)**
 
+## Publication
+
+Gitronics is described in the following publication:
+
+- Cubi, A., et al. *Novel modular and Git-based approach for the management and development of radiation transport models*. [Fusion Engineering and Design](https://www.sciencedirect.com/journal/fusion-engineering-and-design), 2025. [https://doi.org/10.1016/j.fusengdes.2025.115248](https://doi.org/10.1016/j.fusengdes.2025.115248)
+
+
 ## License
 
 [EUPL-1.2](LICENSE)

{gitronics-0.5.24 → gitronics-0.6.0}/docs/examples.md

@@ -15,10 +15,18 @@ example_project/
 └── reference_model/
     ├── envelope_structure.mcnp
     ├── envelope_structure.metadata
-    └── filler_models/
-        ├── filler_model_1.mcnp
-        ├── filler_model_1.metadata
-        └── filler_model_2.mcnp
+    ├── filler_models/
+    │   ├── filler_model_1.mcnp
+    │   ├── filler_model_1.metadata
+    │   └── filler_model_2.mcnp
+    ├── source/
+    │   └── volumetric_source.mcnp
+    ├── materials/
+    │   └── materials.mcnp
+    ├── transformations/
+    │   └── my_transform.mcnp
+    └── tallies/
+      └── fine_mesh.mcnp
 ```
 
 ### Configuration

{gitronics-0.5.24 → gitronics-0.6.0}/docs/index.md

@@ -14,6 +14,8 @@ This workflow enables:
 - **Parallelism** — teams can develop different sub-models independently.
 - **Reproducibility** — each assembled model records the git commit hash and build timestamp in its metadata.
 
+The Gitronics methodology is already used to maintain the most complex neutronics models of the [ITER](https://www.iter.org/) fusion reactor, and [JT-60SA](https://www.jt60sa.org/) tokamak.
+
 ---
 
 ## How it works
@@ -43,6 +45,14 @@ If you have never used Gitronics before, please take a few minutes to read the w
 
 ---
 
+## Publication
+
+Gitronics is described in the following publication:
+
+- Cubi, A., et al. *Novel modular and Git-based approach for the management and development of radiation transport models*. [Fusion Engineering and Design](https://www.sciencedirect.com/journal/fusion-engineering-and-design), 2025. [https://doi.org/10.1016/j.fusengdes.2025.115248](https://doi.org/10.1016/j.fusengdes.2025.115248)
+
+---
+
 ## Quick links
 
 - [Installation](installation.md)

{gitronics-0.5.24 → gitronics-0.6.0}/mkdocs.yml

@@ -11,14 +11,14 @@ theme:
   favicon: assets/logo.png
   palette:
     - scheme: default
-      primary: deep purple
-      accent: teal
+      # primary: deep purple
+      # accent: teal
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - scheme: slate
-      primary: deep purple
-      accent: teal
+      # primary: deep purple
+      # accent: teal
       toggle:
         icon: material/brightness-4
         name: Switch to light mode

{gitronics-0.5.24 → gitronics-0.6.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "maturin"
 name = "gitronics"
 dynamic = ["version"]
 description = "Build MCNP neutronics models from modular components"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Programming Language :: Rust",
     "Programming Language :: Python :: Implementation :: CPython",

{gitronics-0.5.24 → gitronics-0.6.0}/python/gitronics/__init__.py

@@ -11,9 +11,10 @@ from __future__ import annotations
 import sys
 
 from .gitronics import py_build_model as build_model  # type: ignore[import]
+from .gitronics import py_migrate_model as migrate_model  # type: ignore[import]
 from .gitronics import run  # type: ignore[import]
 
-__all__ = ["build_model", "run"]
+__all__ = ["build_model", "migrate_model", "run"]
 
 
 def _cli_main() -> None:

{gitronics-0.5.24 → gitronics-0.6.0}/python/gitronics/gitronics.pyi

@@ -43,3 +43,19 @@ def py_build_model(config_path: Path | str, output_path: Path | str) -> None:
         )
     """
     ...
+
+def py_migrate_model(mcnp_input: Path | str, output_path: Path | str) -> None:
+    """Migrate a monolithic MCNP model into a new gitronics project.
+
+    Splits the deck at *mcnp_input* into an envelope structure, per-universe
+    filler models, and a data-cards file, and writes a baseline configuration
+    that rebuilds the original model with :func:`build_model`.
+
+    Args:
+        mcnp_input: Path to the monolithic MCNP input file.
+        output_path: Directory where the new project will be created.
+
+    Raises:
+        RuntimeError: If any step of the migration fails.
+    """
+    ...