eas-3d-pattern

A Python library for visualizing and computing beam efficiency on 3D antenna radiation patterns conforming to the NGMN BASTA JSON schema.

What is this?

Given a 3D radiation pattern in JSON format which follows the NGMN BASTA (Base Station Antenna Standards) specification, with this library you can:

• Parse the BASTA-compliant JSON, handles multiple coordinate systems and sampling formats automatically
• Calculate beam efficiency across configurable sectors (EAS methodology)
• Visualize patterns as 2D heatmaps and 3D polar plots

Installation

pip install eas-3d-pattern

git clone https://github.com/Ericsson/eas-3d-pattern.git
cd eas-3d-pattern
poetry install

poetry run pytest

poetry run ruff check .
poetry run ruff format .

Quick Start

from eas_3d_pattern import AntennaPattern, SAMPLE_JSON

# Load a 3D radiation pattern from JSON
pattern = AntennaPattern(SAMPLE_JSON[0])

# Inspect antenna parameters
print(f"{pattern.antenna_model} @ {pattern.frequency_hz / 1e6:.0f} MHz — {pattern.gain_dbi:.1f} dBi")
# → ANTMODEL1 @ 2100 MHz — 18.3 dBi

# Calculate beam efficiency (EAS default sectors)
efficiency = pattern.calculate_beam_efficiency()
print(f"Cell sector: {efficiency['Cell'] * 100:.1f}%")
# → Cell sector: 72.4%

# Visualize the normalized power pattern
pattern.plot()

Features

Examples

See the example notebooks for detailed walkthroughs.

Resources

• NGMN BASTA specification
• NGMN BASTA JSON Schema
• Example BASTA JSON files

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.