ams-adf-reader 0.2.2__tar.gz

ams_adf_reader-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Hüseyin YİĞİT
+
+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.

ams_adf_reader-0.2.2/MANIFEST.in

@@ -0,0 +1 @@
+include VERSION

ams_adf_reader-0.2.2/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.1
+Name: ams-adf-reader
+Version: 0.2.2
+Summary: Antenna Measurement Software (AMS) File Format (ADF) Reader 
+Home-page: https://github.com/yigithsyn/ams-adf-reader
+Author: Hüseyin YİĞİT
+Author-email: yigit.hsyn@gmail.com
+License: MIT License
+Platform: Any
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Other Audience
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >= 3.4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: h5py
+
+# ams-adf-reader
+
+Antenna Measurement Software (AMS) File Format (ADF) Reader

ams_adf_reader-0.2.2/README.md

@@ -0,0 +1,3 @@
+# ams-adf-reader
+
+Antenna Measurement Software (AMS) File Format (ADF) Reader

ams_adf_reader-0.2.2/VERSION

@@ -0,0 +1 @@
+0.2.2

ams_adf_reader-0.2.2/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"

ams_adf_reader-0.2.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ams_adf_reader-0.2.2/setup.py

@@ -0,0 +1,50 @@
+import os
+import sys
+import pathlib
+from setuptools import setup, find_packages, find_namespace_packages
+
+# The directory containing this file
+HERE = pathlib.Path(__file__).parent
+
+# The text of the README file
+README = (HERE / "README.md").read_text()
+
+# Version: major.minor.patch
+VERSION = (HERE / "VERSION").read_text().strip()
+
+# License
+LICENSE = 'MIT License'
+
+# Required Python version
+PYTHON_VERSION = '>= 3.4'
+
+
+setup \
+    ( name             = "ams-adf-reader"
+    , version          = VERSION
+    , description      = "Antenna Measurement Software (AMS) File Format (ADF) Reader "
+    , long_description = README
+    , long_description_content_type='text/markdown'
+    , license          = LICENSE
+    , author           = "Hüseyin YİĞİT"
+    , author_email     = "yigit.hsyn@gmail.com"
+    , install_requires = \
+        [ 'h5py' ]
+    , packages         = find_namespace_packages(where='src'),
+      package_dir      = {"": "src"}
+    , platforms        = 'Any'
+    , url              = "https://github.com/yigithsyn/ams-adf-reader"
+    , python_requires  = PYTHON_VERSION
+    , classifiers      = \
+        [ 'Development Status :: 2 - Pre-Alpha'
+        , 'License :: OSI Approved :: ' + LICENSE
+        , 'Operating System :: OS Independent'
+        , 'Programming Language :: Python'
+        , 'Programming Language :: Python :: 3'
+        , 'Intended Audience :: Science/Research'
+        , 'Intended Audience :: Other Audience'
+        , 'Topic :: Scientific/Engineering'
+        , 'Topic :: Scientific/Engineering :: Mathematics'
+        , 'Topic :: Scientific/Engineering :: Physics'
+        ]
+    )

ams_adf_reader-0.2.2/src/ams-adf-reader/Measurement.py

@@ -0,0 +1,126 @@
+import os, pathlib, datetime
+from enum import Flag, auto
+import h5py
+
+class MeasurementType(Flag):
+  PLANAR_XSCAN = auto()
+  PLANAR_YSCAN = auto()
+  PLANAR       = PLANAR_XSCAN | PLANAR_YSCAN
+  CUSTOM       = auto()
+
+class Measurement:
+
+  r""" Antenna Measurement System (AMS) data file object
+
+  Parameters
+  ----------
+  filename : str
+             measurement file name
+
+  """
+  def __init__(self, filename: str):
+    if os.path.exists(filename):
+      if pathlib.Path(filename).suffix == ".adf":
+        self.hdf = h5py.File(filename, 'r')
+
+        datetimestr = self.hdf['Radiation Pattern']['ATTRIBUTES']['History'].attrs['Measurement Start'].strip()
+        self.start  = datetime.datetime.strptime(datetimestr, "%a %b %d %H:%M:%S %Y")
+
+        datetimestr = self.hdf['Radiation Pattern']['ATTRIBUTES']['History'].attrs['Measurement Finished'].strip()
+        self.finish = datetime.datetime.strptime(datetimestr, "%a %b %d %H:%M:%S %Y")
+
+        self.duration = (self.finish - self.start).total_seconds()
+
+        self.axes = tuple(self.hdf['Radiation Pattern']['Radiation Pattern'].attrs['DIMENSION_LABELS'])
+        self.axesValues = tuple()
+        for item in self.axes:
+          self.axesValues += (self.hdf['Radiation Pattern'][item][:],)
+        
+        if self.axes[0] == "Pol" and self.axes[1] == "x" and self.axes[2] == "y" and self.axes[3] == "Frequency":
+          self.type = MeasurementType.PLANAR_YSCAN
+        elif self.axes[0] == "Pol" and self.axes[1] == "y" and self.axes[2] == "x" and self.axes[3] == "Frequency":
+          self.type = MeasurementType.PLANAR_XSCAN
+        else:
+          self.type = MeasurementType.CUSTOM
+        
+        self.data = self.hdf['Radiation Pattern']['Radiation Pattern'][:].tolist()
+
+        self.axesPositionsInitial = self.hdf['Radiation Pattern']['ATTRIBUTES']['Status after Init'].attrs['Positions']
+        self.axesPositionsEnd     = self.hdf['Radiation Pattern']['ATTRIBUTES']['Status after Measurement'].attrs['Positions']
+
+      else:
+        raise ValueError("Filename must be valid .adf type")
+    else:
+      raise FileNotFoundError
+
+  def exportForNSI(self, path, **kwargs):
+    r""" Exports measurement data for NSI2000 import
+
+      Parameters
+      ----------
+      path    : str
+                folder which data will be stored
+      **kwargs: dict
+                prm file specific properties. Valid keyword arguments are: 
+
+                probeDist: float: distance between probe aperture to rotation center [m] (antenna aperture instead of rotation for PNF)
+                mre      : float: maximum radial extent of positioned antenna [m] (only for SNF and CNF)
+                autWidth : float: AUT width [m]
+                autHeight: float: AUT height [m]
+
+      Abbreviations
+      -------------
+      PNF: planar nearfield
+      CNF: cylindrical nearfield
+      SNF: spherical nearfield
+      AUT: antenna under test
+    """
+    if not os.path.exists(path):
+      raise FileNotFoundError("Output folder does not exists.")
+    
+    if not self.type in MeasurementType.PLANAR:
+      raise ValueError('Export to NSI for this type of measurement is nor supported.')
+    
+    probeDist = 1.0 if "probeDist" not in kwargs.keys() else kwargs["probeDist"]
+    mre       = 1.0 if "mre" not in kwargs.keys() else kwargs["mre"]
+    autWidth  = 1.0 if "autWidth" not in kwargs.keys() else kwargs["autWidth"]
+    autHeight = 1.0 if "autHeight" not in kwargs.keys() else kwargs["autHeight"]
+
+    if type(probeDist) != float:
+      raise TypeError("%s must be float"%probeDist)
+    if type(mre) != float:
+      raise TypeError("%s must be float"%mre)
+    if type(autWidth) != float:
+      raise TypeError("%s must be float"%autWidth)
+    if type(autHeight) != float:
+      raise TypeError("%s must be float"%autHeight)
+    
+    with open(os.path.join(path, "NFScan.prm"), '+w', encoding='utf-8') as file:
+      file.write("PNF\n")
+      file.write("%.3f, %.3f, %.3f, %.3f\n"%(probeDist, mre, autWidth, autHeight))
+      if self.type == MeasurementType.PLANAR_XSCAN:
+        file.write("%+.3f, %+.3f, %.3f\n"%(self.axesValues[2][0], self.axesValues[2][-1], (self.axesValues[2][1]-self.axesValues[2][0])))
+        file.write("%+.3f, %+.3f, %.3f\n"%(self.axesValues[1][0], self.axesValues[1][-1], (self.axesValues[1][1]-self.axesValues[1][0])))
+      else: # default MeasurementType.PLANAR_YSCAN
+        file.write("%+.3f, %+.3f, %.3f\n"%(self.axesValues[1][0], self.axesValues[1][-1], (self.axesValues[1][1]-self.axesValues[1][0])))
+        file.write("%+.3f, %+.3f, %.3f\n"%(self.axesValues[2][0], self.axesValues[2][-1], (self.axesValues[2][1]-self.axesValues[2][0])))
+      for i in range(len(self.axesValues[3])-1):
+        file.write("%.6f, "%(self.axesValues[3][i]/1E9))
+      file.write("%.6f\n"%(self.axesValues[3][-1]/1E9))
+      for i in range(len(self.axesValues[3])-1):
+        file.write("NF_%.0f.txt\n"%(self.axesValues[3][i]/1E3))
+      file.write("NF_%.0f.txt"%(self.axesValues[3][-1]/1E3))
+      
+    for i in range(len(self.axesValues[3])):
+      with open(os.path.join(path, "NF_%.0f.txt"%(self.axesValues[3][i]/1E3)), '+w', encoding='utf-8') as file:
+        file.write("# pol\t\tstep\t\tscan\t\treal\t\timag\n"%(self.axesValues[3][i]/1E3))
+        for k in range(len(self.axesValues[0])):
+          if self.type == MeasurementType.PLANAR_XSCAN:
+            for m in range(len(self.axesValues[2])):
+              for l in range(len(self.axesValues[1])):
+                file.write("%.3f\t\t%+.3f\t\t%+.3f\t\t%+.16f\t\t%+.16f\n"%(self.axesValues[0][k], self.axesValues[2][m], self.axesValues[1][l], self.data[k][l][m][i][0], self.data[k][l][m][i][1]))
+          else: # default MeasurementType.PLANAR_YSCAN
+            for l in range(len(self.axesValues[1])):
+              for m in range(len(self.axesValues[2])):
+                file.write("%.3f\t\t%+.3f\t\t%+.3f\t\t%+.16f\t\t%+.16f\n"%(self.axesValues[0][k], self.axesValues[1][l], self.axesValues[2][m], self.data[k][l][m][i][0], self.data[k][l][m][i][1]))
+

ams_adf_reader-0.2.2/src/ams-adf-reader/__init__.py

@@ -0,0 +1 @@
+from .Measurement import Measurement, MeasurementType

ams_adf_reader-0.2.2/src/ams_adf_reader.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.1
+Name: ams-adf-reader
+Version: 0.2.2
+Summary: Antenna Measurement Software (AMS) File Format (ADF) Reader 
+Home-page: https://github.com/yigithsyn/ams-adf-reader
+Author: Hüseyin YİĞİT
+Author-email: yigit.hsyn@gmail.com
+License: MIT License
+Platform: Any
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Other Audience
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >= 3.4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: h5py
+
+# ams-adf-reader
+
+Antenna Measurement Software (AMS) File Format (ADF) Reader

ams_adf_reader-0.2.2/src/ams_adf_reader.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+VERSION
+pyproject.toml
+setup.py
+src/ams-adf-reader/Measurement.py
+src/ams-adf-reader/__init__.py
+src/ams_adf_reader.egg-info/PKG-INFO
+src/ams_adf_reader.egg-info/SOURCES.txt
+src/ams_adf_reader.egg-info/dependency_links.txt
+src/ams_adf_reader.egg-info/requires.txt
+src/ams_adf_reader.egg-info/top_level.txt

ams_adf_reader-0.2.2/src/ams_adf_reader.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ams_adf_reader-0.2.2/src/ams_adf_reader.egg-info/requires.txt

@@ -0,0 +1 @@
+h5py

ams_adf_reader-0.2.2/src/ams_adf_reader.egg-info/top_level.txt

@@ -0,0 +1 @@
+ams-adf-reader