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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phased-array-modeling
-Version: 1.0.0
+Version: 1.2.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.2.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.2.0/phased_array/__init__.py

@@ -0,0 +1,225 @@
+"""
+Phased Array Antenna Modeling Package
+
+A comprehensive Python library for computing and visualizing phased array
+antenna radiation patterns, including:
+
+- Vectorized array factor computation (50-100x faster than loops)
+- FFT-based pattern computation for uniform rectangular arrays
+- Various array geometries (rectangular, circular, conformal, sparse)
+- Beamforming techniques (tapering, null steering, multi-beam)
+- Realistic impairments (mutual coupling, quantization, failures, scan blindness)
+- Interactive 3D visualization with Plotly
+- UV-space pattern representation
+
+Example
+-------
+>>> import phased_array as pa
+>>> import numpy as np
+>>>
+>>> # Create a 10x10 rectangular array, half-wavelength spacing
+>>> geom = pa.create_rectangular_array(10, 10, dx=0.5, dy=0.5)
+>>>
+>>> # Compute steering weights for 30 deg scan
+>>> k = pa.wavelength_to_k(1.0)  # normalized wavelength
+>>> weights = pa.steering_vector(k, geom.x, geom.y, theta0_deg=30, phi0_deg=0)
+>>>
+>>> # Apply Taylor taper for sidelobe control
+>>> taper = pa.taylor_taper_2d(10, 10, sidelobe_dB=-30)
+>>> weights = weights * taper
+>>>
+>>> # Compute and plot pattern
+>>> theta, phi, pattern_dB = pa.compute_full_pattern(geom.x, geom.y, weights, k)
+"""
+
+__version__ = "1.2.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 (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,
+                       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; 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; UV-space; 3D Plotly plots; Wideband
+    compute_pattern_uv_space, create_pattern_animation_plotly,
+    plot_array_geometry, plot_array_geometry_3d_plotly, plot_beam_squint,
+    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, plot_pattern_vs_frequency,
+    plot_pattern_vs_frequency_plotly, plot_subarray_delays)
+# Wideband / TTD functions
+from .wideband import (analyze_instantaneous_bandwidth, compare_steering_modes,
+                       compute_beam_squint, compute_pattern_vs_frequency,
+                       compute_subarray_delays_ttd,
+                       compute_subarray_weights_hybrid, steering_delays_ttd,
+                       steering_vector_hybrid, steering_vector_ttd)
+
+__all__ = [
+    # Version
+    "__version__",
+    # Core
+    "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",
+    # Utils
+    "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",
+    # Geometry
+    "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
+    "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_projection",
+    "null_steering_lcmv",
+    "compute_null_depth",
+    "multi_beam_weights_superposition",
+    "multi_beam_weights_orthogonal",
+    "compute_beam_isolation",
+    "monopulse_weights",
+    # Impairments
+    "mutual_coupling_matrix_theoretical",
+    "mutual_coupling_matrix_measured",
+    "apply_mutual_coupling",
+    "active_element_pattern",
+    "quantize_phase",
+    "quantization_rms_error",
+    "quantization_sidelobe_increase",
+    "analyze_quantization_effect",
+    "simulate_element_failures",
+    "analyze_graceful_degradation",
+    "surface_wave_scan_angle",
+    "scan_blindness_model",
+    "apply_scan_blindness",
+    "compute_scan_loss",
+    # Visualization
+    "plot_pattern_2d",
+    "plot_pattern_polar",
+    "plot_pattern_contour",
+    "plot_array_geometry",
+    "compute_pattern_uv_space",
+    "plot_pattern_uv_space",
+    "plot_pattern_3d_plotly",
+    "plot_pattern_3d_cartesian_plotly",
+    "plot_array_geometry_3d_plotly",
+    "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",
+    # Wideband / TTD
+    "steering_vector_ttd",
+    "steering_delays_ttd",
+    "steering_vector_hybrid",
+    "compute_subarray_delays_ttd",
+    "compute_beam_squint",
+    "analyze_instantaneous_bandwidth",
+    "compute_pattern_vs_frequency",
+    "compute_subarray_weights_hybrid",
+    "compare_steering_modes",
+    # Wideband visualization
+    "plot_beam_squint",
+    "plot_pattern_vs_frequency",
+    "plot_pattern_vs_frequency_plotly",
+    "plot_subarray_delays",
+]

{phased_array_modeling-1.0.0 → phased_array_modeling-1.2.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.2.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]