goad-py 0.4.1__cp38-abi3-musllinux_1_2_x86_64.whl → 0.5.1__cp38-abi3-musllinux_1_2_x86_64.whl

goad_py/goad_py.pyi

@@ -1,13 +1,13 @@
 """
 GOAD Python API Type Definitions
 
-This file provides comprehensive type hints for the GOAD (Geometric Optics 
-Approximation for Diffraction) Python bindings. GOAD simulates light scattering 
+This file provides comprehensive type hints for the GOAD (Geometric Optics
+Approximation for Diffraction) Python bindings. GOAD simulates light scattering
 by arbitrary 3D geometries using geometric optics with diffraction corrections.
 
 The main workflow is:
 1. Create Settings with geometry path (all other parameters have sensible defaults)
-2. Use Problem for single-orientation or MultiProblem for multi-orientation simulations  
+2. Use Problem for single-orientation or MultiProblem for multi-orientation simulations
 3. Call py_solve() to run the computation
 4. Access results through the .results property
 
@@ -19,18 +19,18 @@ Default behavior (minimal setup):
 
 Example (minimal setup):
     import goad_py as goad
-    
+
     settings = goad.Settings("particle.obj")
     mp = goad.MultiProblem(settings)
     mp.py_solve()
-    
+
     results = mp.results
     print(f"Scattering cross-section: {results.scat_cross}")
     print(f"Extinction cross-section: {results.ext_cross}")
     print(f"Asymmetry parameter: {results.asymmetry}")
 """
 
-from typing import Optional, List, Dict, Any, Union, Tuple
+from typing import Optional, List, Dict, Tuple
 import numpy as np
 
 class Euler:
@@ -38,7 +38,7 @@ class Euler:
     alpha: float
     beta: float
     gamma: float
-    
+
     def __init__(self, alpha: float, beta: float, gamma: float) -> None: ...
     def __repr__(self) -> str: ...
 
@@ -65,7 +65,7 @@ class Orientation:
     """Full orientation specification."""
     scheme: Scheme
     euler_convention: EulerConvention
-    
+
     def __init__(self, scheme: Scheme, euler_convention: Optional[EulerConvention] = None) -> None: ...
     def __repr__(self) -> str: ...
 
@@ -79,102 +79,102 @@ class Shape:
 
 class Results:
     """Results from problem solving."""
-    
+
     @property
     def bins(self) -> List[tuple[float, float]]: ...
-    
-    @property  
+
+    @property
     def bins_1d(self) -> Optional[List[float]]: ...
-    
+
     @property
     def mueller(self) -> List[List[float]]: ...
-    
+
     @property
     def mueller_beam(self) -> List[List[float]]: ...
-    
+
     @property
     def mueller_ext(self) -> List[List[float]]: ...
-    
+
     @property
     def mueller_1d(self) -> List[List[float]]: ...
-    
+
     @property
     def mueller_1d_beam(self) -> List[List[float]]: ...
-    
+
     @property
     def mueller_1d_ext(self) -> List[List[float]]: ...
-    
+
     @property
     def asymmetry(self) -> Optional[float]: ...
-    
+
     @property
     def scat_cross(self) -> Optional[float]: ...
-    
+
     @property
     def ext_cross(self) -> Optional[float]: ...
-    
+
     @property
     def albedo(self) -> Optional[float]: ...
-    
+
     @property
     def params(self) -> Dict[str, Optional[float]]: ...
-    
+
     @property
     def powers(self) -> Dict[str, float]: ...
 
 class BinningScheme:
     """Angular binning scheme for scattering calculations.
-    
+
     Defines how to discretize the scattering sphere into angular bins
     for Mueller matrix and amplitude computations. Supports simple
     regular grids, custom intervals, and arbitrary bin arrangements.
     """
-    
+
     def __init__(self, bins: List[tuple[float, float]]) -> None: ...
-    
+
     @staticmethod
     def simple(num_theta: int, num_phi: int) -> 'BinningScheme':
         """Create a simple regular grid binning scheme.
-        
+
         Args:
             num_theta: Number of bins in theta direction (0 to 180 degrees)
             num_phi: Number of bins in phi direction (0 to 360 degrees)
-            
+
         Returns:
             BinningScheme with regular angular grid
-            
+
         Raises:
             ValueError: If num_theta or num_phi is zero or negative
         """
         ...
-    
+
     @staticmethod
     def interval(
         thetas: List[float],
-        theta_spacings: List[float], 
+        theta_spacings: List[float],
         phis: List[float],
         phi_spacings: List[float]
     ) -> 'BinningScheme':
         """Create binning scheme with custom intervals.
-        
+
         Args:
             thetas: Key theta angles in degrees
             theta_spacings: Spacing around each theta value
-            phis: Key phi angles in degrees  
+            phis: Key phi angles in degrees
             phi_spacings: Spacing around each phi value
-            
+
         Returns:
             BinningScheme with custom intervals
         """
         ...
-    
+
     @staticmethod
     def custom(bins: List[tuple[float, float]]) -> 'BinningScheme':
         """Create binning scheme from explicit (theta, phi) pairs.
-        
+
         Args:
             bins: List of (theta, phi) angle pairs in degrees
-            
+
         Returns:
             BinningScheme with custom bin locations
         """
@@ -182,12 +182,12 @@ class BinningScheme:
 
 class Settings:
     """Simulation parameters and physical properties.
-    
+
     Contains all parameters needed for a GOAD simulation including
     geometry path, optical properties, orientation scheme, and
     numerical settings. Most parameters have sensible defaults.
     """
-    
+
     def __init__(
         self,
         geom_path: str,
@@ -207,7 +207,7 @@ class Settings:
         directory: str = "goad_run"
     ) -> None:
         """Initialize simulation settings.
-        
+
         Args:
             geom_path: Path to geometry file (.obj format)
             wavelength: Incident wavelength in geometry units (default: 0.532)
@@ -224,45 +224,45 @@ class Settings:
             max_tir: Maximum total internal reflections (default: 10)
             scale: Geometry scaling factor (default: 1.0)
             directory: Output directory for results (default: "goad_run")
-            
+
         Raises:
             ValueError: If wavelength <= 0 or cutoff not in [0,1]
             FileNotFoundError: If geometry file doesn't exist
         """
         ...
-    
+
     @property
     def euler(self) -> List[float]: ...
-    
+
     @euler.setter
     def euler(self, value: List[float]) -> None: ...
-    
+
     @property
     def orientation(self) -> Orientation: ...
-    
+
     @orientation.setter
     def orientation(self, value: Orientation) -> None: ...
 
 class Problem:
     """Single orientation problem."""
-    
+
     def __init__(self, settings: Optional[Settings] = None, geom: Optional[Geom] = None) -> None: ...
-    
+
     def py_solve(self) -> None: ...
-    
+
     def py_print_stats(self) -> None: ...
-    
+
     @property
     def results(self) -> Results: ...
 
 class MultiProblem:
     """Multi-orientation light scattering simulation for a single geometry.
-    
+
     Computes orientation-averaged scattering properties by running multiple
     single-orientation simulations and averaging the results. Supports both
     random and systematic orientation sampling schemes. Results include
     Mueller matrices, cross-sections, and derived optical parameters.
-    
+
     Example:
         orientations = goad.create_uniform_orientation(100)
         settings = goad.Settings("particle.obj", orientation=orientations)
@@ -270,53 +270,53 @@ class MultiProblem:
         mp.py_solve()
         print(f"Scattering cross-section: {mp.results.scat_cross}")
     """
-    
+
     def __init__(self, settings: Settings, geom: Optional[Geom] = None) -> None:
         """Initialize multi-orientation problem.
-        
+
         Args:
             settings: Simulation parameters including orientation scheme
             geom: Geometry object (loaded from settings.geom_path if None)
-            
+
         Raises:
             FileNotFoundError: If geometry file cannot be loaded
         """
         ...
-    
+
     def py_solve(self) -> None:
         """Solve the multi-orientation scattering problem.
-        
+
         Computes scattering properties averaged over all orientations using
         parallel processing. The Global Interpreter Lock (GIL) is released
         during computation to allow concurrent Python operations.
-        
+
         Raises:
             RuntimeError: If computation fails
         """
         ...
-    
+
     def py_writeup(self) -> None:
         """Write results to output files in the specified directory."""
         ...
-    
+
     def py_reset(self) -> None:
         """Reset problem to initial state and regenerate orientations."""
         ...
-    
+
     def py_regenerate_orientations(self) -> None:
         """Regenerate random orientations (useful for statistical sampling)."""
         ...
-    
+
     @property
     def results(self) -> Results:
         """Access orientation-averaged simulation results.
-        
+
         Returns the complete Results object containing Mueller matrices,
         amplitude matrices, power distributions, and derived parameters
         averaged over all orientations.
         """
         ...
-    
+
     @property
     def num_orientations(self) -> int:
         """Number of orientations in the current simulation."""
@@ -339,16 +339,16 @@ def goad_py_add() -> None: ...
 
 class Convergable:
     """Represents a variable to monitor for convergence.
-    
+
     Defines convergence criteria for integrated scattering parameters
     including asymmetry parameter, scattering cross-section, extinction
     cross-section, and single-scattering albedo.
     """
-    
+
     variable: str
     tolerance_type: str
     tolerance: float
-    
+
     def __init__(
         self,
         variable: str,
@@ -356,12 +356,12 @@ class Convergable:
         tolerance: float = 0.01
     ) -> None:
         """Initialize convergence criterion.
-        
+
         Args:
             variable: Variable to monitor ('asymmetry', 'scatt', 'ext', 'albedo')
             tolerance_type: 'relative' or 'absolute' tolerance
             tolerance: Tolerance value (relative as fraction, absolute as value)
-            
+
         Raises:
             ValueError: If variable name or tolerance_type is invalid
         """
@@ -369,11 +369,11 @@ class Convergable:
 
 class ConvergenceResults:
     """Results from a convergence study.
-    
+
     Contains final convergence status, parameter values with uncertainties,
     and complete convergence history for analysis.
     """
-    
+
     converged: bool
     n_orientations: int
     values: Dict[str, float]
@@ -382,7 +382,7 @@ class ConvergenceResults:
     mueller_2d: Optional[np.ndarray]
     convergence_history: List[Tuple[int, str, float]]
     warning: Optional[str]
-    
+
     def __init__(
         self,
         converged: bool,
@@ -397,11 +397,11 @@ class ConvergenceResults:
 
 class Convergence:
     """Runs multiple MultiProblems until convergence criteria are met.
-    
+
     Implements statistical convergence analysis for scattering parameters
     using batch-based standard error estimation. Monitors multiple variables
     simultaneously and stops when all meet their convergence criteria.
-    
+
     Example:
         convergence = Convergence(
             settings=goad.Settings("particle.obj"),
@@ -413,7 +413,7 @@ class Convergence:
         )
         results = convergence.run()
     """
-    
+
     def __init__(
         self,
         settings: Settings,
@@ -425,7 +425,7 @@ class Convergence:
         mueller_2d: bool = False
     ) -> None:
         """Initialize convergence study.
-        
+
         Args:
             settings: GOAD settings for the simulation
             convergables: List of variables to monitor for convergence
@@ -434,20 +434,20 @@ class Convergence:
             min_batches: Minimum number of batches before allowing convergence
             mueller_1d: Whether to collect 1D Mueller matrices
             mueller_2d: Whether to collect 2D Mueller matrices
-            
+
         Raises:
             ValueError: If parameters are invalid or no convergables specified
         """
         ...
-    
+
     def run(self) -> ConvergenceResults:
         """Run the convergence study.
-        
+
         Executes batches of orientations until all convergence criteria
         are met or maximum orientations reached. Provides progress updates
         and rigorous statistical analysis.
-        
+
         Returns:
             ConvergenceResults containing final values and convergence status
         """
-        ...
+        ...

{goad_py-0.4.1.dist-info → goad_py-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: goad-py
-Version: 0.4.1
+Version: 0.5.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Scientific/Engineering :: Physics

goad_py-0.5.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+goad_py-0.5.1.dist-info/METADATA,sha256=K7tRbZ6OB21i5UXKQIQo12P2nhgD12d6QSi_D_ntNdw,3181
+goad_py-0.5.1.dist-info/WHEEL,sha256=Y-XoD5BXFXbl1oL2pSk_D17tiXoT-Jq8mjjLLKU_QmM,105
+goad_py.libs/libgcc_s-98a1ef30.so.1,sha256=XOVRhHznCIpbSdhFoozhla-OfRqBtXftKPQ4cSMKjrs,433441
+goad_py.libs/libstdc++-25756182.so.6,sha256=rqmv3cdlW48F3_LjOuNDrMaEr5iuwKfeB5d5Y6bLHEc,18039817
+goad_py/__init__.py,sha256=vZn5zZZdTgm1qTQFYCqgNKBKDAoheMo5OvwdLIIl3Dk,242
+goad_py/_goad_py.abi3.so,sha256=s69qDrShjtppuz57PDWt5_CVDImnsO-dvhkMB5_oNP4,2252721
+goad_py/convergence.py,sha256=8HTlrpv3RLD8FfmZuT_2mySVtnpHaPLKx6Rcw-jDgB0,14930
+goad_py/goad_py.pyi,sha256=7Y79-TV-NjEN8DWPEqSRGQ7alCrkylL6y1ZK8d6FYSg,14502
+goad_py-0.5.1.dist-info/RECORD,,

{goad_py-0.4.1.dist-info → goad_py-0.5.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.1)
+Generator: maturin (1.9.4)
 Root-Is-Purelib: false
 Tag: cp38-abi3-musllinux_1_2_x86_64

goad_py-0.4.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-goad_py-0.4.1.dist-info/METADATA,sha256=weu904gJ_ghV0hXUdpIPRnB0e9Mm7ZvPMAcVIhux_LI,3181
-goad_py-0.4.1.dist-info/WHEEL,sha256=yEGuUI9QILZteA9citfSGdI2Y8tgD4khiTETnnbYWzA,105
-goad_py.libs/libgcc_s-1e52349c.so.1,sha256=Ani0u_W_tB8ESsFePO4D2mn2lrgWLhyFdw6RETxBTYM,437537
-goad_py.libs/libstdc++-e3b7606c.so.6,sha256=0od4MdFOKqq1GTnbD4qV7uMNWb0Hte3YHycydGf5nOU,18138121
-goad_py/__init__.py,sha256=vZn5zZZdTgm1qTQFYCqgNKBKDAoheMo5OvwdLIIl3Dk,242
-goad_py/_goad_py.abi3.so,sha256=Zig7zrPmYkBLaFeZ9PNBCad0QXsYACbmEsvGyWy4EtE,2359185
-goad_py/convergence.py,sha256=8HTlrpv3RLD8FfmZuT_2mySVtnpHaPLKx6Rcw-jDgB0,14930
-goad_py/goad_py.pyi,sha256=Ue33wS-DLeI2JTwpKyPXNk4D-Trt9S5MBQSO8qW5XGc,14922
-goad_py-0.4.1.dist-info/RECORD,,