Field¶
(Source code, png, hires.png, pdf)

class
Field
(*args)¶ Base class for Fields.
 Available constructors:
Field(mesh, dim)
Field(mesh, values)
Parameters: mesh :
Mesh
Each vertice of the mesh is in a domain of .
dim : int
Dimension of the values.
values : 2d sequence of float of dimension
The values associated to the vertices of the mesh. The size of values is equal to the number of vertices in the associated mesh. So we must have the equality between values.getSize() and mesh.getVerticesNumber().
Notes
A class:~openturns.Field contains a mesh and the values associated to each vertice of the mesh. In the context of a stochastic process , a
Field
contains the mesh and a realization of discretized on this mesh.Examples
Create a field:
>>> import openturns as ot >>> myVertices = [[0.0, 0.0], [1.0, 0.0], [1.0, 1.0], [1.5, 1.0], [2.0, 1.5], [0.5, 1.5]] >>> mySimplicies = ot.IndicesCollection([[0,1,2], [1,2,3], [2,3,4], [2,4,5], [0,2,5]]) >>> myMesh = ot.Mesh(myVertices, mySimplicies) >>> myValues = [[2.0],[2.5],[4.0], [4.5], [6.0], [7.0]] >>> myField = ot.Field(myMesh, myValues)
Draw the field:
>>> myGraph = myField.draw()
Methods
asDeformedMesh
()Get the mesh deformed according to the values of the field. draw
()Draw the first marginal of the field if the spatial dimension is less than 2. drawMarginal
([index, interpolate])Draw one marginal field if the spatial dimension is less than 2. exportToVTKFile
(fileName)Create the VTK format file of the field. getClassName
()Accessor to the object’s name. getDescription
()Get the description of the vertices and the values of the field. getDimension
()Get the dimension of the values. getId
()Accessor to the object’s id. getImplementation
(*args)Accessor to the underlying implementation. getMarginal
(*args)getMesh
()Get the mesh on which the field is defined. getName
()Accessor to the object’s name. getSample
()getSize
()Get the number of values inside the field. getSpatialDimension
()Get the dimension of the domain . getSpatialMean
()Get the spatial weighted mean of the values of the field. getTemporalMean
()Get the mean of the values of the field. getTimeGrid
()Get the mesh as a time grid if it is 1D and regular. getValueAtIndex
(index)Get the value of the field at the vertex of the given index. getValueAtNearestPosition
(position)Get the value of the field at the vertex of the mesh the nearest to the given point. getValues
()Get the values of the field. setDescription
(description)Set the description of the field.. setName
(name)Accessor to the object’s name. setValueAtIndex
(index, val)Assign the value of the field to the vertex at the given index. setValueAtNearestPosition
(position, val)Assign the value of the field to the vertex the nearest to a specified position. setValues
(values)Assign values to a field. 
__init__
(*args)¶ x.__init__(…) initializes x; see help(type(x)) for signature

asDeformedMesh
()¶ Get the mesh deformed according to the values of the field.
Returns: deformedMesh :
Mesh
The initial mesh is deformed as follows: each vertex of the mesh is replaced by the sum of the vertex and the value of the field at this vertex. Only works when : the spatial dimension : is equal to the dimension of the field .

draw
()¶ Draw the first marginal of the field if the spatial dimension is less than 2.
Returns: graph :
Graph
Calls drawMarginal(0, False).
See also

drawMarginal
(index=0, interpolate=True)¶ Draw one marginal field if the spatial dimension is less than 2.
Parameters: index : int
The selected marginal.
interpolate : bool
Indicates whether the values at the vertices are linearly interpolated.
Returns: graph :
Graph
 If the dimension of the mesh is and interpolate=True: it draws the graph of the piecewise linear function based on the selected marginal values of the field and the vertices coordinates (in ).
 If the dimension of the mesh is and interpolate=False: it draws the cloud of points which coordinates are (vertex, value of the marginal index).
 If the dimension of the mesh is and interpolate=True: it draws several isovalues curves of the selected marginal, based on a piecewise linear interpolation within the simplices (triangles) of the mesh. You get an empty graph if the vertices are not connected through simplicies.
 If the dimension of the mesh is and interpolate=False: if the vertices are connected through simplicies, each simplex is drawn with a color defined by the mean of the values of the vertices of the simplex. In the other case, it draws each vertex colored by its value.

exportToVTKFile
(fileName)¶ Create the VTK format file of the field.
Parameters: myVTKFile : str
Name of the output file. No extension is append to the filename.
Notes
Creates the VTK format file that contains the mesh and the associated values that can be visualised with the open source software Paraview .

getClassName
()¶ Accessor to the object’s name.
Returns: class_name : str
The object class name (object.__class__.__name__).

getDescription
()¶ Get the description of the vertices and the values of the field.
Returns: description :
Description
Description of the vertices and the values of the field.

getDimension
()¶ Get the dimension of the values.
Returns: d : int
Dimension of the values: .

getId
()¶ Accessor to the object’s id.
Returns: id : int
Internal unique identifier.

getImplementation
(*args)¶ Accessor to the underlying implementation.
Returns: impl : Implementation
The implementation class.

getMesh
()¶ Get the mesh on which the field is defined.
Returns: mesh :
Mesh
Mesh over which the domain is discretized.

getName
()¶ Accessor to the object’s name.
Returns: name : str
The name of the object.

getSize
()¶ Get the number of values inside the field.
Returns: size : int
Number of values inside the field, which corresponds to the number of vertices of the mesh.

getSpatialDimension
()¶ Get the dimension of the domain .
Returns: n : int
Dimension of the domain : .

getSpatialMean
()¶ Get the spatial weighted mean of the values of the field.
Returns: spatialMean :
Point
Weighted mean of the values of the field, weighted by the volume of each simplex.
Notes
The spatial mean of the field is defined by:
where is the simplex of index of the mesh, its volume and the values of the field associated to the vertices of , and .

getTemporalMean
()¶ Get the mean of the values of the field.
Returns: temporalMean :
Point
Mean of the values of the field.
Notes
If we note the values in of the field, then the temporal mean is defined by:
Only makes sense in the case of a regular grid.

getTimeGrid
()¶ Get the mesh as a time grid if it is 1D and regular.
Returns: timeGrid :
RegularGrid
Mesh of the field when it can be interpreted as a
RegularGrid
. We check if the vertices of the mesh are scalar and are regularly spaced in but we don’t check if the connectivity of the mesh is conform to the one of a regular grid (without any hole and composed of ordered instants).

getValueAtIndex
(index)¶ Get the value of the field at the vertex of the given index.
Parameters: index : int
Vertex of the mesh of index index.
Returns: value :
Point
The value of the field associated to the selected vertex, in .

getValueAtNearestPosition
(position)¶ Get the value of the field at the vertex of the mesh the nearest to the given point.
Parameters: point : sequence of float in .
Returns: value :
Point
in .The value of the field associated to vertex the nearest of point with respect to the Euclidean norm.

getValues
()¶ Get the values of the field.
Returns: values :
Sample
Values associated to the mesh. The size of the sample is the number of vertices of the mesh and the dimension is the dimension of the values (). Identical to
getSample()
.

setDescription
(description)¶ Set the description of the field..
Parameters: myDescription :
Description
Description of the field. Must be of size and give the description of the vertices and the values.

setName
(name)¶ Accessor to the object’s name.
Parameters: name : str
The name of the object.

setValueAtIndex
(index, val)¶ Assign the value of the field to the vertex at the given index.
Parameters: index : int
Index that characterizes one vertex of the mesh.
value :
Point
in .New value assigned to the selected vertex.

setValueAtNearestPosition
(position, val)¶ Assign the value of the field to the vertex the nearest to a specified position.
Parameters: position : sequence of float in .
value : sequence of float in .
New value assigned to the vertex the nearest to position with respect to the Euclidean norm.

setValues
(values)¶ Assign values to a field.
Parameters: values : 2d sequence of float
Values assigned to the mesh. The size of the values is the number of vertices of the mesh and the dimension is .