91 lines
3.2 KiB
Python
91 lines
3.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
# *****************************************************************************
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify it under
|
|
# the terms of the GNU General Public License as published by the Free Software
|
|
# Foundation; either version 2 of the License, or (at your option) any later
|
|
# version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful, but WITHOUT
|
|
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
|
|
# details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License along with
|
|
# this program; if not, write to the Free Software Foundation, Inc.,
|
|
# 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
#
|
|
# Module authors:
|
|
# Enrico Faulhaber <enrico.faulhaber@frm2.tum.de>
|
|
# Markus Zolliker <markus.zolliker@psi.ch>
|
|
#
|
|
# *****************************************************************************
|
|
"""Define Mixin Features for real Modules implemented in the server"""
|
|
|
|
|
|
from secop.datatypes import ArrayOf, BoolType, EnumType, \
|
|
FloatRange, StringType, StructOf, TupleOf
|
|
from secop.core import Command, Done, Drivable, Feature, \
|
|
Parameter, Property, PersistentParam, Readable
|
|
from secop.errors import BadValueError, ConfigError
|
|
from secop.lib import clamp
|
|
|
|
|
|
class HasSimpleOffset(Feature):
|
|
"""has a client side offset parameter
|
|
|
|
this is just a storage!
|
|
"""
|
|
offset = PersistentParam('offset (physical value + offset = HW value)',
|
|
FloatRange(unit='deg'), readonly=False, default=0)
|
|
|
|
|
|
class HasTargetLimits(Feature):
|
|
"""user limits
|
|
|
|
implementation to be done in the subclass
|
|
according to standard
|
|
"""
|
|
target_limits = PersistentParam('user limits', readonly=False, default=(-9e99, 9e99),
|
|
datatype=TupleOf(FloatRange(unit='deg'), FloatRange(unit='deg')))
|
|
|
|
def check_limits(self, value):
|
|
"""check if value is valid"""
|
|
min_, max_ = self.target_limits
|
|
if not min_ <= value <= max_:
|
|
raise BadValueError('limits violation: %g outside [%g, %g]' % (value, min_, max_))
|
|
|
|
|
|
# --- legacy mixins, not agreed as standard ---
|
|
|
|
class HasOffset(Feature):
|
|
"""has an offset parameter
|
|
|
|
implementation to be done in the subclass
|
|
"""
|
|
offset = Parameter('offset (physical value + offset = HW value)',
|
|
FloatRange(unit='$'), readonly=False, default=0)
|
|
|
|
|
|
class HasLimits(Feature):
|
|
"""user limits
|
|
|
|
implementation to be done in the subclass
|
|
|
|
for a drivable, abslimits is roughly the same as the target datatype limits,
|
|
except for the offset
|
|
"""
|
|
target_limits = Parameter('user limits for target', readonly=False, default=(-9e99, 9e99),
|
|
datatype=TupleOf(FloatRange(unit='$'), FloatRange(unit='$')))
|
|
|
|
def earlyInit(self):
|
|
super().earlyInit()
|
|
dt = self.parameters['target'].datatype
|
|
self.target_limits = dt.min, dt.max
|
|
|
|
def check_limits(self, value):
|
|
"""check if value is valid"""
|
|
min_, max_ = self.target_limits
|
|
if not min_ <= value <= max_:
|
|
raise BadValueError('limits violation: %g outside [%g, %g]' % (value, min_, max_))
|