source: sasmodels/sasmodels/mixture.py @ 6dccecc

ticket-1257-vesicle-productticket_1156ticket_822_more_unit_tests
Last change on this file since 6dccecc was b297ba9, checked in by Paul Kienzle <pkienzle@…>, 5 years ago

lint

  • Property mode set to 100644
File size: 12.9 KB
Line 
1"""
2Mixture model
3-------------
4
5The product model multiplies the structure factor by the form factor,
6modulated by the effective radius of the form.  The resulting model
7has a attributes of both the model description (with parameters, etc.)
8and the module evaluator (with call, release, etc.).
9
10To use it, first load form factor P and structure factor S, then create
11*ProductModel(P, S)*.
12"""
13from __future__ import print_function
14
15from copy import copy
16import numpy as np  # type: ignore
17
18from .modelinfo import Parameter, ParameterTable, ModelInfo
19from .kernel import KernelModel, Kernel
20from .details import make_details
21
22# pylint: disable=unused-import
23try:
24    from typing import List
25except ImportError:
26    pass
27# pylint: enable=unused-import
28
29def make_mixture_info(parts, operation='+'):
30    # type: (List[ModelInfo]) -> ModelInfo
31    """
32    Create info block for mixture model.
33    """
34    # Build new parameter list
35    combined_pars = []
36
37    all_parts = copy(parts)
38    is_flat = False
39    while not is_flat:
40        is_flat = True
41        for part in all_parts:
42            if part.composition and part.composition[0] == 'mixture' and \
43                len(part.composition[1]) > 1:
44                all_parts += part.composition[1]
45                all_parts.remove(part)
46                is_flat = False
47
48    # When creating a mixture model that is a sum of product models (ie (1*2)+(3*4))
49    # the parameters for models 1 & 2 will be prefixed with A & B respectively,
50    # but so will the parameters for models 3 & 4. We need to rename models 3 & 4
51    # so that they are prefixed with C & D to avoid overlap of parameter names.
52    used_prefixes = []
53    for part in parts:
54        i = 0
55        if part.composition and part.composition[0] == 'mixture':
56            npars_list = [info.parameters.npars for info in part.composition[1]]
57            for npars in npars_list:
58                # List of params of one of the constituent models of part
59                submodel_pars = part.parameters.kernel_parameters[i:i+npars]
60                # Prefix of the constituent model
61                prefix = submodel_pars[0].name[0]
62                if prefix not in used_prefixes: # Haven't seen this prefix so far
63                    used_prefixes.append(prefix)
64                    i += npars
65                    continue
66                while prefix in used_prefixes:
67                    # This prefix has been already used, so change it to the
68                    # next letter that hasn't been used
69                    prefix = chr(ord(prefix) + 1)
70                used_prefixes.append(prefix)
71                prefix += "_"
72                # Update the parameters of this constituent model to use the
73                # new prefix
74                for par in submodel_pars:
75                    par.id = prefix + par.id[2:]
76                    par.name = prefix + par.name[2:]
77                    if par.length_control is not None:
78                        par.length_control = prefix + par.length_control[2:]
79                i += npars
80
81    for part in parts:
82        # Parameter prefix per model, A_, B_, ...
83        # Note that prefix must also be applied to id and length_control
84        # to support vector parameters
85        prefix = ''
86        if not part.composition:
87            # Model isn't a composition model, so it's parameters don't have a
88            # a prefix. Add the next available prefix
89            prefix = chr(ord('A')+len(used_prefixes))
90            used_prefixes.append(prefix)
91            prefix += '_'
92
93        if operation == '+':
94            # If model is a sum model, each constituent model gets its own scale parameter
95            scale_prefix = prefix
96            if prefix == '' and getattr(part, "operation", '') == '*':
97                # `part` is a composition product model. Find the prefixes of
98                # it's parameters to form a new prefix for the scale.
99                # For example, a model with A*B*C will have ABC_scale.
100                sub_prefixes = []
101                for param in part.parameters.kernel_parameters:
102                    # Prefix of constituent model
103                    sub_prefix = param.id.split('_')[0]
104                    if sub_prefix not in sub_prefixes:
105                        sub_prefixes.append(sub_prefix)
106                # Concatenate sub_prefixes to form prefix for the scale
107                scale_prefix = ''.join(sub_prefixes) + '_'
108            scale = Parameter(scale_prefix + 'scale', default=1.0,
109                              description="model intensity for " + part.name)
110            combined_pars.append(scale)
111        for p in part.parameters.kernel_parameters:
112            p = copy(p)
113            p.name = prefix + p.name
114            p.id = prefix + p.id
115            if p.length_control is not None:
116                p.length_control = prefix + p.length_control
117            combined_pars.append(p)
118    parameters = ParameterTable(combined_pars)
119    parameters.max_pd = sum(part.parameters.max_pd for part in parts)
120
121    def random():
122        """Random set of model parameters for mixture model"""
123        combined_pars = {}
124        for k, part in enumerate(parts):
125            prefix = chr(ord('A')+k) + '_'
126            pars = part.random()
127            combined_pars.update((prefix+k, v) for k, v in pars.items())
128        return combined_pars
129
130    model_info = ModelInfo()
131    model_info.id = operation.join(part.id for part in parts)
132    model_info.operation = operation
133    model_info.name = '(' + operation.join(part.name for part in parts) + ')'
134    model_info.filename = None
135    model_info.title = 'Mixture model with ' + model_info.name
136    model_info.description = model_info.title
137    model_info.docs = model_info.title
138    model_info.category = "custom"
139    model_info.parameters = parameters
140    model_info.random = random
141    #model_info.single = any(part['single'] for part in parts)
142    model_info.structure_factor = False
143    model_info.variant_info = None
144    #model_info.tests = []
145    #model_info.source = []
146    # Remember the component info blocks so we can build the model
147    model_info.composition = ('mixture', parts)
148    return model_info
149
150
151class MixtureModel(KernelModel):
152    """
153    Model definition for mixture of models.
154    """
155    def __init__(self, model_info, parts):
156        # type: (ModelInfo, List[KernelModel]) -> None
157        self.info = model_info
158        self.parts = parts
159        self.dtype = parts[0].dtype
160
161    def make_kernel(self, q_vectors):
162        # type: (List[np.ndarray]) -> MixtureKernel
163        # Note: may be sending the q_vectors to the n times even though they
164        # are only needed once.  It would mess up modularity quite a bit to
165        # handle this optimally, especially since there are many cases where
166        # separate q vectors are needed (e.g., form in python and structure
167        # in opencl; or both in opencl, but one in single precision and the
168        # other in double precision).
169        kernels = [part.make_kernel(q_vectors) for part in self.parts]
170        return MixtureKernel(self.info, kernels)
171    make_kernel.__doc__ = KernelModel.make_kernel.__doc__
172
173    def release(self):
174        # type: () -> None
175        """Free resources associated with the model."""
176        for part in self.parts:
177            part.release()
178    release.__doc__ = KernelModel.release.__doc__
179
180
181class MixtureKernel(Kernel):
182    """
183    Instantiated kernel for mixture of models.
184    """
185    def __init__(self, model_info, kernels):
186        # type: (ModelInfo, List[Kernel]) -> None
187        self.dim = kernels[0].dim
188        self.info = model_info
189        self.kernels = kernels
190        self.dtype = self.kernels[0].dtype
191        self.operation = model_info.operation
192        self.results = []  # type: List[np.ndarray]
193
194    def Iq(self, call_details, values, cutoff, magnetic):
195        # type: (CallDetails, np.ndarray, np.ndarry, float, bool) -> np.ndarray
196        scale, background = values[0:2]
197        total = 0.0
198        # remember the parts for plotting later
199        self.results = []  # type: List[np.ndarray]
200        parts = _MixtureParts(self.info, self.kernels, call_details, values)
201        for kernel, kernel_details, kernel_values in parts:
202            #print("calling kernel", kernel.info.name)
203            result = kernel(kernel_details, kernel_values, cutoff, magnetic)
204            result = np.array(result).astype(kernel.dtype)
205            # print(kernel.info.name, result)
206            if self.operation == '+':
207                total += result
208            elif self.operation == '*':
209                if np.all(total) == 0.0:
210                    total = result
211                else:
212                    total *= result
213            self.results.append(result)
214
215        return scale*total + background
216
217    Iq.__doc__ = Kernel.Iq.__doc__
218    __call__ = Iq
219
220    def release(self):
221        # type: () -> None
222        """Free resources associated with the kernel."""
223        for k in self.kernels:
224            k.release()
225
226
227# Note: _MixtureParts doesn't implement iteration correctly, and only allows
228# a single iterator to be active at once.  It doesn't matter in this case
229# since _MixtureParts is only used in one place, but it is not clean style.
230class _MixtureParts(object):
231    """
232    Mixture component iterator.
233    """
234    def __init__(self, model_info, kernels, call_details, values):
235        # type: (ModelInfo, List[Kernel], CallDetails, np.ndarray) -> None
236        self.model_info = model_info
237        self.parts = model_info.composition[1]
238        self.kernels = kernels
239        self.call_details = call_details
240        self.values = values
241        self.spin_index = model_info.parameters.npars + 2
242        # The following are redefined by __iter__, but set them here so that
243        # lint complains a little less.
244        self.part_num = -1
245        self.par_index = -1
246        self.mag_index = -1
247        #call_details.show(values)
248
249    def __iter__(self):
250        # type: () -> PartIterable
251        self.part_num = 0
252        self.par_index = 2
253        self.mag_index = self.spin_index + 3
254        return self
255
256    def __next__(self):
257        # type: () -> Tuple[List[Callable], CallDetails, np.ndarray]
258        if self.part_num >= len(self.parts):
259            raise StopIteration()
260        info = self.parts[self.part_num]
261        kernel = self.kernels[self.part_num]
262        call_details = self._part_details(info, self.par_index)
263        values = self._part_values(info, self.par_index, self.mag_index)
264        values = values.astype(kernel.dtype)
265        #call_details.show(values)
266
267        self.part_num += 1
268        self.par_index += info.parameters.npars
269        if self.model_info.operation == '+':
270            self.par_index += 1 # Account for each constituent model's scale param
271        self.mag_index += 3 * len(info.parameters.magnetism_index)
272
273        return kernel, call_details, values
274
275    # CRUFT: py2 support
276    next = __next__
277
278    def _part_details(self, info, par_index):
279        # type: (ModelInfo, int) -> CallDetails
280        full = self.call_details
281        # par_index is index into values array of the current parameter,
282        # which includes the initial scale and background parameters.
283        # We want the index into the weight length/offset for each parameter.
284        # Exclude the initial scale and background, so subtract two. If we're
285        # building an addition model, each component has its own scale factor
286        # which we need to skip when constructing the details for the kernel, so
287        # add one, giving a net subtract one.
288        diff = 1 if self.model_info.operation == '+' else 2
289        index = slice(par_index - diff, par_index - diff + info.parameters.npars)
290        length = full.length[index]
291        offset = full.offset[index]
292        # The complete weight vector is being sent to each part so that
293        # offsets don't need to be adjusted.
294        part = make_details(info, length, offset, full.num_weights)
295        return part
296
297    def _part_values(self, info, par_index, mag_index):
298        # type: (ModelInfo, int, int) -> np.ndarray
299        # Set each constituent model's scale to 1 if this is a multiplication model
300        scale = self.values[par_index] if self.model_info.operation == '+' else 1.0
301        diff = 1 if self.model_info.operation == '+' else 0 # Skip scale if addition model
302        pars = self.values[par_index + diff:par_index + info.parameters.npars + diff]
303        nmagnetic = len(info.parameters.magnetism_index)
304        if nmagnetic:
305            spin_state = self.values[self.spin_index:self.spin_index + 3]
306            mag_index = self.values[mag_index:mag_index + 3 * nmagnetic]
307        else:
308            spin_state = []
309            mag_index = []
310        nvalues = self.model_info.parameters.nvalues
311        nweights = self.call_details.num_weights
312        weights = self.values[nvalues:nvalues+2*nweights]
313        zero = self.values.dtype.type(0.)
314        values = [[scale, zero], pars, spin_state, mag_index, weights]
315        # Pad value array to a 32 value boundary
316        spacer = (32 - sum(len(v) for v in values)%32)%32
317        values.append([zero]*spacer)
318        values = np.hstack(values).astype(self.kernels[0].dtype)
319        return values
Note: See TracBrowser for help on using the repository browser.