MaskedMappingProjection¶
Contents¶
Overview¶
A MaskedMappingProjection is a subclass of MappingProjection that applies a specified mask array
(either additively, multiplicatively, or exponentially) to the MappingProjection’s matrix
each time the MappingProjection is executed. The mask is assigned a ParameterPort and can thus be modulated
by a ControlMechanism.
Creating a MaskedMappingProjection¶
A MaskedMappingProjection is created in the same way as a MappingProjection, with the exception that its constructor
includes mask and mask_operation arguments that can be used to configure the mask and how it is applied to the
Projection’s matrix. The mask attribute must be an array that has the same
shape as the matrix attribute, and the mask_operation argument must be the
keyword ADD, MULTIPLY, or EXPONENTIATE (see Execution below).
Structure¶
A MaskedMappingProjection is identical to a MappingProjection, with the addition of mask and mask_operation attributes.
Execution¶
A MaskedMappingProjection executes in the same manner as a MappingProjection, with the exception that,
each time the Projection is executed, its mask is applied to its matrix parameter as specified by its mask_operation attribute, before generating the Projection’s value.
Class Reference¶
- class psyneulink.library.components.projections.pathway.maskedmappingprojection.MaskedMappingProjection(sender=None, receiver=None, matrix=None, mask=None, mask_operation=None, function=None, params=None, name=None, prefs=None, **kwargs)¶
Subclass of MappingProjection, the
matrixof which can be masked on each execution. See MappingProjection for additional arguments and attributes.- Parameters:
mask (int, float, list, np.ndarray : default None) – specifies a mask to be applied to the
matrixeach time the Projection is executed, in a manner specified by the mask_operation argument.mask_operation (ADD, MULTIPLY, or EXPONENTIATE : default MULTIPLY) – specifies the manner in which the
maskis applied to thematrixeach time the Projection is executed.
- mask¶
mask applied to the
matrixeach time the Projection is executed, in a manner specified bymask_operation.mask_operation : ADD, MULTIPLY, or EXPONENTIATE : default MULTIPLY determines the manner in which the
maskis applied to thematrixwhen the Projection is executed.- Type:
int, float, list, np.ndarray : default None
- _validate_params(request_set, target_set=None, context=None)¶
Validate mask argument
- exception psyneulink.library.components.projections.pathway.maskedmappingprojection.MaskedMappingProjectionError(message, component=None)¶