PyIBIS-AMI 6.2.1__tar.gz → 7.1.0__tar.gz

{pyibis_ami-6.2.1/src/PyIBIS_AMI.egg-info → pyibis_ami-7.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
-Name: PyIBIS-AMI
-Version: 6.2.1
+Name: pyibis-ami
+Version: 7.1.0
 Summary: Facilitates working directly with IBIS-AMI DLLs from the Python command prompt.
 Author-email: David Banas <capn.freako@gmail.com>
 License: BSD
@@ -16,13 +16,13 @@ Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: System :: Emulators
 Classifier: Topic :: Utilities
-Requires-Python: <3.13,>=3.9
+Requires-Python: <3.13,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: chaco>=6.0.0

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/docs/source/ami.rst

@@ -21,4 +21,7 @@ parameter
 parser
 ------
 
-.. automodule:: pyibisami.ami.parser
+Sorry, the code in this module breaks the *Sphinx* ``autodoc`` processor.
+So, we have to exclude it from these docs.
+You'll have to peruse the comments in the code, manually.
+See the ``pyibisami/ami/parser.py`` file.

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/docs/source/conf.py

@@ -51,6 +51,10 @@ autodoc_mock_imports = [
     "enable",
     "matplotlib",
     "numpy",
+    "parsec",
+    "pyibisami.ami.parser",
+    "pyibisami.ibis.parser",
+    "scipy",
     "traits",
     "traitsui",
 ]
@@ -80,9 +84,9 @@ author = "David Banas"
 # built documents.
 #
 # The short X.Y version.
-version = "6.2"
+version = "7.1"
 # The full version, including alpha/beta/rc tags.
-release = "6.2.1"
+release = "7.1.0"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

pyibis_ami-7.1.0/docs/source/ibis.rst

@@ -0,0 +1,22 @@
+pyibisami.ibis
+==============
+
+IBIS related submodules in the *PyIBIS-AMI* package.
+
+file
+----
+
+.. automodule:: pyibisami.ibis.file
+
+model
+-----
+
+.. automodule:: pyibisami.ibis.model
+
+parser
+------
+
+Sorry, the code in this module breaks the *Sphinx* ``autodoc`` processor.
+So, we have to exclude it from these docs.
+You'll have to peruse the comments in the code, manually.
+See the ``pyibisami/ibis/parser.py`` file.

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/pyproject.toml

@@ -3,13 +3,13 @@ requires = ["setuptools>=61.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "PyIBIS-AMI"
+name = "pyibis-ami"
 description = "Facilitates working directly with IBIS-AMI DLLs from the Python command prompt."
-version = "6.2.1"
+version = "7.1.0"
 authors = [ {name = "David Banas",     email = "capn.freako@gmail.com"}
           ]
 readme = "README.md"
-requires-python = ">=3.9,<3.13"
+requires-python = ">=3.10,<3.13"
 license = {text = "BSD"}
 dependencies = [
     "chaco>=6.0.0",
@@ -31,9 +31,9 @@ classifiers=[
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: Implementation :: CPython",
     "Topic :: System :: Emulators",
     "Topic :: Utilities",
@@ -54,7 +54,7 @@ run-notebook = "pyibisami.tools.run_notebook:main"
 where = ["src"]
 
 [tool.setuptools.package-data]
-"pyibisami" = ['*.ipynb']  # <--- "" (empty string) means "all packages".
+"pyibisami" = ['*.ipynb']
 
 [tool.black]
 line-length = 119

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0/src/PyIBIS_AMI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
-Name: PyIBIS-AMI
-Version: 6.2.1
+Name: pyibis-ami
+Version: 7.1.0
 Summary: Facilitates working directly with IBIS-AMI DLLs from the Python command prompt.
 Author-email: David Banas <capn.freako@gmail.com>
 License: BSD
@@ -16,13 +16,13 @@ Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: System :: Emulators
 Classifier: Topic :: Utilities
-Requires-Python: <3.13,>=3.9
+Requires-Python: <3.13,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: chaco>=6.0.0

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/src/PyIBIS_AMI.egg-info/SOURCES.txt

@@ -26,6 +26,12 @@ src/PyIBIS_AMI.egg-info/dependency_links.txt
 src/PyIBIS_AMI.egg-info/entry_points.txt
 src/PyIBIS_AMI.egg-info/requires.txt
 src/PyIBIS_AMI.egg-info/top_level.txt
+src/pyibis_ami.egg-info/PKG-INFO
+src/pyibis_ami.egg-info/SOURCES.txt
+src/pyibis_ami.egg-info/dependency_links.txt
+src/pyibis_ami.egg-info/entry_points.txt
+src/pyibis_ami.egg-info/requires.txt
+src/pyibis_ami.egg-info/top_level.txt
 src/pyibisami/IBIS_AMI_Checker.ipynb
 src/pyibisami/IBIS_AMI_Tester.ipynb
 src/pyibisami/__init__.py

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/src/pyibisami/IBIS_AMI_Tester.ipynb

@@ -488,7 +488,12 @@
     "\n",
     "        print(f\"Running sweep `{cfg_name}`: {description}...\")\n",
     "        fig = plt.figure(figsize=(fig_x, fig_y))\n",
-    "        for color, (label, (ami_params, sim_params), _) in zip(colors, cfg_list):\n",
+    "        # for color, (label, (ami_params, sim_params), _) in zip(colors, cfg_list):\n",
+    "        # Accommodating both new and old style IBIS-AMI model configuration:\n",
+    "        for color, fields in zip(colors, cfg_list):\n",
+    "            label = fields[0]\n",
+    "            ami_params = fields[1][0]\n",
+    "            sim_params = fields[1][1]\n",
     "            func(fig, color, label, ami_params, sim_params)\n",
     "\n",
     "        plt.subplot(131)\n",
@@ -1444,7 +1449,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.11"
+   "version": "3.10.16"
   }
  },
  "nbformat": 4,

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/src/pyibisami/ami/config.py

@@ -8,6 +8,10 @@ Original date:   February 26, 2016
 
 Copyright (c) 2016 David Banas; all rights reserved World wide.
 
+**Note:** The following use model has been deprecated!
+The preferred approach is to make *executable* model configurators,
+which draw what they need from this module.
+
 This script gets called from a makefile, when any of the following need rebuilding:
 
 * a C++ source code file
@@ -28,13 +32,19 @@ The idea here is that the ``*.IBS`` file, the ``*.AMI`` file, the C++ source fil
 and the test run configuration files should be configured from a common model
 configuration file, so as to ensure consistency between them all.
 """
+
 import importlib.util
 from datetime import date
 from pathlib import Path
+from typing import Any, NewType
 
 import click
 import em
 
+ParamDict      = NewType("ParamDict",      dict[str, Any])
+NamedParamDict = NewType("NamedParamDict", tuple[str, ParamDict])
+TestDefinition = NewType("TestDefinition", tuple[str, NamedParamDict, NamedParamDict, str])
+
 param_types = {
     "INT": {"c_type": "int", "ami_type": "Integer", "getter": "get_param_int"},
     "FLOAT": {"c_type": "double", "ami_type": "Float", "getter": "get_param_float"},
@@ -117,10 +127,26 @@ def print_code(pname, param):
     print("       ", "node_names.pop_back();")
 
 
-def mk_model(ibis_params, ami_params, model_name, description, out_dir="."):
+def mk_model(
+    ibis_params: ParamDict,
+    ami_params: ParamDict,
+    model_name: str,
+    description: str,
+    out_dir: str = "."
+) -> None:
     """
     Generate ibis, ami, and cpp files, by merging the
     device specific parameterization with the templates.
+
+    Args:
+        ibis_params: Dictionary of IBIS model parameter definitions.
+        ami_params: Dictionary of AMI parameter definitions.
+        model_name: Name given to IBIS model.
+        description: Model description.
+
+    Keyword Args:
+        out_dir: Directory in which to place created files.
+            Default: "."
     """
 
     py_file = (Path(out_dir).resolve() / model_name).with_suffix(".py")
@@ -135,9 +161,9 @@ def mk_model(ibis_params, ami_params, model_name, description, out_dir="."):
             em_file = out_file.with_suffix(".cpp.em")
 
         print(f"Building '{out_file}' from '{em_file}'...")
-        with open(out_file, "w", encoding="utf-8") as out_file:
+        with open(out_file, "w", encoding="utf-8") as o_file:
             interpreter = em.Interpreter(
-                output=out_file,
+                output=o_file,
                 globals={
                     "ami_params": ami_params,
                     "ibis_params": ibis_params,
@@ -156,8 +182,14 @@ def mk_model(ibis_params, ami_params, model_name, description, out_dir="."):
 
 def ami_config(py_file):
     """
-    Read in the ``py_file`` and cpp.em files,
-    then generate: ibis, ami, and cpp files.
+    Read in ``py_file`` and cpp.em files, then generate: ibis, ami, and cpp files.
+
+    Args:
+        py_file: name of model configuration file (<stem>.py)
+
+    Notes:
+        1. This function is deprecated! Instead, make your model configurator executable
+        and import what you need from this module. This is much cleaner.
     """
 
     file_base_name = Path(py_file).stem
@@ -171,15 +203,16 @@ def ami_config(py_file):
     mk_model(cfg.ibis_params, cfg.ami_params, cfg.kFileBaseName, cfg.kDescription, out_dir=Path(py_file).parent)
 
 
-def mk_combs(dict_items):
-    """Make all combinations possible from a list of dictionary items.
+def mk_combs(dict_items: list[tuple[str, Any]]) -> list[list[tuple[str, Any]]]:
+    """
+    Make all combinations possible from a list of dictionary items.
 
     Args:
-        dict_items([(str, [T])]): List of dictionary key/value pairs.
+        dict_items: List of dictionary key/value pairs.
             The values are lists.
 
     Return:
-        [[(str, T)]]: List of all possible combinations of key values.
+        List of all possible combinations of key values.
     """
     if not dict_items:
         return [
@@ -191,8 +224,22 @@ def mk_combs(dict_items):
     return [[kval] + rest for kval in kvals for rest in mk_combs(tail)]
 
 
-def mk_tests(test_defs, file_base_name, test_dir="test_runs"):  # pylint: disable=too-many-locals
-    """Make the test run configuration files."""
+def mk_tests(  # pylint: disable=too-many-locals
+    test_defs: dict[str, TestDefinition],
+    file_base_name: str,
+    test_dir: str = "test_runs"
+) -> None:
+    """
+    Make the test run configuration files.
+
+    Args:
+        test_defs: Dictionary of test sweep definitions.
+        file_base_name: Stem name for test run definition files.
+
+    Keyword Args:
+        test_dir: Directory in which to place the created test run definition files.
+            Default: "test_runs/"
+    """
 
     pname = Path(test_dir).resolve()
     pname.mkdir(exist_ok=True)
@@ -204,18 +251,11 @@ def mk_tests(test_defs, file_base_name, test_dir="test_runs"):  # pylint: disabl
         sim_str, sim_dict = sim_defs
         with open((pname / fname).with_suffix(".run"), "w", encoding="utf-8") as f:
             f.write(desc + "\n")
-            for ami_comb in mk_combs(ami_dict.items()):
-                for sim_comb in mk_combs(sim_dict.items()):
-                    try:
-                        pdict = dict(ami_comb)
-                        pdict.update(dict(sim_comb))
-                        f.write(f"\n('{ami_str.format(pdict=pdict)}_{sim_str.format(pdict=pdict)}', \\\n")
-                    except Exception as err:
-                        print(f"{err}")
-                        print(f"ami_str: {ami_str}")
-                        print(f"sim_str: {sim_str}")
-                        print(f"pdict: {pdict}")
-                        raise
+            for ami_comb in mk_combs(list(ami_dict.items())):
+                for sim_comb in mk_combs(list(sim_dict.items())):
+                    pdict = dict(ami_comb)
+                    pdict.update(dict(sim_comb))
+                    f.write(f"\n('{ami_str.format(pdict=pdict)}_{sim_str.format(pdict=pdict)}', \\\n")
                     f.write(f"  ({{'root_name': '{file_base_name}', \\\n")
                     for k, v in ami_comb:
                         f.write(f"    '{k}': {v}, \\\n")
@@ -233,22 +273,22 @@ def mk_tests(test_defs, file_base_name, test_dir="test_runs"):  # pylint: disabl
                     f.write(")\n")
 
 
-# NOTE: The following is deprecated! Instead, make your model configurator executable
-#      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.version_option()
 def main(py_file):
-    """Configure IBIS-AMI model C++ source code, IBIS model, and AMI file.
-
+    """
+    Configure IBIS-AMI model C++ source code, IBIS model, and AMI file.
     This command generates three files based off the input config file.
     It expects a .cpp.em file to be located in the same directory so that it can
     generate a cpp file from the config file and template file.
 
+    Args:
        py_file: name of model configuration file (*.py)
+
+    Notes:
+        1. This command is deprecated! Instead, make your model configurator executable
+        and import what you need from this module. This is much cleaner.
     """
     ami_config(py_file)
 

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/src/pyibisami/ami/model.py

@@ -16,11 +16,12 @@ from typing import Any, Optional
 import numpy as np
 from numpy.random     import default_rng
 
-from pyibisami.common import *  # pylint: disable=wildcard-import,unused-wildcard-import  # noqa: F403
+from pyibisami.common import Rvec, deconv_same
 
 
-def loadWave(filename):
-    """Load a waveform file.
+def loadWave(filename: str) -> tuple[Rvec, Rvec]:
+    """
+    Load a waveform file.
 
     The file should consist of any number of lines, where each line
     contains, first, a time value and, second, a voltage value.
@@ -30,11 +31,10 @@ def loadWave(filename):
     saved from *CosmosScope*.
 
     Args:
-        filename (str): Name of waveform file to read in.
+        filename: Name of waveform file to read in.
 
     Returns:
-        ([float], [float]): A pair of *NumPy* arrays containing the time
-            and voltage values, respectively.
+        A pair of *NumPy* arrays containing the time and voltage values, respectively.
     """
 
     with open(filename, "r", encoding="utf-8") as theFile:
@@ -48,16 +48,17 @@ def loadWave(filename):
         return (np.array(time), np.array(voltage))
 
 
-def interpFile(filename, sample_per):
-    """Read in a waveform from a file, and convert it to the given sample rate,
+def interpFile(filename: str, sample_per: float) -> Rvec:
+    """
+    Read in a waveform from a file, and convert it to the given sample rate,
     using linear interpolation.
 
     Args:
-        filename (str): Name of waveform file to read in.
-        sample_per (float): New sample interval, in seconds.
+        filename: Name of waveform file to read in.
+        sample_per: New sample interval, in seconds.
 
     Returns:
-        [float]: A *NumPy* array containing the resampled waveform.
+        A *NumPy* array containing the resampled waveform.
     """
 
     impulse = loadWave(filename)
@@ -106,9 +107,9 @@ class AMIModelInitializer:
     def __init__(self, ami_params: dict, info_params: Optional[dict] = None, **optional_args):
         """
         Constructor accepts a mandatory dictionary containing the AMI
-        parameters, as well as optional initialization data overrides and
-        validates them, before using them to update the local initialization
-        data structures.
+        parameters, as well as optional information parameter dictionary
+        and initialization data overrides, and validates them, before
+        using them to update the local initialization data structures.
 
         Valid names of optional initialization data overrides:
 
@@ -219,7 +220,7 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
 
     Notes:
         1. Makes the calling of ``AMI_Close()`` automagic,
-            by calling it from the destructor.
+        by calling it from the destructor.
     """
 
     def __init__(self, filename: str):
@@ -262,10 +263,10 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             init_object: The model initialization data.
 
         Notes:
-            * Takes an instance of ``AMIModelInitializer`` as its only argument.
-              This allows model initialization data to be constructed once,
-              and modified incrementally in between multiple calls of
-              ``initialize``. This is useful for *PyLab* command prompt testing.
+            1. Takes an instance of ``AMIModelInitializer`` as its only argument.
+            This allows model initialization data to be constructed once,
+            and modified incrementally in between multiple calls of
+            ``initialize``. This is useful for *PyLab* command prompt testing.
 
         ToDo:
             1. Allow for non-integral number of samples per unit interval.
@@ -375,8 +376,7 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
 
     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.
+        Performs time domain processing of input waveform, using the ``AMI_GetWave()`` function.
 
         Args:
             wave: Waveform to be processed.
@@ -386,14 +386,15 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
                 Default: 0 (Means "Use existing value.")
 
         Returns:
-            (wave_out, clock_times, params_out): A tuple containing:
+            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,
-                which means their values are: sampling instant - ui/2.
+            which means their values are: sampling instant - ui/2.
         """
 
         if bits_per_call:
@@ -432,7 +433,6 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
     def get_responses(  # pylint: disable=too-many-locals
         self,
         bits_per_call: int = 0,
-        # bit_gen: Optional[Iterator[int]] = None,
         pad_bits: int = 10,
         nbits: int = 200,
         calc_getw: bool = True
@@ -443,9 +443,6 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
         Keyword Args:
             bits_per_call: Number of bits to include in the input to `GetWave()`.
                 Default: 0 (Means "use model's existing value".)
-            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
@@ -455,19 +452,22 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
                 Default: True
 
         Returns:
-            rslt: Dictionary containing the responses under the following keys:
-                "imp_resp_init": The model's impulse response, from its `AMI_Init()` function (V/sample).
-                "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).
-                "out_resp_getw": `imp_resp_getw` convolved with the channel.
+            Dictionary containing the responses under the following keys
+
+                - "imp_resp_init": The model's impulse response, from its `AMI_Init()` function (V/sample).
+                - "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).
+                - "out_resp_getw": `imp_resp_getw` convolved with the channel.
 
         Notes:
             1. If either set of keys (i.e. - "..._init" or "..._getw")
-                is missing from the returned dictionary, it means that
-                that mode of operation (`AMI_Init()` or `AMI_GetWave()`)
-                was not available in the given model.
+            is missing from the returned dictionary, it means that
+            that mode of operation (`AMI_Init()` or `AMI_GetWave()`)
+            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.
+            nor the `GetWave_Exists` AMI reserved parameter was True.
+
             3. Note that impulse responses are returned with units: (V/sample), not (V/s).
 
         ToDo:
@@ -499,7 +499,6 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             h_model = deconv_same(out_imp, chnl_imp)  # noqa: F405
             rslt["imp_resp_init"] = np.roll(h_model, -len(h_model) // 2 + 3 * nspui)
 
-            # h_init = np.roll(self.initOut, pad_samps) * ts
             h_init = np.roll(out_imp, pad_samps)
             s_init = np.cumsum(h_init)                 # Step response.
             p_init = s_init - np.pad(s_init[:-nspui], (nspui, 0), mode='constant', constant_values=0)
@@ -525,15 +524,8 @@ class AMIModel:  # pylint: disable=too-many-instance-attributes
             # Match the d.c. offset of Init() output, for easier comparison of Init() & GetWave() outputs.
             s_getw -= s_getw[pad_samps - 1]
             p_getw = s_getw - np.pad(s_getw[:-nspui], (nspui, 0), mode='constant', constant_values=0)
-            # h_getw = diff(s_getw[pad_samps-1:])[:len(t)]
             _s = s_getw[pad_samps:]
-            try:
-                h_getw = np.insert(np.diff(_s), 0, _s[0])
-            except Exception:
-                print(f"_s: {_s}")
-                print(f"len(s_getw): {len(s_getw)}")
-                print(f"pad_samps: {pad_samps}")
-                raise
+            h_getw = np.insert(np.diff(_s), 0, _s[0])
             len_hgw = len(h_getw)
             if len_hgw > len_h:
                 h_getw = h_getw[:len_h]

{pyibis_ami-6.2.1 → pyibis_ami-7.1.0}/src/pyibisami/ami/parameter.py

@@ -136,8 +136,6 @@ class AMIParameter:  # pylint: disable=too-many-instance-attributes,too-few-publ
         "Process *Format* tag."
 
         form = values[0]
-        #        if(not form in ['Value', 'Range', 'List']):
-        #            raise AMIParamError ("Unrecognized format value: '{}'.".format(form))
         if len(values) < 2:
             raise AMIParamError(f"No values provided for: '{form}'.")
         self._format = form
@@ -259,13 +257,12 @@ class AMIParameter:  # pylint: disable=too-many-instance-attributes,too-few-publ
         """
         Args:
             name (str): The name of the AMI parameter being created.
-            tags ([(str, [a])]): A list of pairs, each containing:
+            tags ([(str, [a])]): A list of pairs, each containing
 
                 - a parameter definition tag name
-                    (Must be one of the keys from the
-                    '_param_def_tag_procs' dictionary.)
-                - a list of values to be associated with that tag.
+                    (Must be one of the keys from the '_param_def_tag_procs' dictionary.)
 
+                - a list of values to be associated with that tag.
         """
         # Initialization
         self._usage = None
@@ -343,7 +340,7 @@ class AMIParameter:  # pylint: disable=too-many-instance-attributes,too-few-publ
                 raise AMIParamError(f"Illegal type, '{param_type}', for use with Range.\n")
             if len(vals) < 3:
                 raise AMIParamError(f"Insufficient number of values, {len(vals)}, provided for Range.\n")
-            if param_type in ("Float", "UI"):
+            if param_type in ("Float", "UI", "Tap"):
                 try:
                     temp_vals = list(map(float, vals[:3]))
                 except (ValueError, TypeError) as exc: