Source code for apstools.synApps.transform
"""
Ophyd support for the EPICS transform record
Public Structures
.. autosummary::
~UserTransformN
~UserTransformsDevice
~TransformRecord
"""
from collections import OrderedDict
from ophyd import Component as Cpt
from ophyd import Device
from ophyd import DynamicDeviceComponent as DDC
from ophyd import EpicsSignal
from ophyd import EpicsSignalRO
from ophyd import FormattedComponent as FC
from .. import utils as APS_utils
from ._common import EpicsRecordDeviceCommonAll
from ._common import EpicsSynAppsRecordEnableMixin
CHANNEL_LETTERS_LIST = "A B C D E F G H I J K L M N O P".split()
[docs]class transformRecordChannel(Device):
"""
channel of a synApps transform record: A-P
.. index:: Ophyd Device; synApps transformRecordChannel
.. autosummary::
~reset
"""
current_value = FC(EpicsSignal, "{self.prefix}.{self._ch_letter}", kind="hinted")
last_value = FC(EpicsSignalRO, "{self.prefix}.L{self._ch_letter}", kind="config")
input_pv = FC(EpicsSignal, "{self.prefix}.INP{self._ch_letter}", kind="config")
input_pv_valid = FC(EpicsSignalRO, "{self.prefix}.I{self._ch_letter}V", kind="config")
expression_invalid = FC(EpicsSignalRO, "{self.prefix}.C{self._ch_letter}V", kind="config")
comment = FC(EpicsSignal, "{self.prefix}.CMT{self._ch_letter}", kind="config")
expression = FC(EpicsSignal, "{self.prefix}.CLC{self._ch_letter}", kind="config")
output_pv = FC(EpicsSignal, "{self.prefix}.OUT{self._ch_letter}", kind="config")
output_pv_valid = FC(EpicsSignalRO, "{self.prefix}.O{self._ch_letter}V", kind="config")
read_attrs = ["current_value"]
def __init__(self, prefix, letter, **kwargs):
self._ch_letter = letter
super().__init__(prefix, **kwargs)
[docs] def reset(self):
"""set all fields to default values"""
self.comment.put(self._ch_letter.lower())
self.input_pv.put("")
self.expression.put("")
self.current_value.put(0)
self.output_pv.put("")
def _channels(channel_list):
defn = OrderedDict()
for chan in channel_list:
defn[chan] = (transformRecordChannel, "", {"letter": chan})
return defn
[docs]class TransformRecord(EpicsRecordDeviceCommonAll):
"""
EPICS transform record support in ophyd
.. index:: Ophyd Device; synApps TransformRecord
.. autosummary::
~reset
:see: https://htmlpreview.github.io/?https://raw.githubusercontent.com/epics-modules/calc/R3-6-1/documentation/TransformRecord.html#Fields
"""
units = Cpt(EpicsSignal, ".EGU", kind="config")
precision = Cpt(EpicsSignal, ".PREC", kind="config")
version = Cpt(EpicsSignalRO, ".VERS", kind="config")
calc_option = Cpt(EpicsSignal, ".COPT", kind="config")
invalid_link_action = Cpt(EpicsSignalRO, ".IVLA", kind="config")
input_bitmap = Cpt(EpicsSignalRO, ".MAP", kind="config")
read_attrs = APS_utils.itemizer("channels.%s", CHANNEL_LETTERS_LIST)
hints = {"fields": read_attrs}
channels = DDC(_channels(CHANNEL_LETTERS_LIST))
[docs] def reset(self):
"""set all fields to default values"""
self.scanning_rate.put("Passive")
self.description.put(self.description.pvname.split(".")[0])
self.units.put("")
self.calc_option.put(0)
self.precision.put("3")
self.forward_link.put("")
for letter in self.channels.read_attrs:
channel = getattr(self.channels, letter)
if isinstance(channel, transformRecordChannel):
channel.reset()
self.hints["fields"] = ["channels.%s" % c for c in CHANNEL_LETTERS_LIST]
self.read_attrs = ["channels.%s" % c for c in CHANNEL_LETTERS_LIST]
[docs]class UserTransformN(EpicsSynAppsRecordEnableMixin, TransformRecord):
"""Single instance of the userTranN database."""
[docs]class UserTransformsDevice(Device):
"""
EPICS synApps XXX IOC setup of userTransforms: ``$(P):userTran$(N)``
.. index:: Ophyd Device; synApps UserTransformsDevice
"""
enable = Cpt(EpicsSignal, "userTranEnable", kind="config")
transform1 = Cpt(UserTransformN, "userTran1")
transform2 = Cpt(UserTransformN, "userTran2")
transform3 = Cpt(UserTransformN, "userTran3")
transform4 = Cpt(UserTransformN, "userTran4")
transform5 = Cpt(UserTransformN, "userTran5")
transform6 = Cpt(UserTransformN, "userTran6")
transform7 = Cpt(UserTransformN, "userTran7")
transform8 = Cpt(UserTransformN, "userTran8")
transform9 = Cpt(UserTransformN, "userTran9")
transform10 = Cpt(UserTransformN, "userTran10")
[docs] def reset(self): # lgtm [py/similar-function]
"""set all fields to default values"""
self.transform1.reset()
self.transform2.reset()
self.transform3.reset()
self.transform4.reset()
self.transform5.reset()
self.transform6.reset()
self.transform7.reset()
self.transform8.reset()
self.transform9.reset()
self.transform10.reset()
self.read_attrs = ["transform%d" % (c + 1) for c in range(10)]
self.read_attrs.insert(0, "enable")
# -----------------------------------------------------------------------------
# :author: Pete R. Jemian
# :email: jemian@anl.gov
# :copyright: (c) 2017-2024, UChicago Argonne, LLC
#
# Distributed under the terms of the Argonne National Laboratory Open Source License.
#
# The full license is in the file LICENSE.txt, distributed with this software.
# -----------------------------------------------------------------------------