pyant 0.11.0__tar.gz

pyant-0.11.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2019] [Daniel Kastinen, Juha Vierinen, Tom Grydeland]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyant-0.11.0/MANIFEST.in

@@ -0,0 +1,2 @@
+graft src/clibbeam
+include README.md

pyant-0.11.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.1
+Name: pyant
+Version: 0.11.0
+Summary: Radar antenna models in python
+Author-email: Daniel Kastinen <daniel.kastinen@irf.se>, Tom Grydeland <tgry@norceresearch.no>, Juha Vierinen <juha-pekka.vierinen@uit.no>
+Maintainer-email: Daniel Kastinen <daniel.kastinen@irf.se>
+License: MIT License
+        
+        Copyright (c) [2019] [Daniel Kastinen, Juha Vierinen, Tom Grydeland]
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Documentation, https://danielk.developer.irf.se/pyant/
+Project-URL: Repository, https://github.com/danielk333/pyant
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+Provides-Extra: develop
+Provides-Extra: notebooks
+Provides-Extra: profiling
+License-File: LICENSE
+
+# PyAnt
+
+PyAnt is a standardization for implementing radar gain pattern in Python. Nothing more, nothing less.
+
+## Getting started
+
+To install
+
+```bash
+    pip install pyant
+```
+
+or for the nightly build
+
+```bash
+    git clone git@github.com:danielk333/pyant.git
+    cd pyant
+    git checkout develop
+    pip install .
+```
+
+Alternatively, if you are following updates closely you can install using ``pip install -e .`` so that in the future a ``git pull`` will update the library.
+
+Then get started by looking at the examples gallery and API in the Documentation.
+
+## Example
+
+Plot the gain pattern of a dish radar modeled using the Cassegrain model.
+
+```python
+import matplotlib.pyplot as plt
+import pyant
+
+ant = pyant.Cassegrain(
+    azimuth=0,
+    elevation=90.0,
+    frequency=930e6,
+    I0=10**4.81,
+    a0=23.0,
+    a1=40.0,
+    degrees=True,
+)
+
+pyant.plotting.gain_heatmap(ant, resolution=301, min_elevation=80.0)
+plt.show()
+```

pyant-0.11.0/README.md

@@ -0,0 +1,46 @@
+# PyAnt
+
+PyAnt is a standardization for implementing radar gain pattern in Python. Nothing more, nothing less.
+
+## Getting started
+
+To install
+
+```bash
+    pip install pyant
+```
+
+or for the nightly build
+
+```bash
+    git clone git@github.com:danielk333/pyant.git
+    cd pyant
+    git checkout develop
+    pip install .
+```
+
+Alternatively, if you are following updates closely you can install using ``pip install -e .`` so that in the future a ``git pull`` will update the library.
+
+Then get started by looking at the examples gallery and API in the Documentation.
+
+## Example
+
+Plot the gain pattern of a dish radar modeled using the Cassegrain model.
+
+```python
+import matplotlib.pyplot as plt
+import pyant
+
+ant = pyant.Cassegrain(
+    azimuth=0,
+    elevation=90.0,
+    frequency=930e6,
+    I0=10**4.81,
+    a0=23.0,
+    a1=40.0,
+    degrees=True,
+)
+
+pyant.plotting.gain_heatmap(ant, resolution=301, min_elevation=80.0)
+plt.show()
+```

pyant-0.11.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyant"
+description = "Radar antenna models in python"
+readme = {file = "README.md", content-type = "text/markdown"}
+authors = [
+    {name = "Daniel Kastinen", email = "daniel.kastinen@irf.se"},
+    {name = "Tom Grydeland", email = "tgry@norceresearch.no"},
+    {name = "Juha Vierinen", email = "juha-pekka.vierinen@uit.no"},
+]
+maintainers = [
+    {name = "Daniel Kastinen", email = "daniel.kastinen@irf.se"},
+]
+license = {file = "LICENSE"}
+classifiers = [
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Physics",
+    "Operating System :: OS Independent",
+    "License :: OSI Approved :: MIT License",
+]
+requires-python = ">=3.5"
+dependencies = [
+    "numpy >= 1.14.3",
+    "scipy >= 1.1.0",
+    "matplotlib >= 3.2.0",
+]
+dynamic = ["version"]
+
+[tool.setuptools]
+include-package-data = true
+license-files = ["LICENSE"]
+
+[tool.setuptools.dynamic]
+version = {attr = "pyant.version.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"pyant.beams" = ["data/*"]
+
+[project.optional-dependencies]
+develop = [
+    "pytest >= 6.2.5",
+    "sphinx >= 4.2.0",
+    "flake8 >= 6.0.0",
+    "wheel >= 0.37.0",
+    "build >= 0.7.0",
+    "twine >= 3.4.2",
+    "pytest-cov >= 4.1.0",
+    "sphinx-gallery >= 0.3.1",
+    "matplotlib >= 3.5.1",
+    "myst-nb >= 0.17.2",
+    "ipykernel >= 6.9.1",
+    "radon >= 5.1.0",
+    "numpydoc >= 1.2",
+    "pre-commit > 3.0.0",
+    "black >= 23.3.0",
+    "auditwheel >= 5.4.0",
+    "patchelf >= 0.14",
+]
+notebooks = [
+    "notebook >= 6.5.4",
+    "jupytext >= 1.14.5",
+]
+profiling = [
+    "yappi >= 1.4.0",
+]
+
+[project.urls]
+Documentation = "https://danielk.developer.irf.se/pyant/"
+Repository = "https://github.com/danielk333/pyant"
+
+[tool.black]
+line-length = 100
+target_version = ['py35', 'py36', 'py37', 'py38', 'py39', 'py310']

pyant-0.11.0/setup.cfg

@@ -0,0 +1,9 @@
+[flake8]
+ignore = D203,E251,E126,E226,W504,W503,W605
+max-line-length = 100
+exclude = src/pyant/__pycache__,src/pyant/__init__.py,src/pyant/**/__init__.py
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyant-0.11.0/setup.py

@@ -0,0 +1,32 @@
+import setuptools
+from distutils.core import Extension
+import pathlib
+import codecs
+
+HERE = pathlib.Path(__file__).resolve().parents[0]
+
+
+def get_version(path):
+    with codecs.open(path, 'r') as fp:
+        for line in fp.read().splitlines():
+            if line.startswith('__version__'):
+                delim = '"' if '"' in line else "'"
+                return line.split(delim)[1]
+        else:
+            raise RuntimeError("Unable to find version string.")
+
+
+clib_beam = Extension(
+    name='pyant.clibbeam',
+    sources=[
+        'src/clibbeam/array.c',
+        'src/clibbeam/beam.c',
+    ],
+    include_dirs=['src/clibbeam/'],
+)
+
+
+setuptools.setup(
+    version=get_version(HERE / 'src' / 'pyant' / 'version.py'),
+    ext_modules=[clib_beam],
+)

pyant-0.11.0/src/clibbeam/Makefile

@@ -0,0 +1,26 @@
+CC=gcc
+CFLAGS=-fPIC
+LIBS=-lm
+
+SOURCES=$(wildcard *.c)
+OBJECTS=$(SOURCES:.c=.o)
+EXT=$(shell python -c "import sysconfig; print(sysconfig.get_config_var('EXT_SUFFIX'))")
+OUTLIB=clibbeam$(EXT)
+
+all: $(OUTLIB)
+
+%.o: %.c
+	@echo "pyant installation -> Compiling source file $< ..."
+	$(CC) -c $(CFLAGS) -o $@ $<
+
+$(OUTLIB): $(OBJECTS)
+	@echo "pyant installation -> Linking shared library $@ ..."
+	$(CC) $(CFLAGS) -shared $(OBJECTS) $(LIBS) -o $@
+	@mv $@ ../pyant/ -v
+	@echo "pyant installation -> The shared library $< has been created successfully."
+
+clean:
+	@echo "pyant installation -> Removing object files *.o ..."
+	@-rm -f *.o
+	@echo "pyant installation -> Removing shared library *.so ..."
+	@-rm -f *.so

pyant-0.11.0/src/clibbeam/array.c

@@ -0,0 +1,17 @@
+#include <stdio.h>
+#include <complex.h>
+#include <math.h>
+#include "beam.h"
+
+
+void
+array_sensor_response(
+    double *k,
+    double complex *G,
+    size_t channels
+)
+{
+    for(size_t ch = 0; ch < channels; ch++) {
+        G[ch] = 1.0;
+    }
+}

pyant-0.11.0/src/clibbeam/beam.c

@@ -0,0 +1,20 @@
+#include <stdio.h>
+#include <complex.h>
+#include <math.h>
+#include "beam.h"
+
+int
+main(int argc, char *argv[])
+{
+    double kvec[3];
+    size_t channels = 1;
+    double complex G[channels];
+    kvec[0] = 0.0;
+    kvec[1] = 0.0;
+    kvec[2] = 1.0;
+    array_sensor_response(kvec, G, channels);
+
+    printf("Hello, G = %.2f + %.2fi\n", creal(G[0]), cimag(G[0]));
+
+    return 0;
+}

pyant-0.11.0/src/clibbeam/beam.h

@@ -0,0 +1,11 @@
+// inclusion guard
+#ifndef BEAM_H_
+#define BEAM_H_
+
+void
+array_sensor_response(
+    double *k,
+    double complex *G,
+    size_t channels
+);
+#endif // BEAM_H_

pyant-0.11.0/src/pyant/__init__.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python
+
+"""
+
+"""
+
+from .version import __version__
+
+# Modules
+from . import plotting
+from . import coordinates
+from . import beams
+from . import models
+from . import statistics
+from . import clib
+
+# Classes
+from .beam import Beam, SummedBeams
+from .beams import Radars, Models
+
+# Functions
+from .beams import (
+    beam_of_radar,
+    avalible_beams,
+    parameters_of_radar,
+    avalible_radar_info,
+)
+
+# Static
+from .beams import UNITS
+
+# Profiling
+from .profiling import profile, profile_stop, get_profile, print_profile