Class ElementArrayStim

:Parameters:

    win :
        a :class:`~psychopy.visual.Window` object (required)
                         
    units : **None**, 'norm', 'cm', 'deg' or 'pix'  
        If None then the current units of the :class:`~psychopy.visual.Window` will be used. 
        See :ref:`units` for explanation of other options.
    
    fieldPos : 
        The centre of the array of elements
                        
    fieldSize : 
        The size of the array of elements (this will be overridden by setting explicit xy positions for the elements)
    
    fieldShape : 
        The shape of the array ('circle' or 'sqr')        
    
    nElements : 
        number of elements in the array     
       
    sizes : 
        an array of sizes Nx1, Nx2 or a single value      
      
    xys : 
        the xy positions of the elements, relative to the field centre (fieldPos)   
         
    rgbs : 
        specifying the color(s) of the elements. 
        Should be Nx1 (different greys), Nx3 (different colors) or 1x3 (for a single color)
    
    opacities : 
        the opacity of each element (Nx1 or a single value)
    
    depths : 
        the depths of the elements (Nx1), relative the overall depth of the field (fieldDepth)
    
    fieldDepth : 
        the depth of the field (will be added to the depths of the elements)
    
    oris : 
        the orientations of the elements (Nx1 or a single value)
    
    sfs : 
        the spatial frequencies of the elements (Nx1, Nx2 or a single value)
    
    contrs : 
        the contrasts of the elements, ranging -1 to +1 (Nx1 or a single value)
    
    phases : 
        the spatial phase of the texture on the stimulus (Nx1 or a single value)
    
    elementTex : 
        the texture, to be used by all elements (e.g. 'sin', 'sqr',.. , 'myTexture.tif', numpy.ones([48,48]))
    
    elementMask : 
        the mask, to be used by all elements (e.g. 'circle', 'gauss',.. , 'myTexture.tif', numpy.ones([48,48]))
    
    texRes : 
        the number of pixels in the textures (overridden if an array or image is provided)                       

Set the xy values of the element centres (relative to the centre of the field). Values should be:

• None
• an array/list of Nx2 coordinates.

If value is None then the xy positions will be generated automatically, based on the fieldSize and fieldPos. In this case opacity will also be overridden by this function (it is used to make elements outside the field invisible.

Set the spatial frequency for each element. Should either be:

• a single value
• an Nx1 array/list
• an Nx2 array/list (spatial frequency of the element in X and Y).

If the units for the stimulus are 'pix' or 'norm' then the units of sf are cycles per stimulus width. For units of 'deg' or 'cm' the units are c/cm or c/deg respectively.

Set the size for each element. Should either be:

• a single value
• an Nx1 array/list
• an Nx2 array/list

Set the phase for each element. Should either be:

• a single value
• an Nx1 array/list
• an Nx2 array/list (for separate X and Y phase)

Set the rgb for each element. Should either be:

• a single value
• an Nx1 array/list
• an Nx3 array/list

Set the contrast for each element. Should either be:

• a single value
• an Nx1 array/list