A method of tensor.

a random tensor with the symmetries its class and frame ask for; MATLAB’s rand of a tensor class

Syntax

T = tensor.rand(rank=4)

Entries uniform in [0, 1].

T = tensor.rand(100, cs, rank=2)

A list of 100 in the frame cs.

S = complianceTensor.rand()

A random compliance tensor.

C = stiffnessTensor.rand(cs, rng=np.random.default_rng(0))

Reproducible, of the symmetry of cs.

Description

A plain tensor has independent entries drawn uniformly from [0, 1], as MATLAB’s, and none of the symmetries a physical tensor would have. A symmetric one (strain, stress, …) is the symmetric part of such a tensor, symmetrised in its frame; a stiffness or compliance tensor is besides made positive definite, as the class requires. The numbers among the arguments give the shape of the list, a reference frame the frame; other keywords go to the constructor of the class.

Input

n, m, ... the shape of the list
cs referenceFrame, the frame

Keywords

keyword default description
rank None the rank of a plain tensor, by default that of the class, two for a plain tensor
rng None the NumPy random generator, a fresh one by default

Output

T a tensor of the class

See also

tensor.ones, tensor.zeros, tensor.eye

MATLAB’s tensor.rand

source

Citing this page. This page is part of the documentation of MTEX, a free and open source MATLAB toolbox for analyzing and modeling crystallographic textures. It was written by The MTEX Developers and is published at https://mtex-toolbox.github.io/tensor.rand_py.html. If you use MTEX, or reuse text or figures from this page, in your research, please cite

F. Bachmann, R. Hielscher, H. Schaeben: Texture Analysis with MTEX - Free and Open Source Software Toolbox, Solid State Phenomena 160 (2010), 63-68. 10.4028/www.scientific.net/SSP.160.63

BibTeX 
@article{bachmann2010mtex,
  author  = {F. Bachmann and R. Hielscher and H. Schaeben},
  title   = {Texture Analysis with MTEX - Free and Open Source Software Toolbox},
  journal = {Solid State Phenomena},
  volume  = {160},
  pages   = {63-68},
  year    = {2010},
  doi     = {10.4028/www.scientific.net/SSP.160.63},
  url     = {https://doi.org/10.4028/www.scientific.net/SSP.160.63}
}

Other papers describing specific MTEX methods are listed under Publications — please cite the one that best fits your application. The MTEX source code is licensed under the GNU General Public License v2.0; the text and figures of this documentation are licensed under CC BY 4.0, which permits reuse — including by automated systems — provided The MTEX Developers and this page are credited.