A tensor wrapper is a data structure W that given a multidimensional scalar function f(X,params), and a set of coordinates {{x1}_i1,{x2}_i2,..,{xd}_id} indexed by the multi index {i1,..,id}, let you access f(x1_i1,..,xd_id) by W[i1,..,id]. The function evaluations are performed “as needed” and stored for future accesses.
Parameters: 


Several shape parameters are used by the TensorWrapper in order to keep track of reshaping and slicings, without affecting the underlying shape of the tensor which is always preserved. The following table lists the existing shapes and their meaning.
Shape attribute/function  Applied transformations (ordered)  Description 

get_global_shape()  None  The original shape of the tensor. This shape can be modified only through a refinement of the grid using the function refine(). 
get_view_shape()  VIEW  The particular view of the tensor, defined by the view in TensorWrapper.maps set active using set_active_view(). 
get_extended_shape()  VIEW, QUANTICS  The shape of the extended tensor in order to allow for the quantics folding with basis TensorWrapper.Q. 
get_ghost_shape()  VIEW, QUANTICS, RESHAPE  The shape of the tensor reshaped using reshape(). If a Quantics folding is preapplied, then the reshape is on the extended shape. 
get_shape()  VIEW, QUANTICS, RESHAPE, FIX_IDXS  The shape of the tensor with fix_indices() and release_indices(). This is the view that is always used when the tensor is accessed through the function __getitem__() (i.e. TW[...]) 
Returns:  True if the idxs is in the view shape. False if it is outside 

Fix some of the indices in the tensor wrapper and reshape/resize it accordingly. The internal storage of the data is still done with respect to the global indices, but once some indices are fixed, the TensorWrapper can be accessed using just the remaining free indices.
Parameters: 

If the quantics folding has been performed on the current view, then this returns the number of dimensions of the extended tensor to the next power of Q. If the folding has not been performed, this returns an error.
If the quantics folding has been performed on the current view, then this returns the shape of the extended tensor to the next power of Q. If the folding has not been performed, this returns the view shape.
If the quantics folding has been performed on the current view, then this returns the size of the extended tensor to the next power of Q. If the folding has not been performed, this returns an error.
If the ghost_shape is set for this view, then it returns the number of dimensions obtained after quantics folding by the function set_Q() or after reshaping by the function reshape(). Otherwise the number of dimensions of the view is returned.
If the ghost_shape is set for this view, then it returns the shape obtained after quantics folding by the function set_Q() or after reshaping by the function reshape(). Otherwise the shape of the extended shape is returned.
If the ghost_shape is set for this view, then it returns the size obtained after quantics folding by the function set_Q() or after reshaping by the function reshape(). Otherwise the size of the view is returned.
Always returns the ndim of the underlying tensor
Always returns the shape of the underlying tensor
Always returns the size of the underlying tensor
Always returns the number of dimensions of the tensor view
Always returns the shape of the actual tensor view
Always returns the size of the tensor view
Always returns the ndim of the current view
Always returns the shape of the current view
Always returns the size of the current view
This maps the index from the current ghost shape of the view to the global shape.
Parameters:  idxs_in (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
This maps the index from the current ghost shape of the view to the view shape.
Parameters:  idxs_in (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
This maps the index from the global shape to the ghost shape.
Parameters:  idxs (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
For TensorWrapper() A, this corresponds to:
>>> A.view_to_ghost( A.global_to_view( idxs ) )
This maps the index from the global shape to the view shape.
Parameters:  idxs (tuple) – tuple representing an index to be transformed. 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
Note
this returns an error if the idxs do not belong to the index mapping of the current view.
Refine the global discretization. The new discretization must contain the old one.
This function takes care of updating all the indices in the global view as well in all the other views.
Parameters: 

Warning
Any existing reshaping of the views is discarded.
Release all the indices in the tensor wrapper which were fixed using fix_indices().
Reset the shape of the tensor erasing the reshape and quantics foldings.
Reset the shape of the tensor erasing the reshape and quantics foldings.
Reshape the tensor. The number of items in the new shape must be consistent with get_extended_size(), i.e. with the number of items in the extended quantics size or the view size if Q is not set for this view.
This will unset any fixed index for the current view set using fix_indices().
Parameters:  newshape (list) – new shape to be applied to the tensor. 

Set the quantics folding base for the current view.
This will unset any fixed index for the current view set using fix_indices().
Parameters:  Q (int) – folding base. 

Set a view among the ones in self.maps.
Parameters:  view (str) – name of the view to be set as active 

Set whether to use the weights or not.
Parameters:  flag (bool) – If True the items returned by the Tensor Wrapper will be weighted according to the weights provided at construction time. If False the original values of the function will be returned. 

Set or add a view to self.maps. This resest all the existing reshape parameters in existing views.
Parameters: 

Set a new list of weights for the tensor :param list W: list of np.ndarray with weights for each dimension
This maps the index from the current shape of the view (fixed indices) to the ghost shape.
Parameters:  idxs_in (list) – list of indices to be transformed 

Note
slicing is admitted here.
This maps the index from the current shape of the view to the global shape.
Parameters:  idxs_in (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
This maps the index from the current shape of the view to the view shape.
Parameters:  idxs_in (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
Upgrade to v0.3.0
Parameters:  filename (string) – path to the filename. This must be the main filename with no extension. 

This maps the index from the view to the ghost shape.
Parameters:  idxs (list) – list of indices to be transformed 

Note
no slicing is admitted here. Preprocess idxs with expand_idxs() if slicing is required.
Note
this returns an error if the ghost shape is obtained by quantics folding, because the one view index can be pointing to many indices in the folding.