eas-3d-pattern

eas-3d-pattern is python library to visualize and make simple beam efficiency calculations on 3D antenna pattern data which follows the NGMN BASTA schema.

Installation

Use the package manager pip to install eas-3d-pattern.

pip install eas-3d-pattern

Usage

from eas_3d_pattern import AntennaPattern, SAMPLE_JSON

pattern = AntennaPattern(SAMPLE_JSON[0], validate=True) # reads a JSON and validates schema
pattern.calculate_beam_efficiency() # Calculates beam efficiency for standard EAS regions
pattern.plot() # plots an interactive heatmap of the normalized antenna pattern

For further examples, please check the example notebooks

Resources

• NGMN BASTA schema
• Example JSON files
• Example of Beam Efficiency Report / EAS Definitions

Features

• Loads and validates NGMN JSON schema from NGMN homepage (fallback if no internet access)
• Parses various JSON structures from different sources with ease
• Beam efficiency calculation
• Custom rectangular and default sector definitions
• Interactive visualization of 3D antenna pattern

To-Do

• Add tests / CICD
• Add different calculation methods
• Add more complex sector shapes
• Plot sector regions
• Improve interface to work with multiple JSON files