PyIBIS-AMI 6.1.0__tar.gz → 6.2.0__tar.gz

{pyibis_ami-6.1.0/src/PyIBIS_AMI.egg-info → pyibis_ami-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyIBIS-AMI
-Version: 6.1.0
+Version: 6.2.0
 Summary: Facilitates working directly with IBIS-AMI DLLs from the Python command prompt.
 Author: David Patterson
 Author-email: David Banas <capn.freako@gmail.com>
@@ -43,8 +43,7 @@ PyIBIS-AMI is a Python package of tools useful in the development and testing of
 This library is used in [PyBERT](https://github.com/capn-freako/PyBERT) and also provides two
 command line applications.
 
-It can be installed via `conda`.  PyPi support is experimental but can be installed with
- `pip install PyIBIS-AMI`.
+It can be installed via: `pip install PyIBIS-AMI`.
 
 [View API/Developer's Documentation.](https://pyibis-ami.readthedocs.io/en/latest/)
 

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/README.md

@@ -6,8 +6,7 @@ PyIBIS-AMI is a Python package of tools useful in the development and testing of
 This library is used in [PyBERT](https://github.com/capn-freako/PyBERT) and also provides two
 command line applications.
 
-It can be installed via `conda`.  PyPi support is experimental but can be installed with
- `pip install PyIBIS-AMI`.
+It can be installed via: `pip install PyIBIS-AMI`.
 
 [View API/Developer's Documentation.](https://pyibis-ami.readthedocs.io/en/latest/)
 

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "PyIBIS-AMI"
 description = "Facilitates working directly with IBIS-AMI DLLs from the Python command prompt."
-version = "6.1.0"
+version = "6.2.0"
 authors = [ {name = "David Banas",     email = "capn.freako@gmail.com"}
           , {name = "David Patterson"}
           ]

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0/src/PyIBIS_AMI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyIBIS-AMI
-Version: 6.1.0
+Version: 6.2.0
 Summary: Facilitates working directly with IBIS-AMI DLLs from the Python command prompt.
 Author: David Patterson
 Author-email: David Banas <capn.freako@gmail.com>
@@ -43,8 +43,7 @@ PyIBIS-AMI is a Python package of tools useful in the development and testing of
 This library is used in [PyBERT](https://github.com/capn-freako/PyBERT) and also provides two
 command line applications.
 
-It can be installed via `conda`.  PyPi support is experimental but can be installed with
- `pip install PyIBIS-AMI`.
+It can be installed via: `pip install PyIBIS-AMI`.
 
 [View API/Developer's Documentation.](https://pyibis-ami.readthedocs.io/en/latest/)
 

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/ami/config.py

@@ -237,9 +237,9 @@ def mk_tests(test_defs, file_base_name, test_dir="test_runs"):  # pylint: disabl
 #      and import what you need from this module. This is much cleaner.
 @click.command(context_settings={"help_option_names": ["-h", "--help"]})
 @click.argument("py_file", type=click.Path(exists=True, resolve_path=True))
-@click.option(
-    "-d", "--test_dir", show_default=True, default="test_runs", help="Output directory for test run generation."
-)
+# @click.option(
+#     "-d", "--test_dir", show_default=True, default="test_runs", help="Output directory for test run generation."
+# )
 @click.version_option()
 def main(py_file):
     """Configure IBIS-AMI model C++ source code, IBIS model, and AMI file.

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/ami/model.py

@@ -10,10 +10,10 @@ Copyright (c) 2019 David Banas; All rights reserved World wide.
 import copy as cp
 from ctypes import CDLL, byref, c_char_p, c_double  # pylint: disable=no-name-in-module
 from pathlib import Path
-from typing import Iterator, Any, Optional
+from typing import Any, Optional
 
 import numpy as np
-from numpy.random import randint
+# from numpy.random import randint
 
 from pyibisami.common import *  # pylint: disable=wildcard-import,unused-wildcard-import  # noqa: F403
 
@@ -214,7 +214,7 @@ class AMIModelInitializer:
 
 class AMIModel:  # pylint: disable=too-many-instance-attributes
     """
-    Class defining the structure and behavior of an AMI Model.
+    Class defining the structure and behavior of an IBIS-AMI Model.
 
     Notes:
         1. Makes the calling of ``AMI_Close()`` automagic,
@@ -272,14 +272,26 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             self._amiClose(self._ami_mem_handle)
 
         # Set up the AMI_Init() arguments.
-        self._channel_response = init_object._init_data["channel_response"]  # pylint: disable=protected-access,attribute-defined-outside-init
+        self._channel_response = init_object._init_data[  # pylint: disable=protected-access,attribute-defined-outside-init
+            "channel_response"
+        ]
         self._initOut = cp.copy(self._channel_response)  # type: ignore  # pylint: disable=attribute-defined-outside-init
-        self._row_size = init_object._init_data["row_size"]  # pylint: disable=protected-access,attribute-defined-outside-init
-        self._num_aggressors = init_object._init_data["num_aggressors"]  # pylint: disable=protected-access,attribute-defined-outside-init
-        self._sample_interval = init_object._init_data["sample_interval"]  # pylint: disable=protected-access,attribute-defined-outside-init
-        self._bit_time = init_object._init_data["bit_time"]  # pylint: disable=protected-access,attribute-defined-outside-init
+        self._row_size = init_object._init_data[  # pylint: disable=protected-access,attribute-defined-outside-init
+            "row_size"
+        ]
+        self._num_aggressors = init_object._init_data[  # pylint: disable=protected-access,attribute-defined-outside-init
+            "num_aggressors"
+        ]
+        self._sample_interval = init_object._init_data[  # pylint: disable=protected-access,attribute-defined-outside-init
+            "sample_interval"
+        ]
+        self._bit_time = init_object._init_data[  # pylint: disable=protected-access,attribute-defined-outside-init
+            "bit_time"
+        ]
         self._info_params = init_object.info_params  # pylint: disable=attribute-defined-outside-init
-        assert self._info_params, RuntimeError(f"`info_params` is None!\n`init_object: {init_object}")  # pylint: disable=attribute-defined-outside-init
+        assert self._info_params, RuntimeError(
+            f"`info_params` is None!\n`init_object: {init_object}"
+        )  # pylint: disable=attribute-defined-outside-init
 
         # Check GetWave() consistency if possible.
         if init_object.info_params and init_object.info_params["GetWave_Exists"]:
@@ -342,15 +354,18 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
         # Initialize attributes used by getWave().
         bit_time = init_object.bit_time
         sample_interval = init_object.sample_interval
-        # ToDo: Fix this.
+        # ToDo: Fix this. There isn't actually a requirement that `bit_time` be an integral multiple of `sample_interval`.
+        # And there may be an advantage to having it not be!
         if (bit_time % sample_interval) > (sample_interval / 100):
             raise ValueError(
-                f"Bit time ({bit_time * 1e9 : 6.3G} ns) must be an integral multiple of sample interval ({sample_interval * 1e9 : 6.3G} ns)."
+                f"Bit time ({bit_time * 1e9: 6.3G} ns) must be an integral multiple of sample interval ({sample_interval * 1e9: 6.3G} ns)."
             )
         self._samps_per_bit = int(bit_time / sample_interval)  # pylint: disable=attribute-defined-outside-init
-        self._bits_per_call = init_object.row_size / self._samps_per_bit  # pylint: disable=attribute-defined-outside-init
+        self._bits_per_call = (  # pylint: disable=attribute-defined-outside-init
+            init_object.row_size / self._samps_per_bit
+        )
 
-    def getWave(self, wave: Rvec, bits_per_call: int = 0) -> tuple[Rvec, Rvec]:  # noqa: F405
+    def getWave(self, wave: Rvec, bits_per_call: int = 0) -> tuple[Rvec, Rvec, list[str]]:  # noqa: F405
         """
         Performs time domain processing of input waveform, using the
         ``AMI_GetWave()`` function.
@@ -363,9 +378,10 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
                 Default: 0 (Means "Use existing value.")
 
         Returns:
-            (wave_out, clock_times): A pair containing:
-                - the processed waveform, and
-                - the recovered slicer sampling instants.
+            (wave_out, clock_times, params_out): A tuple containing:
+                - the processed waveform,
+                - the recovered slicer sampling instants, and
+                - the list of output parameter strings received from each call to ``AMI_GetWave()``.
 
         Notes:
             1. The returned clock times are given in "pre-edge-aligned" fashion,
@@ -379,12 +395,13 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
 
         # Create the required C types.
         Signal = c_double * samps_per_call
-        Clocks = c_double * bits_per_call
+        Clocks = c_double * (bits_per_call + 1)  # The "+1" is critical, to prevent access violations by the model.
 
         idx = 0  # Holds the starting index of the next processing chunk.
         _clock_times = Clocks(0.0)
         wave_out: list[float] = []
         clock_times: list[float] = []
+        params_out: list[str] = []
         input_len = len(wave)
         while idx < input_len:
             remaining_samps = input_len - idx
@@ -394,18 +411,24 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             else:
                 tmp_wave = wave[idx: idx + samps_per_call]
             _wave = Signal(*tmp_wave)
-            self._amiGetWave(byref(_wave), len(_wave), byref(_clock_times),
-                             byref(self._ami_params_out), self._ami_mem_handle)  # type: ignore
+            self._amiGetWave(
+                byref(_wave), len(_wave), byref(_clock_times), byref(self._ami_params_out), self._ami_mem_handle
+            )  # type: ignore
             wave_out.extend(_wave)
             clock_times.extend(_clock_times)
+            params_out.append(self.ami_params_out)
             idx += len(_wave)
 
-        return np.array(wave_out), np.array(clock_times[: len(wave_out) // self._samps_per_bit])
+        return np.array(wave_out), np.array(clock_times[: len(wave_out) // self._samps_per_bit]), params_out
 
-    def get_responses(self, bits_per_call: int = 0, bit_gen: Optional[Iterator[int]] = None  # pylint: disable=too-many-locals
-                      ) -> dict[str, Any]:
+    def get_responses(  # pylint: disable=too-many-locals
+        self,
+        bits_per_call: int = 0,
+        # bit_gen: Optional[Iterator[int]] = None,
+        pad_bits: int = 10,
+    ) -> dict[str, Any]:
         """
-        Get the impulse, step, pulse, and frequency responses of an initialized IBIS-AMI model.
+        Get the impulse response of an initialized IBIS-AMI model, alone and convolved with the channel.
 
         Keyword Args:
             bits_per_call: Number of bits to include in the input to `GetWave()`.
@@ -413,17 +436,16 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             bit_gen: The bit generator to use for `GetWave()` input data generation.
                 Should produce integers from the set: {0,1}.
                 Default: None (Means "use randint(2)".)
+            pad_bits: Number of bits to pad leading edge with when calling `GetWave()`,
+                to protect from initial garbage in `GetWave()` output.
+                Default: 10
 
         Returns:
-            Dictionary containing the responses under the following keys:
+            rslt: Dictionary containing the responses under the following keys:
                 "imp_resp_init": The model's impulse response, from its `AMI_Init()` function (V/sample).
-                "step_resp_init": The model's step response, from its `AMI_Init()` function.
-                "pulse_resp_init": The model's pulse response, from its `AMI_Init()` function.
-                "freq_resp_init": The model's frequency response, from its `AMI_Init()` function.
+                "out_resp_init": `imp_resp_init` convolved with the channel.
                 "imp_resp_getw": The model's impulse response, from its `AMI_GetWave()` function (V/sample).
-                "step_resp_getw": The model's step response, from its `AMI_GetWave()` function.
-                "pulse_resp_getw": The model's pulse response, from its `AMI_GetWave()` function.
-                "freq_resp_getw": The model's frequency response, from its `AMI_GetWave()` function.
+                "out_resp_getw": `imp_resp_getw` convolved with the channel.
 
         Notes:
             1. If either set of keys (i.e. - "..._init" or "..._getw")
@@ -432,12 +454,11 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
                 was not available in the given model.
             2. An empty dictionary implies that neither the `Init_Returns_Impulse`
                 nor the `GetWave_Exists` AMI reserved parameter was True.
-            3. One additional key is added to the returned dictionary, when appropriate:
-                - "params_out_getw": If the model's ``AMI_GetWave()`` function is called and it returns parameters.
-            4. Note that impulse responses are returned with units: (V/sample), not (V/s).
-            5. The frequency vector corresponding to the returned frequency responses is given by:
-                [n * f0 for n in range(impulse_length // 2 + 1)], where:
-                f0 = 1 / (ts * impulse_length)
+            3. Note that impulse responses are returned with units: (V/sample), not (V/s).
+
+        ToDo:
+            1. Implement `bit_gen`.
+            2. Implement `ignore_bits`.
         """
 
         rslt = {}
@@ -446,51 +467,51 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
         impulse_length = self.row_size
         ui = self.bit_time
         ts = self.sample_interval
-        nspui = int(ui / ts)
-        ignore_bits = self.info_params["Ignore_Bits"]
+        # info_params = self.info_params
+        # ignore_bits = info_params["Ignore_Bits"] if "Ignore_Bits" in info_params else 0
 
         # Capture/convert instance variables.
         chnl_imp = np.array(self.channel_response) * ts  # input (a.k.a. - "channel") impulse response (V/sample)
         out_imp = np.array(self.initOut) * ts  # output impulse response (V/sample)
 
+        # Calculate some needed intermediate values.
+        nspui = int(ui / ts)  # samps per UI
+        pad_samps = pad_bits * nspui  # leading edge padding samples for GetWave() calls
+
         # Extract and return the model responses.
         if self.info_params["Init_Returns_Impulse"]:
             h_model = deconv_same(out_imp, chnl_imp)  # noqa: F405
             # h_model = irfft(rfft(out_imp) / rfft(chnl_imp))  # Seems to produce results just as noisy as above.
             h_model = np.where(abs(h_model) > 1, np.zeros(len(h_model)), h_model)
             rslt["imp_resp_init"] = np.roll(h_model, -len(h_model) // 2 + 3 * nspui)
-            rslt["step_resp_init"] = np.cumsum(rslt["imp_resp_init"])
-            rslt["pulse_resp_init"] = rslt["step_resp_init"] - np.pad(
-                rslt["step_resp_init"][:-nspui], (nspui, 0), mode="constant", constant_values=0
-            )
-            rslt["freq_resp_init"] = np.fft.rfft(rslt["imp_resp_init"])
             rslt["out_resp_init"] = out_imp
         if self.info_params["GetWave_Exists"]:
             # Run `ignore_bits` bits of data through the model first.
-            if bit_gen:
-                wave_in = [next(bit_gen) for _ in range(ignore_bits)]
-            else:
-                wave_in = [randint(2) for _ in range(ignore_bits)]
-            _, _ = self.getWave(np.array(wave_in) - 0.5, bits_per_call=bits_per_call)
+            # if bit_gen:
+            #     wave_in = [next(bit_gen) for _ in range(ignore_bits)]
+            # else:
+            #     wave_in = [randint(2) for _ in range(ignore_bits)]
+            # _, _, _ = self.getWave(np.array(wave_in) - 0.5, bits_per_call=bits_per_call)
+
             # Then, run a perfect step, to extract model's step response.
-            wave_out, _ = self.getWave(
-                np.array([0] * impulse_length + [1] * impulse_length) - 0.5, bits_per_call=bits_per_call
+            wave_out, _, _ = self.getWave(
+                np.array([0] * pad_samps + [1] * impulse_length) - 0.5,
+                bits_per_call=bits_per_call,
             )
-            # Remove any artifactual vertical offset from beginning of result:
-            rslt["step_resp_getw"] = wave_out[impulse_length:] - wave_out[impulse_length - 1]
+
             # Calculate other responses from step response.
-            rslt["imp_resp_getw"] = np.pad(np.diff(rslt["step_resp_getw"]), (1, 0), mode="constant", constant_values=0)
-            rslt["pulse_resp_getw"] = rslt["step_resp_getw"] - np.pad(
-                rslt["step_resp_getw"][:-nspui], (nspui, 0), mode="constant", constant_values=0
-            )
-            rslt["freq_resp_getw"] = np.fft.rfft(rslt["imp_resp_getw"])
+            rslt["imp_resp_getw"] = np.diff(wave_out[pad_samps:])
+
             # Calculate effective cumulative impulse response (i.e. - channel + Tx).
             # - Form the step response equivalent to the given channel impulse response.
             chnl_step = np.cumsum(chnl_imp)
             # - And run it through `GetWave()`, after d.c. balancing.
-            out_step, _ = self.getWave(chnl_step - chnl_step.ptp() / 2, bits_per_call=bits_per_call)
+            chnl_step_bal = chnl_step - chnl_step[-1] / 2
+            out_step, _, _ = self.getWave(
+                np.pad(chnl_step_bal, (pad_samps, 0), mode="edge"), bits_per_call=bits_per_call
+            )
             # - Convert result back to an impulse response.
-            rslt["out_resp_getw"] = np.pad(np.diff(out_step), (1, 0), mode="constant", constant_values=0)
+            rslt["out_resp_getw"] = np.diff(out_step[pad_samps:])
         return rslt
 
     def _getInitOut(self):
@@ -533,7 +554,9 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
     def _getAmiParamsOut(self):
         return self._ami_params_out.value
 
-    ami_params_out = property(_getAmiParamsOut, doc="The AMI parameter string returned by AMI_Init().")
+    ami_params_out = property(
+        _getAmiParamsOut, doc="The AMI parameter string returned by either `AMI_Init()` or `AMI_GetWave()`."
+    )
 
     def _getMsg(self):
         return self._msg.value

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/ami/parser.py

@@ -9,7 +9,7 @@ Copyright (c) 2019 David Banas; all rights reserved World wide.
 
 import re
 
-from parsec import ParseError, generate, many, many1, regex, string
+from parsec import ParseError, generate, many, regex, string
 from traits.api import Bool, Enum, HasTraits, Range, Trait
 from traitsui.api import Group, Item, View
 from traitsui.menu import ModalButtons
@@ -210,7 +210,9 @@ class AMIParamConfigurator(HasTraits):
                 # See the docs on the *HasTraits* class, if this is confusing.
                 try:  # Querry for a mapped trait, first, by trying to get '<trait_name>_'. (Note the underscore.)
                     res[pname] = self.get(pname + "_")[pname + "_"]
-                except Exception:  # If we get an exception, we have an ordinary (i.e. - not mapped) trait.  # pylint: disable=broad-exception-caught
+                except (
+                    Exception  # pylint: disable=broad-exception-caught
+                ):  # If we get an exception, we have an ordinary (i.e. - not mapped) trait.
                     res[pname] = self.get(pname)[pname]
         elif isinstance(param, dict):  # We received a dictionary of subparameters, in 'param'.
             subs = {}
@@ -270,7 +272,7 @@ def node():
     "Parse AMI node."
     yield lparen
     label = yield node_name
-    values = yield many1(expr)
+    values = yield many(expr)
     yield rparen
     return (label, values)
 
@@ -300,12 +302,9 @@ def proc_branch(branch):
 
     Returns:
         (str, dict): A pair containing:
-
-            err_str:
-                String containing any errors or warnings encountered,
+            err_str: String containing any errors or warnings encountered,
                 while building the parameter dictionary.
-            param_dict:
-                Resultant parameter dictionary.
+            param_dict: Resultant parameter dictionary.
     """
     results = ("", {})  # Empty Results
     if len(branch) != 2:
@@ -324,9 +323,13 @@ def proc_branch(branch):
 
     try:
         if (
-            (len(param_tags) > 1)  # noqa: W503
-            and (param_tags[0][0] in AMIParameter._param_def_tag_procs)  # pylint: disable=protected-access  # noqa: W503
-            and (param_tags[1][0] in AMIParameter._param_def_tag_procs)  # pylint: disable=protected-access  # noqa: W503
+            (len(param_tags) > 1)
+            and (  # noqa: W503
+                param_tags[0][0] in AMIParameter._param_def_tag_procs  # pylint: disable=protected-access  # noqa: W503
+            )
+            and (  # noqa: W503
+                param_tags[1][0] in AMIParameter._param_def_tag_procs  # pylint: disable=protected-access  # noqa: W503
+            )
         ):
             try:
                 results = ("", {param_name: AMIParameter(param_name, param_tags)})
@@ -368,12 +371,10 @@ def parse_ami_param_defs(param_str):  # pylint: disable=too-many-branches
 
     Returns:
         (str, dict): A pair containing:
-
             err_str:
                 - None, if parser succeeds.
                 - Helpful message, if it fails.
-            param_dict:
-                Dictionary containing parameter definitions.
+            param_dict: Dictionary containing parameter definitions.
                 (Empty, on failure.)
                 It has a single key, at the top level, which is the
                 model root name. This key indexes the actual
@@ -450,7 +451,9 @@ def parse_ami_param_defs(param_str):  # pylint: disable=too-many-branches
     return (err_str, param_dict)
 
 
-def make_gui_items(pname, param, first_call=False):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements
+def make_gui_items(
+    pname, param, first_call=False
+):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements
     """Builds list of GUI items from AMI parameter dictionary."""
 
     gui_items = []

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/common.py

@@ -8,7 +8,7 @@ Original date:   May 15, 2024
 Copyright (c) 2024 David Banas; all rights reserved World wide.
 """
 
-from typing import TypeAlias, TypeVar
+from typing_extensions import TypeAlias, TypeVar
 
 import numpy.typing as npt  # type: ignore
 from scipy.linalg import convolution_matrix, lstsq
@@ -17,6 +17,8 @@ Real = TypeVar("Real", float, float)
 Comp = TypeVar("Comp", complex, complex)
 Rvec: TypeAlias = npt.NDArray[Real]
 Cvec: TypeAlias = npt.NDArray[Comp]
+# Rvec = npt.NDArray[Real]
+# Cvec = npt.NDArray[Comp]
 
 # PI: float = np.pi  # Causes a failed import of `pyibisami.ami.model` during `tox -e docs`, due to:
 #   File "C:\Users\davibana\prj\PyBERT\PyAMI\src\pyibisami\common.py", line 23, in <module>

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/ibis/model.py

@@ -258,10 +258,6 @@ class Model(HasTraits):  # pylint: disable=too-many-instance-attributes
             ((os, _), _) = x
             return os.lower() == "windows"
 
-        # def showExec(x):
-        #     ((os, b), fs) = x
-        #     return os + str(b) + ": " + str(fs)
-
         def partition(p, xs):
             ts, fs = [], []
             for x in xs:

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/ibis/parser.py

@@ -59,7 +59,7 @@ def logf(p, preStr=""):
         res = p(txt, ix)
         if not res.status:
             print(
-                f"{preStr}: Expected {res.expected} in '{txt[res.index : res.index+5]}' at {ParseError.loc_info(txt, res.index)}."
+                f"{preStr}: Expected {res.expected} in '{txt[res.index: res.index + 5]}' at {ParseError.loc_info(txt, res.index)}."
             )
         return res
 

{pyibis_ami-6.1.0 → pyibis_ami-6.2.0}/src/pyibisami/tools/run_tests.py

@@ -199,8 +199,7 @@ def run_tests(**kwargs):  # pylint: disable=too-many-locals
     print(f"Please, open file, `{xml_filename}` in a Web browser, in order to view the test results.")
 
 
-@click.command(context_settings={"ignore_unknown_options": True,
-                                 "help_option_names": ["-h", "--help"]})
+@click.command(context_settings={"ignore_unknown_options": True, "help_option_names": ["-h", "--help"]})
 @click.option(
     "--model", "-m", default="libami.so", type=click.Path(exists=True), help="Sets the AMI model DLL file name."
 )