PyPalmSens 1.0.0__tar.gz

pypalmsens-1.0.0/LICENSE

@@ -0,0 +1,30 @@
+Copyright (c)  2025 PalmSens BV
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+You acknowledge that this software is designed, licenced, and intended for use
+with a PalmSens BV device or component.

pypalmsens-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+# https://setuptools.pypa.io/en/latest/userguide/miscellaneous.html
+graft src/pypalmsens/_pssdk/
+graft src/pypalmsens/_runtimes/

pypalmsens-1.0.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: PyPalmSens
+Version: 1.0.0
+Summary: Python SDK for PalmSens instruments
+Author-email: Palmsens BV <info@palmsens.com>
+License-Expression: LicenseRef-Modified-BSD-3-Clause-PalmSens
+Project-URL: homepage, https://github.com/palmsens/palmsens_sdk
+Project-URL: issues, https://github.com/palmsens/palmsens_sdk/issues
+Project-URL: documentation, https://github.com/palmsens/palmsens_sdk
+Project-URL: changelog, https://github.com/palmsens/palmsens_sdk/releases
+Keywords: electrochemistry,data-analysis,voltammetry,potentiometry,impedance-specroscopy
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs
+Requires-Dist: numpy
+Requires-Dist: packaging
+Requires-Dist: pythonnet
+Provides-Extra: develop
+Requires-Dist: bump-my-version; extra == "develop"
+Requires-Dist: coverage; extra == "develop"
+Requires-Dist: griffe2md; extra == "develop"
+Requires-Dist: pre-commit; extra == "develop"
+Requires-Dist: pytest; extra == "develop"
+Requires-Dist: pytest-asyncio; extra == "develop"
+Provides-Extra: publishing
+Requires-Dist: twine; extra == "publishing"
+Requires-Dist: wheel; extra == "publishing"
+Requires-Dist: build; extra == "publishing"
+Dynamic: license-file
+
+[![Tests](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml/badge.svg)](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pypalmsens)](https://pypi.org/project/pypalmsens/)
+[![PyPI](https://img.shields.io/pypi/v/pypalmsens.svg?style=flat)](https://pypi.org/project/pypalmsens/)
+
+# PyPalmSens: Python SDK for PalmSens devices
+
+PyPalmSens is a Python library for automating electrochemistry experiments with your PalmSens instruments.
+It provides an intuitive Python API, making it straightforward to integrate into your Python workflows.
+
+With PyPalmSens, you can:
+
+- Connect to one or more instruments/channels
+- Automate electrochemistry measurements
+- Access and process measured data
+- Analyze and manipulate data
+- Perform peak detection
+- Do Equivalent Circuit Fitting on impedance data
+- Manually control of the cell
+- Read and write method and data files
+
+To install:
+
+```python
+pip install pypalmsens
+```
+
+PyPalmSens is built on top of the included [PalmSens .NET libraries](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/core_dll.html), and therefore requires the .NET runtime to be installed.
+
+For specific installation instructions for your platform, see the
+[documentation](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/python/index.html).

pypalmsens-1.0.0/README.md

@@ -0,0 +1,30 @@
+[![Tests](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml/badge.svg)](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pypalmsens)](https://pypi.org/project/pypalmsens/)
+[![PyPI](https://img.shields.io/pypi/v/pypalmsens.svg?style=flat)](https://pypi.org/project/pypalmsens/)
+
+# PyPalmSens: Python SDK for PalmSens devices
+
+PyPalmSens is a Python library for automating electrochemistry experiments with your PalmSens instruments.
+It provides an intuitive Python API, making it straightforward to integrate into your Python workflows.
+
+With PyPalmSens, you can:
+
+- Connect to one or more instruments/channels
+- Automate electrochemistry measurements
+- Access and process measured data
+- Analyze and manipulate data
+- Perform peak detection
+- Do Equivalent Circuit Fitting on impedance data
+- Manually control of the cell
+- Read and write method and data files
+
+To install:
+
+```python
+pip install pypalmsens
+```
+
+PyPalmSens is built on top of the included [PalmSens .NET libraries](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/core_dll.html), and therefore requires the .NET runtime to be installed.
+
+For specific installation instructions for your platform, see the
+[documentation](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/python/index.html).

pypalmsens-1.0.0/pyproject.toml

@@ -0,0 +1,126 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+# https://packaging.python.org/en/latest/specifications/declaring-project-metadata/
+[project]
+name = "PyPalmSens"
+version = "1.0.0"
+description = "Python SDK for PalmSens instruments"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+	{name = "Palmsens BV", email = "info@palmsens.com"},
+]
+keywords = [
+    "electrochemistry",
+    "data-analysis",
+    "voltammetry",
+    "potentiometry",
+    "impedance-specroscopy",
+]
+license= "LicenseRef-Modified-BSD-3-Clause-PalmSens"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Science/Research",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    'attrs',
+    'numpy',
+    'packaging',
+    'pythonnet',
+]
+
+[project.urls]
+homepage = "https://github.com/palmsens/palmsens_sdk"
+issues = "https://github.com/palmsens/palmsens_sdk/issues"
+documentation = "https://github.com/palmsens/palmsens_sdk"
+changelog = "https://github.com/palmsens/palmsens_sdk/releases"
+
+[project.optional-dependencies]
+develop = [
+    "bump-my-version",
+    "coverage",
+    "griffe2md",
+    "pre-commit",
+    "pytest",
+    "pytest-asyncio",
+]
+
+publishing = [
+    "twine",
+    "wheel",
+    "build",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.coverage.run]
+branch = true
+source = ["pypalmsens"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "examples: Mark tests that run the examples.",
+    "instrument: Mark tests that need an instrument connection."
+]
+log_cli = false
+log_cli_level = "INFO"
+
+[tool.ruff]
+src=['src']
+line-length = 96
+target-version = "py310"
+
+[tool.ruff.lint]
+# Enable Pyflakes `E` and `F` codes by default.
+select = [
+	"F",  # Pyflakes
+	"E",  # pycodestyle (error)
+	"W",  # pycodestyle (warning)
+    "I",  # isort
+]
+ignore = [
+    "E501",  # line-too-long
+]
+
+[tool.ruff.lint.isort]
+known-first-party=["pypalmsens"]
+known-third-party = []
+required-imports = ["from __future__ import annotations"]
+
+[tool.ruff.lint.per-file-ignores]
+"examples/*.py" = ["I"]
+
+[tool.ruff.format]
+indent-style = "space"
+quote-style = "single"
+
+[tool.mypy]
+files = ["src", "tests", "examples"]
+allow_redefinition = true
+ignore_missing_imports = true
+
+[tool.bumpversion]
+current_version = "1.0.0"
+
+[[tool.bumpversion.files]]
+filename = "src/pypalmsens/__init__.py"
+search = "__version__ = '{current_version}'"
+replace = "__version__ = '{new_version}'"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = "version = \"{current_version}\""
+replace = "version = \"{new_version}\""

pypalmsens-1.0.0/setup.cfg

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

pypalmsens-1.0.0/src/PyPalmSens.egg-info/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: PyPalmSens
+Version: 1.0.0
+Summary: Python SDK for PalmSens instruments
+Author-email: Palmsens BV <info@palmsens.com>
+License-Expression: LicenseRef-Modified-BSD-3-Clause-PalmSens
+Project-URL: homepage, https://github.com/palmsens/palmsens_sdk
+Project-URL: issues, https://github.com/palmsens/palmsens_sdk/issues
+Project-URL: documentation, https://github.com/palmsens/palmsens_sdk
+Project-URL: changelog, https://github.com/palmsens/palmsens_sdk/releases
+Keywords: electrochemistry,data-analysis,voltammetry,potentiometry,impedance-specroscopy
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs
+Requires-Dist: numpy
+Requires-Dist: packaging
+Requires-Dist: pythonnet
+Provides-Extra: develop
+Requires-Dist: bump-my-version; extra == "develop"
+Requires-Dist: coverage; extra == "develop"
+Requires-Dist: griffe2md; extra == "develop"
+Requires-Dist: pre-commit; extra == "develop"
+Requires-Dist: pytest; extra == "develop"
+Requires-Dist: pytest-asyncio; extra == "develop"
+Provides-Extra: publishing
+Requires-Dist: twine; extra == "publishing"
+Requires-Dist: wheel; extra == "publishing"
+Requires-Dist: build; extra == "publishing"
+Dynamic: license-file
+
+[![Tests](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml/badge.svg)](https://github.com/PalmSens/PalmSens_SDK/actions/workflows/python-tests.yml)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pypalmsens)](https://pypi.org/project/pypalmsens/)
+[![PyPI](https://img.shields.io/pypi/v/pypalmsens.svg?style=flat)](https://pypi.org/project/pypalmsens/)
+
+# PyPalmSens: Python SDK for PalmSens devices
+
+PyPalmSens is a Python library for automating electrochemistry experiments with your PalmSens instruments.
+It provides an intuitive Python API, making it straightforward to integrate into your Python workflows.
+
+With PyPalmSens, you can:
+
+- Connect to one or more instruments/channels
+- Automate electrochemistry measurements
+- Access and process measured data
+- Analyze and manipulate data
+- Perform peak detection
+- Do Equivalent Circuit Fitting on impedance data
+- Manually control of the cell
+- Read and write method and data files
+
+To install:
+
+```python
+pip install pypalmsens
+```
+
+PyPalmSens is built on top of the included [PalmSens .NET libraries](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/core_dll.html), and therefore requires the .NET runtime to be installed.
+
+For specific installation instructions for your platform, see the
+[documentation](https://palmsens.github.io/PalmSens_SDK/palmsens-sdk/python/index.html).

pypalmsens-1.0.0/src/PyPalmSens.egg-info/SOURCES.txt

@@ -0,0 +1,54 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/PyPalmSens.egg-info/PKG-INFO
+src/PyPalmSens.egg-info/SOURCES.txt
+src/PyPalmSens.egg-info/dependency_links.txt
+src/PyPalmSens.egg-info/requires.txt
+src/PyPalmSens.egg-info/top_level.txt
+src/pypalmsens/__init__.py
+src/pypalmsens/_fitting.py
+src/pypalmsens/_io.py
+src/pypalmsens/_shared.py
+src/pypalmsens/data.py
+src/pypalmsens/fitting.py
+src/pypalmsens/settings.py
+src/pypalmsens/_data/__init__.py
+src/pypalmsens/_data/_shared.py
+src/pypalmsens/_data/curve.py
+src/pypalmsens/_data/data_array.py
+src/pypalmsens/_data/dataset.py
+src/pypalmsens/_data/eisdata.py
+src/pypalmsens/_data/measurement.py
+src/pypalmsens/_data/peak.py
+src/pypalmsens/_instruments/__init__.py
+src/pypalmsens/_instruments/_common.py
+src/pypalmsens/_instruments/instrument_manager.py
+src/pypalmsens/_instruments/instrument_manager_async.py
+src/pypalmsens/_lib/__init__.py
+src/pypalmsens/_lib/mono.py
+src/pypalmsens/_lib/windows.py
+src/pypalmsens/_methods/__init__.py
+src/pypalmsens/_methods/_shared.py
+src/pypalmsens/_methods/method.py
+src/pypalmsens/_methods/settings.py
+src/pypalmsens/_methods/techniques.py
+src/pypalmsens/_pssdk/mono/PalmSens.Core.Linux.dll
+src/pypalmsens/_pssdk/mono/PalmSens.Core.dll
+src/pypalmsens/_pssdk/mono/PalmSens.Core.xml
+src/pypalmsens/_pssdk/mono/runtimeconfig.json
+src/pypalmsens/_pssdk/win/PalmSens.Core.Windows.BLE.dll
+src/pypalmsens/_pssdk/win/PalmSens.Core.Windows.BLE.xml
+src/pypalmsens/_pssdk/win/PalmSens.Core.dll
+src/pypalmsens/_pssdk/win/PalmSens.Core.xml
+src/pypalmsens/_runtimes/linux-arm/native/System.IO.Ports.dll
+src/pypalmsens/_runtimes/linux-arm/native/libSystem.IO.Ports.Native.so
+src/pypalmsens/_runtimes/linux-arm64/native/System.IO.Ports.dll
+src/pypalmsens/_runtimes/linux-arm64/native/libSystem.IO.Ports.Native.so
+src/pypalmsens/_runtimes/linux-x64/native/System.IO.Ports.dll
+src/pypalmsens/_runtimes/linux-x64/native/libSystem.IO.Ports.Native.so
+src/pypalmsens/_runtimes/osx-arm64/native/System.IO.Ports.dll
+src/pypalmsens/_runtimes/osx-arm64/native/libSystem.IO.Ports.Native.dylib
+src/pypalmsens/_runtimes/osx-x64/native/System.IO.Ports.dll
+src/pypalmsens/_runtimes/osx-x64/native/libSystem.IO.Ports.Native.dylib

pypalmsens-1.0.0/src/PyPalmSens.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pypalmsens-1.0.0/src/PyPalmSens.egg-info/requires.txt

@@ -0,0 +1,17 @@
+attrs
+numpy
+packaging
+pythonnet
+
+[develop]
+bump-my-version
+coverage
+griffe2md
+pre-commit
+pytest
+pytest-asyncio
+
+[publishing]
+twine
+wheel
+build

pypalmsens-1.0.0/src/PyPalmSens.egg-info/top_level.txt

@@ -0,0 +1 @@
+pypalmsens

pypalmsens-1.0.0/src/pypalmsens/__init__.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import sys
+
+# Load dotnet platform dependencies and init SDK
+if sys.platform == 'win32':
+    from ._lib.windows import sdk_version
+else:
+    from ._lib.mono import sdk_version
+
+__version__ = '1.0.0'
+__sdk_version__ = sdk_version
+
+from . import data, fitting, settings
+from ._instruments.instrument_manager import (
+    InstrumentManager,
+    connect,
+    discover,
+)
+from ._instruments.instrument_manager_async import (
+    InstrumentManagerAsync,
+    connect_async,
+    discover_async,
+)
+from ._io import load_method_file, load_session_file, save_method_file, save_session_file
+from ._methods.techniques import (
+    ChronoAmperometry,
+    ChronoPotentiometry,
+    CyclicVoltammetry,
+    DifferentialPulseVoltammetry,
+    ElectrochemicalImpedanceSpectroscopy,
+    GalvanostaticImpedanceSpectroscopy,
+    LinearSweepVoltammetry,
+    MethodScript,
+    MultiStepAmperometry,
+    OpenCircuitPotentiometry,
+    SquareWaveVoltammetry,
+)
+
+__all__ = [
+    'settings',
+    'data',
+    'fitting',
+    'connect',
+    'connect_async',
+    'discover',
+    'discover_async',
+    'load_method_file',
+    'load_session_file',
+    'save_method_file',
+    'save_session_file',
+    'InstrumentManager',
+    'InstrumentManagerAsync',
+    'ChronoAmperometry',
+    'ChronoPotentiometry',
+    'CyclicVoltammetry',
+    'DifferentialPulseVoltammetry',
+    'ElectrochemicalImpedanceSpectroscopy',
+    'GalvanostaticImpedanceSpectroscopy',
+    'LinearSweepVoltammetry',
+    'MethodScript',
+    'MultiStepAmperometry',
+    'OpenCircuitPotentiometry',
+    'SquareWaveVoltammetry',
+]

pypalmsens-1.0.0/src/pypalmsens/_data/__init__.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from .curve import Curve
+from .data_array import DataArray
+from .dataset import DataSet
+from .eisdata import EISData
+from .measurement import DeviceInfo, Measurement
+from .peak import Peak
+
+__all__ = [
+    'Curve',
+    'DataArray',
+    'DataSet',
+    'DeviceInfo',
+    'EISData',
+    'Measurement',
+    'Peak',
+]

pypalmsens-1.0.0/src/pypalmsens/_data/_shared.py

@@ -0,0 +1,135 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Optional
+
+
+class ArrayType(Enum):
+    """Data array type for standard arrays."""
+
+    Unspecified = -1
+    """Unspecified"""
+    Time = 0
+    """Time / s"""
+    Potential = 1
+    """Potential / V"""
+    Current = 2
+    """Current / μA"""
+    Charge = 3
+    """Charge"""
+    ExtraValue = 4
+    """ExtraValue"""
+    Frequency = 5
+    """Frequency"""
+    Phase = 6
+    """Phase"""
+    ZRe = 7
+    """Z real"""
+    ZIm = 8
+    """Z imaginary"""
+    Iac = 9
+    """I AC values"""
+    Z = 10
+    """Z"""
+    Y = 11
+    """Y"""
+    YRe = 12
+    """Y real"""
+    YIm = 13
+    """Y imaginary"""
+    Cs = 14
+    """Cs"""
+    CsRe = 15
+    """Cs real"""
+    CsIm = 16
+    """Cs imaginary"""
+    Index = 17
+    """Index"""
+    Admittance = 18
+    """Admittance"""
+    Concentration = 19
+    """Concentration"""
+    Signal = 20
+    """Signal"""
+    Func = 21
+    """Func"""
+    Integral = 22
+    """Integral"""
+    AuxInput = 23
+    """Auxillary input"""
+    BipotCurrent = 24
+    """Bipot current"""
+    BipotPotential = 25
+    """Bipot potential"""
+    ReverseCurrent = 26
+    """Reverse current"""
+    CEPotential = 27
+    """CE potential"""
+    DCCurrent = 28
+    """DC current"""
+    ForwardCurrent = 29
+    """Forward current"""
+    PotentialExtraRE = 30
+    """Potential setpoint measured back on RE"""
+    CurrentExtraWE = 31
+    """Current setpoint measured back on WE"""
+    InverseDerative_dtdE = 32
+    """Inverse derivative dt/dE"""
+    mEdc = 33
+    """Measured applied DC"""
+    Eac = 34
+    """E AC values"""
+    MeasuredStepStartIndex = 35
+    """MeasuredStepStartIndex"""
+    miDC = 36
+    """Measured I DC values"""
+    SE2vsXPotential = 37
+    """SE2 vs XPotential"""
+
+    @classmethod
+    def _missing_(cls, value):
+        return cls.Unspecified
+
+
+class Status(Enum):
+    Unknown = -1
+    OK = 0
+    Overload = 1
+    Underload = 2
+
+
+def _get_values_from_NETArray(array, start: int = 0, count: Optional[int] = None):
+    if not count:
+        count = array.Count
+
+    values = []
+    for i in range(start, start + count):
+        value = array.get_Item(i)
+        values.append(float(value.Value))
+    return values
+
+
+def __get_currentranges_from_currentarray(
+    arraycurrents, start: int = 0, count: Optional[int] = None
+):
+    if not count:
+        count = arraycurrents.Count
+    values = []
+    if ArrayType(arraycurrents.ArrayType) == ArrayType.Current:
+        for i in range(start, count):
+            value = arraycurrents.get_Item(i)
+            values.append(str(value.CurrentRange.ToString()))
+    return values
+
+
+def __get_status_from_current_or_potentialarray(
+    array, start: int = 0, count: Optional[int] = None
+):
+    if not count:
+        count = array.Count
+
+    values = []
+    for i in range(start, count):
+        value = array.get_Item(i)
+        values.append(str(Status(value.ReadingStatus)))
+    return values