ThroughThickness
Create a through-thickness plot to display the variation of a layered shell quantity in its thickness direction at specified points.
The ThroughThickness plot requires a license for the AC/DC Module, Composite Materials Module, Heat Transfer Module, or Structural Mechanics Module.
Syntax
model.result(<pgtag>).create(<ftag>,"ThroughThickness");
model.result(<pgtag>).feature(<ftag>).set(property,<value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"ThroughThickness") creates a through-thickness plot feature named <ftag> belonging to the plot group <pgtag>.
A through-thickness plot is used to visualize the variation of a layered shell quantity in its thickness direction. Through-thickness plots can be added to 1D plot groups. The following properties are available:
Table 7-157: Valid Properties for Through-Thickness Plots.
name
Value
Default
Description
autodescr
true | false
Model dependent
Whether the automatic legends should include the expression descriptions.
autoexpr
true | false
Model dependent
Whether the automatic legends should include the expressions.
autoplotlabel
true | false
false
Whether the automatic legends should include the plot label.
autopoint
true | false
false
Whether the automatic legends should include the point.
autosolution
true | false
false
Whether the automatic legends should include the solution.
autounit
true | false
false
Whether the automatic legends should include the unit.
colorcycle
default | long
default
The color cycle, when linecolor is set to cycle. With default, it contains 7 colors; with long, it contains 19 colors.
const
String array of property/value pairs
Empty
Parameters to use in the expressions
customlinecolor
RGB-triplet
{0,0,1} or last used edgecolor
The color to use for the lines. Active when linecolor is set to custom.
data
none | parent | dataset name
parent
The dataset this feature refers to.
descr
String
Model dependent
The description of the expression in expr. Is used in the automatic title.
descriptionintitle
on | off
on
Whether the title contribution should contain the description when titletype is custom.
differential
on | off
on
Whether the expression should be linearized at the linearization point. Applicable only if evalmethod is harmonic.
evalmethod
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
harmonic
Applicable only for solutions with a stored linearization point. Controls if the linearization point, the perturbation, or a combination should be used when evaluating the expression.
expr
String
Model dependent
The expression to plot.
expressionintitle
on | off
off
Whether the title contribution should contain the expression when titletype is custom.
includeinterfaces
off | all | exterior
off
Whether to include interface positions in the plot: No interfaces, all interfaces, or interfaces between layered materials.
innerinput
all | first | last | manual | manualindices | interp
all
How to input the solution to use. manual indicates that solnum is used. manualindices indicates that solnumindices is used. interp indicates that t is used.
interfacecolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
magenta
How to color the interface positions, when includeinterfaces is true.
interfacelinestyle
solid | dotted | dashed | dashdot
dotted
The line style for the lines representing the interface positions, when includeinterfaces is true.
interp
double row matrix
Empty on all levels
The times to use, for transient levels. Available when data is not parent and the underlying data is transient.
legend
on | off
off
Whether to show legends.
legendexprprecision
positive integer
3
The precision for the evaluated expression when legendmethod is set to evaluated.
legendmethod
automatic | manual | evaluated
automatic
Whether to use the automatic legends or the legends added manually or evaluated.
legendpattern
String
 
A legend string to be evaluated when legendmethod is set to evaluated.
legendprefix
String
 
A prefix added to the automatic legend.
legends
String array
The last computed automatic legends
Manual legends active when legendmethod is set to manual.
legendsuffix
String
 
A suffix added to the automatic legend.
linecolor
custom | cycle | black | blue | cyan | gray | green | magenta | red | white | yellow
cycle
How to color the lines in the graph. Cycle indicates that the colors is different for each line.
linewidth
double | preference
1
The line width.
linemarker
none | cycle | asterisk | circle | diamond | plus | point | square | star | triangle
none
The line markers, if any. Cycle indicates that the marker is different for each line.
looplevel
integer row matrix
All solutions on all levels
The solutions to use, per level.
looplevelindices
integer row matrix
Empty
An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when looplevelinput is manualindices on a level.
looplevelinput
String array with all | first | last | manual | manualindices | interp on each level
all on all levels
How to input the solution to use, per level. manual on a level indicates that looplevel is used on that level. manualindices on a level indicates that looplevelindices is used on that level. interp on a level indicates that interp is used on that level.
markerpos
interp | datapoints
interp
Controls whether the positions of the markers are in the data points of the plot, or interpolated depending on the number (set in markers). Markers are visible when linemarker is set.
markers
integer
8
The number of markers to show. Markers are visible when linemarker is set.
linestyle
none | cycle | solid | dotted | dashed | dashdot
solid
The line style, if any. Cycle indicates that the line style is different for each line.
outerinput
all | first | last | manual | manualindices
all
How to input the outer solutions to use. Applicable only for parametric sweep models. manual indicates that outersolnum is used. manualindices indicates that outersolnumindices is used.
outersolnum
nonnegative integer array
1
The index of the outer solutions to use. Applicable only for parametric sweep models. Since the various outer solutions can have different number of solnum, the solnum property is not used.
outersolnumindices
String or integer array
Empty
An alternative way to specify the outer solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when outerinput is manualindices.
posentry
coordinates | selection
selection
Determine the position using a selection or by providing coordinates.
plotonsecyaxis
Boolean
true
Plot on secondary y-axis, if twoyaxes is set to true in the parent plot group.
point3x
scalar
0
The x-coordinate for the position when posentry is set to coordinates.
point3y
scalar
0
The y-coordinate for the position when posentry is set to coordinates.
point3z
scalar
0
The z-coordinate for the position when posentry is set to coordinates.
prefixintitle
String
Empty
Added prefix to contribution to title.
refine
nonnegative integer
1
The element refinement to use, if resolution is set to manual. Bear in mind that this is the refinement used for the base dataset, so the number of elements in the model can increase radically if the plot uses, for example, a revolve dataset.
resolution
norefine | coarse | normal | fine | finer | extrafine | custom
normal
Controls the plot’s resolution. A finer setting results in a higher resolution by modifying the internally computed default refinement. Use custom to enter your own refinement in the refine property.
smooth
true | false
false
Apply smoothing to the plot data.
solnum
integer array
All solutions
The solutions to plot. Available when data is not parent and the underlying data has multiple solutions.
solnumindices
String or integer array
Empty
An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when innerinput is manualindices.
solrepresentation
solnum | solutioninfo
solutioninfo
Indicates which method of selecting solutions is active.
suffixintitle
String
Empty
Added suffix to contribution to title.
t
double array
Empty
The times to plot. Available when data is not parent and the underlying solution is transient.
thicknesscoordinateunit
length unit
The default length unit
The length unit to use if ydata is set to thicknesscoordinate.
title
String
The auto-title
The title to use when titletype is manual.
titletype
auto | custom | label | manual | none
auto
auto, if the title should be computed automatically. custom, if the title should be computed automatically, but customized. label, if the title should be the plot group’s label. manual, if the manual title should be used (the title property). none, if no title should be displayed.
typeintitle
on | off
on
Whether the title contribution should contain the type when titletype is custom.
unit
String
Model dependent
The unit to use for the expression in expr. If the old unit is not valid when the expression changes, the unit property is reset to default.
unitintitle
on | off
on
Whether the title contribution should contain the unit when titletype is custom.
xdata
arc | reversedarc | expr
solution
x-axis data. expr uses the expression in xdataexpr. arc uses the curve’s arc length, and reversedarc uses the arc length measured from the curve’s endpoint.
xdataexpr
String
Model dependent
Expression for x-axis data.
xdatadescr
String
Model dependent
Description of expression in xdataexpr.
xdataunit
String
Model dependent
The unit to use for the expression in xdataexpr. If the old unit is not valid when the expression changes, the unit property is reset to default.
ydata
expr | thicknesscoordinate
thickness
coordinate
Take the y-data from an expression or as the thickness coordinate.
ydataexpr
String
Model dependent
Expression for y-axis data when ydata is set to expr.
ydatadescr
String
Model dependent
Description of expression in ydataexpr.
Attributes
Color
See Also
LineGraph