phased-array-modeling 1.0.0__tar.gz → 1.1.0__tar.gz

{phased_array_modeling-1.0.0/phased_array_modeling.egg-info → phased_array_modeling-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phased-array-modeling
-Version: 1.0.0
+Version: 1.1.0
 Summary: Comprehensive Python library for phased array antenna modeling and visualization
 Author-email: John Hodge <jah70@vt.edu>
 License: MIT
@@ -42,9 +42,12 @@ Dynamic: license-file
 # Phased Array Antenna Modeling
 
 [![CI](https://github.com/jman4162/Phased-Array-Antenna-Model/actions/workflows/ci.yml/badge.svg)](https://github.com/jman4162/Phased-Array-Antenna-Model/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/phased-array-modeling.svg)](https://pypi.org/project/phased-array-modeling/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/phased-array-modeling.svg)](https://pypi.org/project/phased-array-modeling/)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/jman4162/Phased-Array-Antenna-Model/blob/main/Phased_Array_Demo.ipynb)
+[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://phased-array-antenna-model.streamlit.app/)
 
 A comprehensive Python library for computing and visualizing phased array antenna radiation patterns. Features **125x faster** vectorized computations, multiple array geometries, advanced beamforming, and interactive 3D visualization.
 
@@ -56,23 +59,36 @@ A comprehensive Python library for computing and visualizing phased array antenn
 - **Realistic Impairments**: Mutual coupling, phase quantization, element failures, scan blindness
 - **Visualization**: 2D matplotlib, interactive 3D Plotly, UV-space representation
 - **Subarray Support**: Subarray-level beamforming with quantized phase shifters
+- **Data Export**: CSV, JSON, and NumPy formats for patterns, weights, and geometry
+
+## Try it Online
+
+**[Launch Interactive Web App](https://phased-array-antenna-model.streamlit.app/)** - No installation required!
+
+The Streamlit app provides an interactive interface for:
+- Designing array geometries (rectangular, triangular, circular, concentric rings, elliptical)
+- Beam steering with real-time pattern visualization
+- Amplitude tapering with sidelobe comparison
+- Impairment simulation (phase quantization, element failures, mutual coupling)
+- UV-space pattern analysis
+- Export data to CSV for further analysis
 
 ## Installation
 
 ### From GitHub (recommended)
 
 ```bash
-pip install git+https://github.com/jman4162/Phased-Array-Antenna-Model.git
+pip install phased-array-modeling
 ```
 
 ### With optional dependencies
 
 ```bash
 # Include Plotly for 3D visualization
-pip install "phased-array[plotting] @ git+https://github.com/jman4162/Phased-Array-Antenna-Model.git"
+pip install "phased-array-modeling[plotting]"
 
 # Include all optional dependencies
-pip install "phased-array[full] @ git+https://github.com/jman4162/Phased-Array-Antenna-Model.git"
+pip install "phased-array-modeling[full]"
 ```
 
 ### For development

{phased_array_modeling-1.0.0 → phased_array_modeling-1.1.0}/README.md

@@ -1,9 +1,12 @@
 # Phased Array Antenna Modeling
 
 [![CI](https://github.com/jman4162/Phased-Array-Antenna-Model/actions/workflows/ci.yml/badge.svg)](https://github.com/jman4162/Phased-Array-Antenna-Model/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/phased-array-modeling.svg)](https://pypi.org/project/phased-array-modeling/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/phased-array-modeling.svg)](https://pypi.org/project/phased-array-modeling/)
 [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/jman4162/Phased-Array-Antenna-Model/blob/main/Phased_Array_Demo.ipynb)
+[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://phased-array-antenna-model.streamlit.app/)
 
 A comprehensive Python library for computing and visualizing phased array antenna radiation patterns. Features **125x faster** vectorized computations, multiple array geometries, advanced beamforming, and interactive 3D visualization.
 
@@ -15,23 +18,36 @@ A comprehensive Python library for computing and visualizing phased array antenn
 - **Realistic Impairments**: Mutual coupling, phase quantization, element failures, scan blindness
 - **Visualization**: 2D matplotlib, interactive 3D Plotly, UV-space representation
 - **Subarray Support**: Subarray-level beamforming with quantized phase shifters
+- **Data Export**: CSV, JSON, and NumPy formats for patterns, weights, and geometry
+
+## Try it Online
+
+**[Launch Interactive Web App](https://phased-array-antenna-model.streamlit.app/)** - No installation required!
+
+The Streamlit app provides an interactive interface for:
+- Designing array geometries (rectangular, triangular, circular, concentric rings, elliptical)
+- Beam steering with real-time pattern visualization
+- Amplitude tapering with sidelobe comparison
+- Impairment simulation (phase quantization, element failures, mutual coupling)
+- UV-space pattern analysis
+- Export data to CSV for further analysis
 
 ## Installation
 
 ### From GitHub (recommended)
 
 ```bash
-pip install git+https://github.com/jman4162/Phased-Array-Antenna-Model.git
+pip install phased-array-modeling
 ```
 
 ### With optional dependencies
 
 ```bash
 # Include Plotly for 3D visualization
-pip install "phased-array[plotting] @ git+https://github.com/jman4162/Phased-Array-Antenna-Model.git"
+pip install "phased-array-modeling[plotting]"
 
 # Include all optional dependencies
-pip install "phased-array[full] @ git+https://github.com/jman4162/Phased-Array-Antenna-Model.git"
+pip install "phased-array-modeling[full]"
 ```
 
 ### For development

{phased_array_modeling-1.0.0 → phased_array_modeling-1.1.0}/phased_array/__init__.py

@@ -32,133 +32,62 @@ Example
 >>> theta, phi, pattern_dB = pa.compute_full_pattern(geom.x, geom.y, weights, k)
 """
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
+# Beamforming functions
+from .beamforming import (  # Amplitude tapers; Null steering; Multiple beams
+    apply_taper_to_geometry, chebyshev_taper_1d, chebyshev_taper_2d,
+    compute_beam_isolation, compute_null_depth, compute_taper_directivity_loss,
+    compute_taper_efficiency, cosine_on_pedestal_taper_1d,
+    cosine_on_pedestal_taper_2d, cosine_taper_1d, cosine_taper_2d,
+    gaussian_taper_1d, gaussian_taper_2d, hamming_taper_1d, hamming_taper_2d,
+    hanning_taper_1d, hanning_taper_2d, monopulse_weights,
+    multi_beam_weights_orthogonal, multi_beam_weights_superposition,
+    null_steering_lcmv, null_steering_projection, taylor_taper_1d,
+    taylor_taper_2d)
 # Core computation functions
-from .core import (
-    steering_vector,
-    array_factor_vectorized,
-    array_factor_uv,
-    array_factor_fft,
-    element_pattern,
-    element_pattern_cosine_tapered,
-    total_pattern,
-    compute_pattern_cuts,
-    compute_full_pattern,
-    compute_directivity,
-    compute_half_power_beamwidth,
-)
-
-# Utility functions
-from .utils import (
-    deg2rad,
-    rad2deg,
-    azel_to_thetaphi,
-    thetaphi_to_azel,
-    theta_phi_to_uv,
-    uv_to_theta_phi,
-    is_visible_region,
-    wavelength_to_k,
-    frequency_to_wavelength,
-    frequency_to_k,
-    db_to_linear,
-    linear_to_db,
-    normalize_pattern,
-    create_theta_phi_grid,
-    create_uv_grid,
-)
-
+from .core import (array_factor_fft, array_factor_uv, array_factor_vectorized,
+                   compute_directivity, compute_full_pattern,
+                   compute_half_power_beamwidth, compute_pattern_cuts,
+                   element_pattern, element_pattern_cosine_tapered,
+                   steering_vector, total_pattern)
+# Export functions
+from .export import (export_array_config_json, export_coupling_matrix_csv,
+                     export_geometry_csv, export_pattern_2d_csv,
+                     export_pattern_csv, export_pattern_npz,
+                     export_summary_report, export_uv_pattern_csv,
+                     export_weights_csv, load_pattern_npz)
 # Geometry classes and functions
-from .geometry import (
-    ArrayGeometry,
-    SubarrayArchitecture,
-    create_rectangular_array,
-    create_triangular_array,
-    create_elliptical_array,
-    create_circular_array,
-    create_concentric_rings_array,
-    create_cylindrical_array,
-    create_spherical_array,
-    thin_array_random,
-    thin_array_density_tapered,
-    thin_array_genetic_algorithm,
-    create_rectangular_subarrays,
-    compute_subarray_weights,
-    array_factor_conformal,
-)
-
-# Beamforming functions
-from .beamforming import (
-    # Amplitude tapers
-    taylor_taper_1d,
-    taylor_taper_2d,
-    chebyshev_taper_1d,
-    chebyshev_taper_2d,
-    hamming_taper_1d,
-    hamming_taper_2d,
-    hanning_taper_1d,
-    hanning_taper_2d,
-    cosine_taper_1d,
-    cosine_taper_2d,
-    cosine_on_pedestal_taper_1d,
-    cosine_on_pedestal_taper_2d,
-    gaussian_taper_1d,
-    gaussian_taper_2d,
-    compute_taper_efficiency,
-    compute_taper_directivity_loss,
-    apply_taper_to_geometry,
-    # Null steering
-    null_steering_projection,
-    null_steering_lcmv,
-    compute_null_depth,
-    # Multiple beams
-    multi_beam_weights_superposition,
-    multi_beam_weights_orthogonal,
-    compute_beam_isolation,
-    monopulse_weights,
-)
-
+from .geometry import (ArrayGeometry, SubarrayArchitecture,
+                       array_factor_conformal, compute_subarray_weights,
+                       create_circular_array, create_concentric_rings_array,
+                       create_cylindrical_array, create_elliptical_array,
+                       create_rectangular_array, create_rectangular_subarrays,
+                       create_spherical_array, create_triangular_array,
+                       thin_array_density_tapered,
+                       thin_array_genetic_algorithm, thin_array_random)
 # Impairment models
-from .impairments import (
-    # Mutual coupling
-    mutual_coupling_matrix_theoretical,
-    mutual_coupling_matrix_measured,
-    apply_mutual_coupling,
-    active_element_pattern,
-    # Phase quantization
-    quantize_phase,
-    quantization_rms_error,
-    quantization_sidelobe_increase,
-    analyze_quantization_effect,
-    # Element failures
-    simulate_element_failures,
-    analyze_graceful_degradation,
-    # Scan blindness
-    surface_wave_scan_angle,
-    scan_blindness_model,
-    apply_scan_blindness,
-    compute_scan_loss,
-)
-
+from .impairments import (  # Mutual coupling; Phase quantization; Element failures; Scan blindness
+    active_element_pattern, analyze_graceful_degradation,
+    analyze_quantization_effect, apply_mutual_coupling, apply_scan_blindness,
+    compute_scan_loss, mutual_coupling_matrix_measured,
+    mutual_coupling_matrix_theoretical, quantization_rms_error,
+    quantization_sidelobe_increase, quantize_phase, scan_blindness_model,
+    simulate_element_failures, surface_wave_scan_angle)
+# Utility functions
+from .utils import (azel_to_thetaphi, create_theta_phi_grid, create_uv_grid,
+                    db_to_linear, deg2rad, frequency_to_k,
+                    frequency_to_wavelength, is_visible_region, linear_to_db,
+                    normalize_pattern, rad2deg, theta_phi_to_uv,
+                    thetaphi_to_azel, uv_to_theta_phi, wavelength_to_k)
 # Visualization functions
-from .visualization import (
-    # 2D matplotlib plots
-    plot_pattern_2d,
-    plot_pattern_polar,
-    plot_pattern_contour,
-    plot_array_geometry,
-    # UV-space
-    compute_pattern_uv_space,
-    plot_pattern_uv_space,
-    # 3D Plotly plots
-    plot_pattern_3d_plotly,
-    plot_pattern_3d_cartesian_plotly,
-    plot_array_geometry_3d_plotly,
-    plot_pattern_uv_plotly,
-    # Utilities
-    plot_comparison_patterns,
-    create_pattern_animation_plotly,
-)
+from .visualization import (  # 2D matplotlib plots; UV-space; 3D Plotly plots; Utilities
+    compute_pattern_uv_space, create_pattern_animation_plotly,
+    plot_array_geometry, plot_array_geometry_3d_plotly,
+    plot_comparison_patterns, plot_pattern_2d,
+    plot_pattern_3d_cartesian_plotly, plot_pattern_3d_plotly,
+    plot_pattern_contour, plot_pattern_polar, plot_pattern_uv_plotly,
+    plot_pattern_uv_space)
 
 __all__ = [
     # Version
@@ -260,4 +189,15 @@ __all__ = [
     "plot_pattern_uv_plotly",
     "plot_comparison_patterns",
     "create_pattern_animation_plotly",
+    # Export
+    "export_pattern_csv",
+    "export_pattern_2d_csv",
+    "export_uv_pattern_csv",
+    "export_weights_csv",
+    "export_geometry_csv",
+    "export_array_config_json",
+    "export_pattern_npz",
+    "load_pattern_npz",
+    "export_coupling_matrix_csv",
+    "export_summary_report",
 ]

{phased_array_modeling-1.0.0 → phased_array_modeling-1.1.0}/phased_array/beamforming.py

@@ -4,11 +4,13 @@ Beamforming functions for phased arrays.
 Includes amplitude tapering, null steering, and multiple simultaneous beams.
 """
 
+from typing import List, Optional, Tuple, Union
+
 import numpy as np
 from scipy import signal
-from typing import Tuple, Optional, List, Union
-from .geometry import ArrayGeometry
+
 from .core import steering_vector
+from .geometry import ArrayGeometry
 
 ArrayLike = Union[np.ndarray, float]
 

{phased_array_modeling-1.0.0 → phased_array_modeling-1.1.0}/phased_array/core.py

@@ -5,9 +5,11 @@ Includes vectorized array factor, FFT-based computation, steering vectors,
 and element patterns.
 """
 
+from typing import Optional, Tuple, Union
+
 import numpy as np
-from typing import Tuple, Optional, Union
-from .utils import theta_phi_to_uv, create_theta_phi_grid, linear_to_db
+
+from .utils import create_theta_phi_grid, linear_to_db, theta_phi_to_uv
 
 ArrayLike = Union[np.ndarray, float]