mirror of
https://github.com/SheffieldML/GPy.git
synced 2026-06-02 14:45:15 +02:00
1054 lines
47 KiB
Python
1054 lines
47 KiB
Python
# Copyright (c) 2012, GPy authors (see AUTHORS.txt).
|
|
# Licensed under the BSD 3-clause license (see LICENSE.txt)
|
|
|
|
|
|
import numpy; np = numpy
|
|
import copy
|
|
import cPickle
|
|
import itertools
|
|
from re import compile, _pattern_type
|
|
from param import ParamConcatenation, Param
|
|
from parameter_core import Constrainable, Pickleable, Observable, adjust_name_for_printing
|
|
from index_operations import ParameterIndexOperations,\
|
|
index_empty
|
|
|
|
#===============================================================================
|
|
# Printing:
|
|
__fixed__ = "fixed"
|
|
#===============================================================================
|
|
|
|
#===============================================================================
|
|
# constants
|
|
FIXED = False
|
|
UNFIXED = True
|
|
#===============================================================================
|
|
|
|
class Parameterized(Constrainable, Pickleable, Observable):
|
|
"""
|
|
Parameterized class
|
|
|
|
Say m is a handle to a parameterized class.
|
|
|
|
Printing parameters:
|
|
|
|
- print m: prints a nice summary over all parameters
|
|
- print m.name: prints details for param with name 'name'
|
|
- print m[regexp]: prints details for all the parameters
|
|
which match (!) regexp
|
|
- print m['']: prints details for all parameters
|
|
|
|
Fields:
|
|
|
|
Name: The name of the param, can be renamed!
|
|
Value: Shape or value, if one-valued
|
|
Constrain: constraint of the param, curly "{c}" brackets indicate
|
|
some parameters are constrained by c. See detailed print
|
|
to get exact constraints.
|
|
Tied_to: which paramter it is tied to.
|
|
|
|
Getting and setting parameters:
|
|
|
|
Set all values in param to one:
|
|
|
|
m.name.to.param = 1
|
|
|
|
Handling of constraining, fixing and tieing parameters:
|
|
|
|
You can constrain parameters by calling the constrain on the param itself, e.g:
|
|
|
|
- m.name[:,1].constrain_positive()
|
|
- m.name[0].tie_to(m.name[1])
|
|
|
|
Fixing parameters will fix them to the value they are right now. If you change
|
|
the parameters value, the param will be fixed to the new value!
|
|
|
|
If you want to operate on all parameters use m[''] to wildcard select all paramters
|
|
and concatenate them. Printing m[''] will result in printing of all parameters in detail.
|
|
"""
|
|
def __init__(self, name=None):
|
|
super(Parameterized, self).__init__(name=name)
|
|
self._in_init_ = True
|
|
self._constraints_ = None#ParameterIndexOperations()
|
|
if not hasattr(self, "_parameters_"):
|
|
self._parameters_ = []
|
|
self.size = sum(p.size for p in self._parameters_)
|
|
if not self._has_fixes():
|
|
self._fixes_ = None
|
|
self._connect_parameters()
|
|
self.gradient_mapping = {}
|
|
self._added_names_ = set()
|
|
del self._in_init_
|
|
|
|
@property
|
|
def constraints(self):
|
|
if self._constraints_ is None:
|
|
self._constraints_ = ParameterIndexOperations()
|
|
return self._constraints_
|
|
#===========================================================================
|
|
# Parameter connection for model creation:
|
|
#===========================================================================
|
|
# def set_as_parameter(self, name, array, gradient, index=None, gradient_parent=None):
|
|
# """
|
|
# :param name: name of the param (in print and plots), can be callable without parameters
|
|
# :type name: str, callable
|
|
# :param array: array which the param consists of
|
|
# :type array: array-like
|
|
# :param gradient: gradient method of the param
|
|
# :type gradient: callable
|
|
# :param index: (optional) index of the param when printing
|
|
#
|
|
# (:param gradient_parent: connect these parameters to this class, but tell
|
|
# updates to highest_parent, this is needed when parameterized classes
|
|
# contain parameterized classes, but want to access the parameters
|
|
# of their children)
|
|
#
|
|
#
|
|
# Set array (e.g. self.X) as param with name and gradient.
|
|
# I.e: self.set_as_parameter('curvature', self.lengthscale, self.dK_dlengthscale)
|
|
#
|
|
# Note: the order in which parameters are added can be adjusted by
|
|
# giving an index, of where to put this param in printing
|
|
# """
|
|
# if index is None:
|
|
# self._parameters_.append(Param(name, array, gradient))
|
|
# else:
|
|
# self._parameters_.insert(index, Param(name, array, gradient))
|
|
# self._connect_parameters(gradient_parent=gradient_parent)
|
|
|
|
def _has_fixes(self):
|
|
return hasattr(self, "_fixes_") and self._fixes_ is not None
|
|
|
|
def add_parameter(self, param, gradient=None, index=None):
|
|
"""
|
|
:param parameters: the parameters to add
|
|
:type parameters: list of or one :py:class:`GPy.core.param.Param`
|
|
:param [gradients]: gradients for each param,
|
|
one gradient per param
|
|
:param [index]: index of where to put parameters
|
|
|
|
|
|
Add all parameters to this param class, you can insert parameters
|
|
at any given index using the :func:`list.insert` syntax
|
|
"""
|
|
if param in self._parameters_ and index is not None:
|
|
# make sure fixes and constraints are indexed right
|
|
if self._has_fixes():
|
|
param_slice = slice(self._offset_for(param),self._offset_for(param)+param.size)
|
|
dest_index = sum((p.size for p in self._parameters_[:index]))
|
|
dest_slice = slice(dest_index,dest_index+param.size)
|
|
fixes_param = self._fixes_[param_slice].copy()
|
|
self._fixes_[param_slice] = self._fixes_[dest_slice]
|
|
self._fixes_[dest_slice] = fixes_param
|
|
|
|
del self._parameters_[param._parent_index_]
|
|
self._parameters_.insert(index, param)
|
|
elif param not in self._parameters_:
|
|
# make sure the size is set
|
|
if not hasattr(self, 'size'):
|
|
self.size = sum(p.size for p in self._parameters_)
|
|
if index is None:
|
|
self._parameters_.append(param)
|
|
|
|
# make sure fixes and constraints are indexed right
|
|
if param._has_fixes(): fixes_param = param._fixes_.copy()
|
|
else: fixes_param = numpy.ones(param.size, dtype=bool)
|
|
if self._has_fixes(): self._fixes_ = np.r_[self._fixes_, fixes_param]
|
|
elif param._has_fixes(): self._fixes_ = np.r_[np.ones(self.size, dtype=bool), fixes_param]
|
|
|
|
else:
|
|
self._parameters_.insert(index, param)
|
|
|
|
# make sure fixes and constraints are indexed right
|
|
if param._has_fixes(): fixes_param = param._fixes_.copy()
|
|
else: fixes_param = numpy.ones(param.size, dtype=bool)
|
|
ins = sum((p.size for p in self._parameters_[:index]))
|
|
if self._has_fixes(): self._fixes_ = np.r_[self._fixes_[:ins], fixes_param, self._fixes[ins:]]
|
|
elif not np.all(fixes_param):
|
|
self._fixes_ = np.ones(self.size+param.size, dtype=bool)
|
|
self._fixes_[ins:ins+param.size] = fixes_param
|
|
self.size += param.size
|
|
if gradient:
|
|
self.gradient_mapping[param] = gradient
|
|
self._connect_parameters()
|
|
# make sure the constraints are pulled over:
|
|
if hasattr(param, "_constraints_") and param._constraints_ is not None:
|
|
for t, ind in param._constraints_.iteritems():
|
|
self.constraints.add(t, ind+self._offset_for(param))
|
|
param._constraints_.clear()
|
|
if self._has_fixes() and np.all(self._fixes_): # ==UNFIXED
|
|
self._fixes_= None
|
|
|
|
def add_parameters(self, *parameters):
|
|
"""
|
|
convenience method for adding several
|
|
parameters without gradient specification
|
|
"""
|
|
[self.add_parameter(p) for p in parameters]
|
|
|
|
def remove_parameter(self, *names_params_indices):
|
|
"""
|
|
:param names_params_indices: mix of parameter_names, param objects, or indices
|
|
to remove from being a param of this parameterized object.
|
|
|
|
note: if it is a string object it will not (!) be regexp-matched
|
|
automatically.
|
|
"""
|
|
self._parameters_ = [p for p in self._parameters_
|
|
if not (p._parent_index_ in names_params_indices
|
|
or p.name in names_params_indices
|
|
or p in names_params_indices)]
|
|
self._connect_parameters()
|
|
|
|
def parameters_changed(self):
|
|
"""
|
|
This method gets called when parameters have changed.
|
|
Another way of listening to param changes is to
|
|
add self as a listener to the param, such that
|
|
updates get passed through. See :py:function:``GPy.core.param.Observable.add_observer``
|
|
"""
|
|
# will be called as soon as paramters have changed
|
|
pass
|
|
|
|
def _connect_parameters(self):
|
|
# connect parameterlist to this parameterized object
|
|
# This just sets up the right connection for the params objects
|
|
# to be used as parameters
|
|
if not hasattr(self, "_parameters_") or len(self._parameters_) < 1:
|
|
# no parameters for this class
|
|
return
|
|
i = 0
|
|
sizes = [0]
|
|
self._param_slices_ = []
|
|
for p in self._parameters_:
|
|
p._direct_parent_ = self
|
|
p._parent_index_ = i
|
|
i += 1
|
|
for pi in p.flattened_parameters:
|
|
pi._highest_parent_ = self
|
|
not_unique = []
|
|
sizes.append(p.size+sizes[-1])
|
|
self._param_slices_.append(slice(sizes[-2], sizes[-1]))
|
|
pname = adjust_name_for_printing(p.name)
|
|
# and makes sure to not delete programmatically added parameters
|
|
if pname in self.__dict__:
|
|
if isinstance(self.__dict__[pname], (Parameterized, Param)):
|
|
if not p is self.__dict__[pname]:
|
|
not_unique.append(pname)
|
|
del self.__dict__[pname]
|
|
elif not (pname in not_unique):
|
|
self.__dict__[pname] = p
|
|
self._added_names_.add(pname)
|
|
#===========================================================================
|
|
# Pickling operations
|
|
#===========================================================================
|
|
def pickle(self, f, protocol=-1):
|
|
"""
|
|
:param f: either filename or open file object to write to.
|
|
if it is an open buffer, you have to make sure to close
|
|
it properly.
|
|
:param protocol: pickling protocol to use, python-pickle for details.
|
|
"""
|
|
if isinstance(f, str):
|
|
with open(f, 'w') as f:
|
|
cPickle.dump(self, f, protocol)
|
|
else:
|
|
cPickle.dump(self, f, protocol)
|
|
def copy(self):
|
|
"""Returns a (deep) copy of the current model """
|
|
return copy.deepcopy(self)
|
|
def __getstate__(self):
|
|
if self._has_get_set_state():
|
|
return self.getstate()
|
|
return self.__dict__
|
|
def __setstate__(self, state):
|
|
if self._has_get_set_state():
|
|
self.setstate(state) # set state
|
|
#self._set_params(self._get_params()) # restore all values
|
|
return
|
|
self.__dict__ = state
|
|
def _has_get_set_state(self):
|
|
return 'getstate' in vars(self.__class__) and 'setstate' in vars(self.__class__)
|
|
def getstate(self):
|
|
"""
|
|
Get the current state of the class,
|
|
here just all the indices, rest can get recomputed
|
|
For inheriting from Parameterized:
|
|
|
|
Allways append the state of the inherited object
|
|
and call down to the inherited object in setstate!!
|
|
"""
|
|
return [
|
|
self._fixes_,
|
|
self._constraints_,
|
|
self._parameters_,
|
|
self._name,
|
|
#self.gradient_mapping,
|
|
self._added_names_,
|
|
]
|
|
|
|
def setstate(self, state):
|
|
self._added_names_ = state.pop()
|
|
#self.gradient_mapping = state.pop()
|
|
self._name = state.pop()
|
|
self._parameters_ = state.pop()
|
|
self._connect_parameters()
|
|
self._constraints_ = state.pop()
|
|
self._fixes_ = state.pop()
|
|
self.parameters_changed()
|
|
#===========================================================================
|
|
# Gradient control
|
|
#===========================================================================
|
|
def _transform_gradients(self, g):
|
|
if self.has_parent():
|
|
return g
|
|
x = self._get_params()
|
|
[numpy.put(g, i, g[i]*c.gradfactor(x[i])) for c,i in self.constraints.iteritems() if c != __fixed__]
|
|
for p in self.flattened_parameters:
|
|
for t,i in p._tied_to_me_.iteritems():
|
|
g[self._offset_for(p) + numpy.array(list(i))] += g[self._raveled_index_for(t)]
|
|
if self._has_fixes(): return g[self._fixes_]
|
|
return g
|
|
#===========================================================================
|
|
# Optimization handles:
|
|
#===========================================================================
|
|
def _get_param_names_transformed(self):
|
|
n = numpy.array([p.name_hirarchical+'['+str(i)+']' for p in self.flattened_parameters for i in p._indices()])
|
|
if self._has_fixes():
|
|
return n[self._fixes_]
|
|
return n
|
|
def _get_params(self):
|
|
# don't overwrite this anymore!
|
|
return numpy.hstack([x._get_params() for x in self._parameters_])
|
|
def _set_params(self, params, update=True):
|
|
# don't overwrite this anymore!
|
|
[p._set_params(params[s], update=update) for p,s in itertools.izip(self._parameters_,self._param_slices_)]
|
|
self.parameters_changed()
|
|
def _get_params_transformed(self):
|
|
# transformed parameters (apply transformation rules)
|
|
p = self._get_params()
|
|
[numpy.put(p, ind, c.finv(p[ind])) for c,ind in self.constraints.iteritems() if c != __fixed__]
|
|
if self._has_fixes():
|
|
return p[self._fixes_]
|
|
return p
|
|
def _set_params_transformed(self, p):
|
|
# inverse apply transformations for parameters and set the resulting parameters
|
|
p = p.copy()
|
|
if self._has_fixes(): tmp = self._get_params(); tmp[self._fixes_] = p; p = tmp; del tmp
|
|
[numpy.put(p, ind, c.f(p[ind])) for c,ind in self.constraints.iteritems() if c != __fixed__]
|
|
self._set_params(p)
|
|
def _name_changed(self, param, old_name):
|
|
if hasattr(self, old_name) and old_name in self._added_names_:
|
|
delattr(self, old_name)
|
|
self._added_names_.remove(old_name)
|
|
pname = adjust_name_for_printing(param.name)
|
|
if pname not in self.__dict__:
|
|
self._added_names_.add(pname)
|
|
self.__dict__[pname] = param
|
|
#===========================================================================
|
|
# Index Handling
|
|
#===========================================================================
|
|
def _backtranslate_index(self, param, ind):
|
|
# translate an index in parameterized indexing into the index of param
|
|
ind = ind-self._offset_for(param)
|
|
ind = ind[ind >= 0]
|
|
internal_offset = param._internal_offset()
|
|
ind = ind[ind < param.size + internal_offset]
|
|
return ind
|
|
def _offset_for(self, param):
|
|
# get the offset in the parameterized index array for param
|
|
if param.has_parent():
|
|
if param._direct_parent_._get_original(param) in self._parameters_:
|
|
return self._param_slices_[param._direct_parent_._get_original(param)._parent_index_].start
|
|
return self._offset_for(param._direct_parent_) + param._direct_parent_._offset_for(param)
|
|
return 0
|
|
|
|
def _raveled_index_for(self, param):
|
|
"""
|
|
get the raveled index for a param
|
|
that is an int array, containing the indexes for the flattened
|
|
param inside this parameterized logic.
|
|
"""
|
|
return param._raveled_index() + self._offset_for(param)
|
|
|
|
def _raveled_index(self):
|
|
"""
|
|
get the raveled index for this object,
|
|
this is not in the global view of things!
|
|
"""
|
|
return numpy.r_[:self.size]
|
|
#===========================================================================
|
|
# Handle ties:
|
|
#===========================================================================
|
|
def _set_fixed(self, param_or_index):
|
|
if not self._has_fixes(): self._fixes_ = numpy.ones(self.size, dtype=bool)
|
|
try:
|
|
param_or_index = self._raveled_index_for(param_or_index)
|
|
except AttributeError:
|
|
pass
|
|
self._fixes_[param_or_index] = FIXED
|
|
if numpy.all(self._fixes_): self._fixes_ = None # ==UNFIXED
|
|
def _set_unfixed(self, param_or_index):
|
|
if not self._has_fixes(): self._fixes_ = numpy.ones(self.size, dtype=bool)
|
|
try:
|
|
param_or_index = self._raveled_index_for(param_or_index)
|
|
except AttributeError:
|
|
pass
|
|
self._fixes_[param_or_index] = UNFIXED
|
|
for constr, ind in self.constraints.iteritems():
|
|
if constr is __fixed__:
|
|
self._fixes_[ind] = FIXED
|
|
if numpy.all(self._fixes_): self._fixes_ = None # ==UNFIXED
|
|
def _fixes_for(self, param):
|
|
if self._has_fixes():
|
|
return self._fixes_[self._raveled_index_for(param)]
|
|
return numpy.ones(self.size, dtype=bool)[self._raveled_index_for(param)]
|
|
#===========================================================================
|
|
# Fixing parameters:
|
|
#===========================================================================
|
|
def _fix(self, param, warning=True):
|
|
f = self._add_constrain(param, __fixed__, warning)
|
|
self._set_fixed(f)
|
|
def _unfix(self, param):
|
|
if self._has_fixes():
|
|
f = self._remove_constrain(param, __fixed__)
|
|
self._set_unfixed(f)
|
|
#===========================================================================
|
|
# Convenience for fixed, tied checking of param:
|
|
#===========================================================================
|
|
def _is_fixed(self, param):
|
|
# returns if the whole param is fixed
|
|
if not self._has_fixes():
|
|
return False
|
|
return not self._fixes_[self._raveled_index_for(param)].any()
|
|
#return not self._fixes_[self._offset_for(param): self._offset_for(param)+param._realsize_].any()
|
|
@property
|
|
def is_fixed(self):
|
|
for p in self._parameters_:
|
|
if not p.is_fixed: return False
|
|
return True
|
|
def _get_original(self, param):
|
|
# if advanced indexing is activated it happens that the array is a copy
|
|
# you can retrieve the original param through this method, by passing
|
|
# the copy here
|
|
return self._parameters_[param._parent_index_]
|
|
def hirarchy_name(self):
|
|
if self.has_parent():
|
|
return self._direct_parent_.hirarchy_name() + adjust_name_for_printing(self.name) + "."
|
|
return ''
|
|
#===========================================================================
|
|
# Constraint Handling:
|
|
#===========================================================================
|
|
def _add_constrain(self, param, transform, warning=True):
|
|
rav_i = self._raveled_index_for(param)
|
|
reconstrained = self._remove_constrain(param, index=rav_i) # remove constraints before
|
|
# if removing constraints before adding new is not wanted, just delete the above line!
|
|
self.constraints.add(transform, rav_i)
|
|
param = self._get_original(param)
|
|
param._set_params(transform.initialize(param._get_params()))
|
|
if warning and any(reconstrained):
|
|
# if you want to print the whole params object, which was reconstrained use:
|
|
# m = str(param[self._backtranslate_index(param, reconstrained)])
|
|
print "Warning: re-constraining parameters:\n{}".format(param._short())
|
|
return rav_i
|
|
def _remove_constrain(self, param, *transforms, **kwargs):
|
|
if not transforms:
|
|
transforms = self.constraints.properties()
|
|
removed_indices = numpy.array([]).astype(int)
|
|
if "index" in kwargs: index = kwargs['index']
|
|
else: index = self._raveled_index_for(param)
|
|
for constr in transforms:
|
|
removed = self.constraints.remove(constr, index)
|
|
if constr is __fixed__:
|
|
self._set_unfixed(removed)
|
|
removed_indices = numpy.union1d(removed_indices, removed)
|
|
return removed_indices
|
|
# convienience for iterating over items
|
|
def _constraints_iter_items(self, param):
|
|
for constr, ind in self.constraints.iteritems():
|
|
ind = self._backtranslate_index(param, ind)
|
|
if not index_empty(ind):
|
|
yield constr, ind
|
|
def _constraints_iter(self, param):
|
|
for constr, _ in self._constraints_iter_items(param):
|
|
yield constr
|
|
def _contraints_iter_indices(self, param):
|
|
# iterate through all constraints belonging to param
|
|
for _, ind in self._constraints_iter_items(param):
|
|
yield ind
|
|
def _constraint_indices(self, param, constraint):
|
|
# indices in model range for param and constraint
|
|
return self._backtranslate_index(param, self.constraints[constraint]) + self._offset_for(param)
|
|
def _constraints_for(self, param, rav_index):
|
|
# constraint for param given its internal rav_index
|
|
return self.constraints.properties_for(rav_index+self._offset_for(param))
|
|
def _constraints_for_collect(self, param, rav_index):
|
|
# constraint for param given its internal rav_index
|
|
cs = self._constraints_for(param, rav_index)
|
|
return set(itertools.chain(*cs))
|
|
#===========================================================================
|
|
# Get/set parameters:
|
|
#===========================================================================
|
|
def grep_param_names(self, regexp):
|
|
"""
|
|
create a list of parameters, matching regular expression regexp
|
|
"""
|
|
if not isinstance(regexp, _pattern_type): regexp = compile(regexp)
|
|
found_params = []
|
|
for p in self._parameters_:
|
|
if regexp.match(p.name) is not None:
|
|
found_params.append(p)
|
|
if isinstance(p, Parameterized):
|
|
found_params.extend(p.grep_param_names(regexp))
|
|
return found_params
|
|
return [param for param in self._parameters_ if regexp.match(param.name) is not None]
|
|
def __getitem__(self, name, paramlist=None):
|
|
if paramlist is None:
|
|
paramlist = self.grep_param_names(name)
|
|
if len(paramlist) < 1: raise AttributeError, name
|
|
if len(paramlist) == 1:
|
|
if isinstance(paramlist[-1], Parameterized):
|
|
paramlist = paramlist[-1].flattened_parameters
|
|
if len(paramlist) != 1:
|
|
return ParamConcatenation(paramlist)
|
|
return paramlist[-1]
|
|
return ParamConcatenation(paramlist)
|
|
def __setitem__(self, name, value, paramlist=None):
|
|
try: param = self.__getitem__(name, paramlist)
|
|
except AttributeError as a: raise a
|
|
param[:] = value
|
|
# def __getattr__(self, name):
|
|
# return self.__getitem__(name)
|
|
# def __getattribute__(self, name):
|
|
# #try:
|
|
# return object.__getattribute__(self, name)
|
|
#except AttributeError:
|
|
# _, a, tb = sys.exc_info()
|
|
# try:
|
|
# return self.__getitem__(name)
|
|
# except AttributeError:
|
|
# raise AttributeError, a.message, tb
|
|
def __setattr__(self, name, val):
|
|
# override the default behaviour, if setting a param, so broadcasting can by used
|
|
if hasattr(self, "_parameters_"):
|
|
paramlist = self.grep_param_names(name)
|
|
if len(paramlist) == 1: self.__setitem__(name, val, paramlist); return
|
|
object.__setattr__(self, name, val);
|
|
#===========================================================================
|
|
# Printing:
|
|
#===========================================================================
|
|
def _short(self):
|
|
# short string to print
|
|
if self.has_parent():
|
|
return self._direct_parent_.hirarchy_name() + adjust_name_for_printing(self.name)
|
|
else:
|
|
return adjust_name_for_printing(self.name)
|
|
def _parameter_names(self, add_name=False):
|
|
if add_name:
|
|
return [adjust_name_for_printing(self.name) + "." + xi for x in self._parameters_ for xi in x._parameter_names(add_name=True)]
|
|
return [xi for x in self._parameters_ for xi in x._parameter_names(add_name=True)]
|
|
parameter_names = property(_parameter_names, doc="Names for all parameters handled by this parameterization object -- will add hirarchy name entries for printing")
|
|
@property
|
|
def flattened_parameters(self):
|
|
return [xi for x in self._parameters_ for xi in x.flattened_parameters]
|
|
@property
|
|
def _parameter_sizes_(self):
|
|
return [x.size for x in self._parameters_]
|
|
@property
|
|
def size_transformed(self):
|
|
if self._has_fixes():
|
|
return sum(self._fixes_)
|
|
return self.size
|
|
@property
|
|
def parameter_shapes(self):
|
|
return [xi for x in self._parameters_ for xi in x.parameter_shapes]
|
|
@property
|
|
def _constraints_str(self):
|
|
return [cs for p in self._parameters_ for cs in p._constraints_str]
|
|
@property
|
|
def _description_str(self):
|
|
return [xi for x in self._parameters_ for xi in x._description_str]
|
|
@property
|
|
def _ties_str(self):
|
|
return [','.join(x._ties_str) for x in self.flattened_parameters]
|
|
def __str__(self, header=True):
|
|
|
|
name = adjust_name_for_printing(self.name) + "."
|
|
constrs = self._constraints_str; ts = self._ties_str
|
|
desc = self._description_str; names = self.parameter_names
|
|
nl = max([len(str(x)) for x in names + [name]])
|
|
sl = max([len(str(x)) for x in desc + ["Value"]])
|
|
cl = max([len(str(x)) if x else 0 for x in constrs + ["Constraint"]])
|
|
tl = max([len(str(x)) if x else 0 for x in ts + ["Tied to"]])
|
|
format_spec = " \033[1m{{name:<{0}s}}\033[0;0m | {{desc:^{1}s}} | {{const:^{2}s}} | {{t:^{3}s}}".format(nl, sl, cl, tl)
|
|
to_print = []
|
|
for n, d, c, t in itertools.izip(names, desc, constrs, ts):
|
|
to_print.append(format_spec.format(name=n, desc=d, const=c, t=t))
|
|
#to_print = [format_spec.format(p=p, const=c, t=t) if isinstance(p, Param) else p.__str__(header=False) for p, c, t in itertools.izip(self._parameters_, constrs, ts)]
|
|
sep = '-'*(nl+sl+cl+tl+8*2+3)
|
|
if header:
|
|
header = " {{0:<{0}s}} | {{1:^{1}s}} | {{2:^{2}s}} | {{3:^{3}s}}".format(nl, sl, cl, tl).format(name, "Value", "Constraint", "Tied to")
|
|
#header += '\n' + sep
|
|
to_print.insert(0, header)
|
|
return '\n'.format(sep).join(to_print)
|
|
pass
|
|
|
|
#
|
|
# class Parameterized_old(object):
|
|
# def __init__(self):
|
|
# """
|
|
# This is the base class for model and kernel. Mostly just handles tieing and constraining of parameters
|
|
# """
|
|
# self.tied_indices = []
|
|
# self.fixed_indices = []
|
|
# self.fixed_values = []
|
|
# self.constrained_indices = []
|
|
# self.constraints = []
|
|
#
|
|
# def _get_params(self):
|
|
# raise NotImplementedError, "this needs to be implemented to use the Parameterized class"
|
|
# def _set_params(self, x):
|
|
# raise NotImplementedError, "this needs to be implemented to use the Parameterized class"
|
|
#
|
|
# def _get_param_names(self):
|
|
# raise NotImplementedError, "this needs to be implemented to use the Parameterized class"
|
|
# #def _get_print_names(self):
|
|
# # """ Override for which parameter_names to print out, when using print m """
|
|
# # return self._get_param_names()
|
|
#
|
|
# def pickle(self, filename, protocol=None):
|
|
# if protocol is None:
|
|
# if self._has_get_set_state():
|
|
# protocol = 0
|
|
# else:
|
|
# protocol = -1
|
|
# with open(filename, 'w') as f:
|
|
# cPickle.dump(self, f, protocol)
|
|
#
|
|
# def copy(self):
|
|
# """Returns a (deep) copy of the current model """
|
|
# return copy.deepcopy(self)
|
|
#
|
|
# def __getstate__(self):
|
|
# if self._has_get_set_state():
|
|
# return self.getstate()
|
|
# return self.__dict__
|
|
#
|
|
# def __setstate__(self, state):
|
|
# if self._has_get_set_state():
|
|
# self.setstate(state) # set state
|
|
# self._set_params(self._get_params()) # restore all values
|
|
# return
|
|
# self.__dict__ = state
|
|
#
|
|
# def _has_get_set_state(self):
|
|
# return 'getstate' in vars(self.__class__) and 'setstate' in vars(self.__class__)
|
|
#
|
|
# def getstate(self):
|
|
# """
|
|
# Get the current state of the class,
|
|
# here just all the indices, rest can get recomputed
|
|
# For inheriting from Parameterized:
|
|
#
|
|
# Allways append the state of the inherited object
|
|
# and call down to the inherited object in setstate!!
|
|
# """
|
|
# return [self.tied_indices,
|
|
# self.fixed_indices,
|
|
# self.fixed_values,
|
|
# self.constrained_indices,
|
|
# self.constraints]
|
|
#
|
|
# def setstate(self, state):
|
|
# self.constraints = state.pop()
|
|
# self.constrained_indices = state.pop()
|
|
# self.fixed_values = state.pop()
|
|
# self.fixed_indices = state.pop()
|
|
# self.tied_indices = state.pop()
|
|
#
|
|
# def __getitem__(self, regexp, return_names=False):
|
|
# """
|
|
# Get a model param by name. The name is applied as a regular
|
|
# expression and all parameters that match that regular expression are
|
|
# returned.
|
|
# """
|
|
# matches = self.grep_param_names(regexp)
|
|
# if len(matches):
|
|
# if return_names:
|
|
# return self._get_params()[matches], np.asarray(self._get_param_names())[matches].tolist()
|
|
# else:
|
|
# return self._get_params()[matches]
|
|
# else:
|
|
# raise AttributeError, "no param matches %s" % regexp
|
|
#
|
|
# def __setitem__(self, name, val):
|
|
# """
|
|
# Set model param(s) by name. The name is provided as a regular
|
|
# expression. All parameters matching that regular expression are set to
|
|
# the given value.
|
|
# """
|
|
# matches = self.grep_param_names(name)
|
|
# if len(matches):
|
|
# val = np.array(val)
|
|
# assert (val.size == 1) or val.size == len(matches), "Shape mismatch: {}:({},)".format(val.size, len(matches))
|
|
# x = self._get_params()
|
|
# x[matches] = val
|
|
# self._set_params(x)
|
|
# else:
|
|
# raise AttributeError, "no param matches %s" % name
|
|
#
|
|
# def tie_params(self, regexp):
|
|
# """
|
|
# Tie (all!) parameters matching the regular expression `regexp`.
|
|
# """
|
|
# matches = self.grep_param_names(regexp)
|
|
# assert matches.size > 0, "need at least something to tie together"
|
|
# if len(self.tied_indices):
|
|
# assert not np.any(matches[:, None] == np.hstack(self.tied_indices)), "Some indices are already tied!"
|
|
# self.tied_indices.append(matches)
|
|
# # TODO only one of the priors will be evaluated. Give a warning message if the priors are not identical
|
|
# if hasattr(self, 'prior'):
|
|
# pass
|
|
#
|
|
# self._set_params_transformed(self._get_params_transformed()) # sets tied parameters to single value
|
|
#
|
|
# def untie_everything(self):
|
|
# """Unties all parameters by setting tied_indices to an empty list."""
|
|
# self.tied_indices = []
|
|
#
|
|
# def grep_param_names(self, regexp, transformed=False, search=False):
|
|
# """
|
|
# :param regexp: regular expression to select param parameter_names
|
|
# :type regexp: re | str | int
|
|
# :rtype: the indices of self._get_param_names which match the regular expression.
|
|
#
|
|
# Note:-
|
|
# Other objects are passed through - i.e. integers which weren't meant for grepping
|
|
# """
|
|
#
|
|
# if transformed:
|
|
# parameter_names = self._get_param_names_transformed()
|
|
# else:
|
|
# parameter_names = self._get_param_names()
|
|
#
|
|
# if type(regexp) in [str, np.string_, np.str]:
|
|
# regexp = re.compile(regexp)
|
|
# elif type(regexp) is re._pattern_type:
|
|
# pass
|
|
# else:
|
|
# return regexp
|
|
# if search:
|
|
# return np.nonzero([regexp.search(name) for name in parameter_names])[0]
|
|
# else:
|
|
# return np.nonzero([regexp.match(name) for name in parameter_names])[0]
|
|
#
|
|
# def num_params_transformed(self):
|
|
# removed = 0
|
|
# for tie in self.tied_indices:
|
|
# removed += tie.size - 1
|
|
#
|
|
# for fix in self.fixed_indices:
|
|
# removed += fix.size
|
|
#
|
|
# return len(self._get_params()) - removed
|
|
#
|
|
# def unconstrain(self, regexp):
|
|
# """Unconstrain matching parameters. Does not untie parameters"""
|
|
# matches = self.grep_param_names(regexp)
|
|
#
|
|
# # tranformed contraints:
|
|
# for match in matches:
|
|
# self.constrained_indices = [i[i <> match] for i in self.constrained_indices]
|
|
#
|
|
# # remove empty constraints
|
|
# tmp = zip(*[(i, t) for i, t in zip(self.constrained_indices, self.constraints) if len(i)])
|
|
# if tmp:
|
|
# self.constrained_indices, self.constraints = zip(*[(i, t) for i, t in zip(self.constrained_indices, self.constraints) if len(i)])
|
|
# self.constrained_indices, self.constraints = list(self.constrained_indices), list(self.constraints)
|
|
#
|
|
# # fixed:
|
|
# self.fixed_values = [np.delete(values, np.nonzero(np.sum(indices[:, None] == matches[None, :], 1))[0]) for indices, values in zip(self.fixed_indices, self.fixed_values)]
|
|
# self.fixed_indices = [np.delete(indices, np.nonzero(np.sum(indices[:, None] == matches[None, :], 1))[0]) for indices in self.fixed_indices]
|
|
#
|
|
# # remove empty elements
|
|
# tmp = [(i, v) for i, v in zip(self.fixed_indices, self.fixed_values) if len(i)]
|
|
# if tmp:
|
|
# self.fixed_indices, self.fixed_values = zip(*tmp)
|
|
# self.fixed_indices, self.fixed_values = list(self.fixed_indices), list(self.fixed_values)
|
|
# else:
|
|
# self.fixed_indices, self.fixed_values = [], []
|
|
#
|
|
# def constrain_negative(self, regexp, warning=True):
|
|
# """ Set negative constraints. """
|
|
# self.constrain(regexp, transformations.NegativeLogexp(), warning)
|
|
#
|
|
# def constrain_positive(self, regexp, warning=True):
|
|
# """ Set positive constraints. """
|
|
# self.constrain(regexp, transformations.Logexp(), warning)
|
|
#
|
|
# def constrain_bounded(self, regexp, lower, upper, warning=True):
|
|
# """ Set bounded constraints. """
|
|
# self.constrain(regexp, transformations.Logistic(lower, upper), warning)
|
|
#
|
|
# def all_constrained_indices(self):
|
|
# if len(self.constrained_indices) or len(self.fixed_indices):
|
|
# return np.hstack(self.constrained_indices + self.fixed_indices)
|
|
# else:
|
|
# return np.empty(shape=(0,))
|
|
#
|
|
# def constrain(self, regexp, transform, warning=True):
|
|
# assert isinstance(transform, transformations.Transformation)
|
|
#
|
|
# matches = self.grep_param_names(regexp)
|
|
# overlap = set(matches).intersection(set(self.all_constrained_indices()))
|
|
# if overlap:
|
|
# self.unconstrain(np.asarray(list(overlap)))
|
|
# if warning:
|
|
# print 'Warning: re-constraining these parameters'
|
|
# pn = self._get_param_names()
|
|
# for i in overlap:
|
|
# print pn[i]
|
|
#
|
|
# self.constrained_indices.append(matches)
|
|
# self.constraints.append(transform)
|
|
# x = self._get_params()
|
|
# x[matches] = transform.initialize(x[matches])
|
|
# self._set_params(x)
|
|
#
|
|
# def constrain_fixed(self, regexp, value=None, warning=True):
|
|
# """
|
|
#
|
|
# :param regexp: which parameters need to be fixed.
|
|
# :type regexp: ndarray(dtype=int) or regular expression object or string
|
|
# :param value: the vlaue to fix the parameters to. If the value is not specified,
|
|
# the param is fixed to the current value
|
|
# :type value: float
|
|
#
|
|
# **Notes**
|
|
#
|
|
# Fixing a param which is tied to another, or constrained in some way will result in an error.
|
|
#
|
|
# To fix multiple parameters to the same value, simply pass a regular expression which matches both param parameter_names, or pass both of the indexes.
|
|
#
|
|
# """
|
|
# matches = self.grep_param_names(regexp)
|
|
# overlap = set(matches).intersection(set(self.all_constrained_indices()))
|
|
# if overlap:
|
|
# self.unconstrain(np.asarray(list(overlap)))
|
|
# if warning:
|
|
# print 'Warning: re-constraining these parameters'
|
|
# pn = self._get_param_names()
|
|
# for i in overlap:
|
|
# print pn[i]
|
|
#
|
|
# self.fixed_indices.append(matches)
|
|
# if value != None:
|
|
# self.fixed_values.append(value)
|
|
# else:
|
|
# self.fixed_values.append(self._get_params()[self.fixed_indices[-1]])
|
|
#
|
|
# # self.fixed_values.append(value)
|
|
# self._set_params_transformed(self._get_params_transformed())
|
|
#
|
|
# def _get_params_transformed(self):
|
|
# """use self._get_params to get the 'true' parameters of the model, which are then tied, constrained and fixed"""
|
|
# x = self._get_params()
|
|
# [np.put(x, i, t.finv(x[i])) for i, t in zip(self.constrained_indices, self.constraints)]
|
|
#
|
|
# to_remove = self.fixed_indices + [t[1:] for t in self.tied_indices]
|
|
# if len(to_remove):
|
|
# return np.delete(x, np.hstack(to_remove))
|
|
# else:
|
|
# return x
|
|
#
|
|
# def _set_params_transformed(self, x):
|
|
# """ takes the vector x, which is then modified (by untying, reparameterising or inserting fixed values), and then call self._set_params"""
|
|
# self._set_params(self._untransform_params(x))
|
|
#
|
|
# def _untransform_params(self, x):
|
|
# """
|
|
# The Transformation required for _set_params_transformed.
|
|
#
|
|
# This moves the vector x seen by the optimiser (unconstrained) to the
|
|
# valid param vector seen by the model
|
|
#
|
|
# Note:
|
|
# - This function is separate from _set_params_transformed for downstream flexibility
|
|
# """
|
|
# # work out how many places are fixed, and where they are. tricky logic!
|
|
# fix_places = self.fixed_indices + [t[1:] for t in self.tied_indices]
|
|
# if len(fix_places):
|
|
# fix_places = np.hstack(fix_places)
|
|
# Nfix_places = fix_places.size
|
|
# else:
|
|
# Nfix_places = 0
|
|
#
|
|
# free_places = np.setdiff1d(np.arange(Nfix_places + x.size, dtype=np.int), fix_places)
|
|
#
|
|
# # put the models values in the vector xx
|
|
# xx = np.zeros(Nfix_places + free_places.size, dtype=np.float64)
|
|
#
|
|
# xx[free_places] = x
|
|
# [np.put(xx, i, v) for i, v in zip(self.fixed_indices, self.fixed_values)]
|
|
# [np.put(xx, i, v) for i, v in [(t[1:], xx[t[0]]) for t in self.tied_indices] ]
|
|
#
|
|
# [np.put(xx, i, t.f(xx[i])) for i, t in zip(self.constrained_indices, self.constraints)]
|
|
# if hasattr(self, 'debug'):
|
|
# stop # @UndefinedVariable
|
|
#
|
|
# return xx
|
|
#
|
|
# def _get_param_names_transformed(self):
|
|
# """
|
|
# Returns the param parameter_names as propagated after constraining,
|
|
# tying or fixing, i.e. a list of the same length as _get_params_transformed()
|
|
# """
|
|
# n = self._get_param_names()
|
|
#
|
|
# # remove/concatenate the tied param parameter_names
|
|
# if len(self.tied_indices):
|
|
# for t in self.tied_indices:
|
|
# n[t[0]] = "<tie>".join([n[tt] for tt in t])
|
|
# remove = np.hstack([t[1:] for t in self.tied_indices])
|
|
# else:
|
|
# remove = np.empty(shape=(0,), dtype=np.int)
|
|
#
|
|
# # also remove the fixed params
|
|
# if len(self.fixed_indices):
|
|
# remove = np.hstack((remove, np.hstack(self.fixed_indices)))
|
|
#
|
|
# # add markers to show that some variables are constrained
|
|
# for i, t in zip(self.constrained_indices, self.constraints):
|
|
# for ii in i:
|
|
# n[ii] = n[ii] + t.__str__()
|
|
#
|
|
# n = [nn for i, nn in enumerate(n) if not i in remove]
|
|
# return n
|
|
#
|
|
# #@property
|
|
# #def all(self):
|
|
# # return self.__str__(self._get_param_names())
|
|
#
|
|
#
|
|
# #def __str__(self, parameter_names=None, nw=30):
|
|
# def __str__(self, nw=30):
|
|
# """
|
|
# Return a string describing the param parameter_names and their ties and constraints
|
|
# """
|
|
# parameter_names = self._get_param_names()
|
|
# #if parameter_names is None:
|
|
# # parameter_names = self._get_print_names()
|
|
# #name_indices = self.grep_param_names("|".join(parameter_names))
|
|
# N = len(parameter_names)
|
|
#
|
|
# if not N:
|
|
# return "This object has no free parameters."
|
|
# header = ['Name', 'Value', 'Constraints', 'Ties']
|
|
# values = self._get_params() # map(str,self._get_params())
|
|
# #values = self._get_params()[name_indices] # map(str,self._get_params())
|
|
# # sort out the constraints
|
|
# constraints = [''] * len(parameter_names)
|
|
# #constraints = [''] * len(self._get_param_names())
|
|
# for i, t in zip(self.constrained_indices, self.constraints):
|
|
# for ii in i:
|
|
# constraints[ii] = t.__str__()
|
|
# for i in self.fixed_indices:
|
|
# for ii in i:
|
|
# constraints[ii] = 'Fixed'
|
|
# # sort out the ties
|
|
# ties = [''] * len(parameter_names)
|
|
# for i, tie in enumerate(self.tied_indices):
|
|
# for j in tie:
|
|
# ties[j] = '(' + str(i) + ')'
|
|
#
|
|
# if values.size == 1:
|
|
# values = ['%.4f' %float(values)]
|
|
# else:
|
|
# values = ['%.4f' % float(v) for v in values]
|
|
# max_names = max([len(parameter_names[i]) for i in range(len(parameter_names))] + [len(header[0])])
|
|
# max_values = max([len(values[i]) for i in range(len(values))] + [len(header[1])])
|
|
# max_constraint = max([len(constraints[i]) for i in range(len(constraints))] + [len(header[2])])
|
|
# max_ties = max([len(ties[i]) for i in range(len(ties))] + [len(header[3])])
|
|
# cols = np.array([max_names, max_values, max_constraint, max_ties]) + 4
|
|
# # columns = cols.sum()
|
|
#
|
|
# header_string = ["{h:^{col}}".format(h=header[i], col=cols[i]) for i in range(len(cols))]
|
|
# header_string = map(lambda x: '|'.join(x), [header_string])
|
|
# separator = '-' * len(header_string[0])
|
|
# param_string = ["{n:^{c0}}|{v:^{c1}}|{c:^{c2}}|{t:^{c3}}".format(n=parameter_names[i], v=values[i], c=constraints[i], t=ties[i], c0=cols[0], c1=cols[1], c2=cols[2], c3=cols[3]) for i in range(len(values))]
|
|
#
|
|
#
|
|
# return ('\n'.join([header_string[0], separator] + param_string)) + '\n'
|
|
#
|
|
# def grep_model(self,regexp):
|
|
# regexp_indices = self.grep_param_names(regexp)
|
|
# all_names = self._get_param_names()
|
|
#
|
|
# parameter_names = [all_names[pj] for pj in regexp_indices]
|
|
# N = len(parameter_names)
|
|
#
|
|
# if not N:
|
|
# return "Match not found."
|
|
#
|
|
# header = ['Name', 'Value', 'Constraints', 'Ties']
|
|
# all_values = self._get_params()
|
|
# values = np.array([all_values[pj] for pj in regexp_indices])
|
|
# constraints = [''] * len(parameter_names)
|
|
#
|
|
# _constrained_indices,aux = self._pick_elements(regexp_indices,self.constrained_indices)
|
|
# _constraints_ = [self.constraints[pj] for pj in aux]
|
|
#
|
|
# for i, t in zip(_constrained_indices, _constraints_):
|
|
# for ii in i:
|
|
# iii = regexp_indices.tolist().index(ii)
|
|
# constraints[iii] = t.__str__()
|
|
#
|
|
# _fixed_indices,aux = self._pick_elements(regexp_indices,self.fixed_indices)
|
|
# for i in _fixed_indices:
|
|
# for ii in i:
|
|
# iii = regexp_indices.tolist().index(ii)
|
|
# constraints[ii] = 'Fixed'
|
|
#
|
|
# _tied_indices,aux = self._pick_elements(regexp_indices,self.tied_indices)
|
|
# ties = [''] * len(parameter_names)
|
|
# for i,ti in zip(_tied_indices,aux):
|
|
# for ii in i:
|
|
# iii = regexp_indices.tolist().index(ii)
|
|
# ties[iii] = '(' + str(ti) + ')'
|
|
#
|
|
# if values.size == 1:
|
|
# values = ['%.4f' %float(values)]
|
|
# else:
|
|
# values = ['%.4f' % float(v) for v in values]
|
|
#
|
|
# max_names = max([len(parameter_names[i]) for i in range(len(parameter_names))] + [len(header[0])])
|
|
# max_values = max([len(values[i]) for i in range(len(values))] + [len(header[1])])
|
|
# max_constraint = max([len(constraints[i]) for i in range(len(constraints))] + [len(header[2])])
|
|
# max_ties = max([len(ties[i]) for i in range(len(ties))] + [len(header[3])])
|
|
# cols = np.array([max_names, max_values, max_constraint, max_ties]) + 4
|
|
#
|
|
# header_string = ["{h:^{col}}".format(h=header[i], col=cols[i]) for i in range(len(cols))]
|
|
# header_string = map(lambda x: '|'.join(x), [header_string])
|
|
# separator = '-' * len(header_string[0])
|
|
# param_string = ["{n:^{c0}}|{v:^{c1}}|{c:^{c2}}|{t:^{c3}}".format(n=parameter_names[i], v=values[i], c=constraints[i], t=ties[i], c0=cols[0], c1=cols[1], c2=cols[2], c3=cols[3]) for i in range(len(values))]
|
|
#
|
|
# print header_string[0]
|
|
# print separator
|
|
# for string in param_string:
|
|
# print string
|
|
#
|
|
# def _pick_elements(self,regexp_ind,array_list):
|
|
# """Removes from array_list the elements different from regexp_ind"""
|
|
# new_array_list = [] #New list with elements matching regexp_ind
|
|
# array_indices = [] #Indices that matches the arrays in new_array_list and array_list
|
|
#
|
|
# array_index = 0
|
|
# for array in array_list:
|
|
# _new = []
|
|
# for ai in array:
|
|
# if ai in regexp_ind:
|
|
# _new.append(ai)
|
|
# if len(_new):
|
|
# new_array_list.append(np.array(_new))
|
|
# array_indices.append(array_index)
|
|
# array_index += 1
|
|
# return new_array_list, array_indices
|