Tshell class

The Tshell class gives you access to thick shell elements in D3PLOT. More...

The D3PLOT JavaScript API provides many class constants, properties and methods. For Arup to be able to extend and enhance the API in the future any constant, property or method names beginning with a lowercase or uppercase letter are reserved.
If you need to add your own properties or methods to one of the existing classes then to avoid any potential future conflict you should ensure that the name begins with either an underscore (_) or a dollar sign ($) or the name is prefixed with your own unique identifier.
For example if company 'ABC' need to add a property called 'example' then to avoid any potential future conflict use one of:

_example
$example
ABC_example

Class functions

BlankAll(window[GraphicsWindow], model[Model])
BlankFlagged(window[GraphicsWindow], model[Model], flag[Flag])
First(model[Model])
FlagAll(model[Model], flag[Flag])
GetAll(model[Model], property (optional)[string])
GetFlagged(model[Model], flag[Flag], property (optional)[string])
GetFromID(model[Model], label[integer])
GetFromIndex(model[Model], index[integer])
GetMultipleData(component[constant], items[array], options (optional)[object])
Last(model[Model])
Pick()
Select(flag[Flag])
Total(model[Model])
TotalDeleted(model[Model])
UnblankAll(window[GraphicsWindow], model[Model])
UnblankFlagged(window[GraphicsWindow], model[Model], flag[Flag])
UnflagAll(model[Model], flag[Flag])

Member functions

Blank(window[GraphicsWindow])
Blanked(window[GraphicsWindow])
ClearFlag(flag[Flag])
Deleted()
Flagged(flag[Flag])
GetData(component[constant], options (optional)[object])
LocalAxes()
Next()
PlasticStrain(options (optional)[object])
Previous()
SetFlag(flag[Flag])
StrainTensor(options (optional)[object])
StressTensor(options (optional)[object])
Topology()
Unblank(window[GraphicsWindow])
VonMisesStress(options (optional)[object])

Tshell properties

Name	Type	Description
data (read only)	real\|array	Component data for a tshell passed as an argument to GetMultipleData. Note that data will only exist for the instance of the tshell passed to GetMultipleData. i.e. it is a local property stored on the specific instance. It is not stored in the D3PLOT database
include (read only)	integer	The include file number in the model that the tshell is in
index (read only)	integer	The internal index for the tshell in D3PLOT (starting at 0)
integrationPoints (read only)	integer	The number of through thickness integration points that the thick shell has
label (read only)	integer	The Ansys LS-DYNA label for the tshell
material (read only)	Material	The Material the tshell has. This is only available if there is a ztf file for the model. If not null will be returned. If this is a PART_COMPOSITE then null will be returned. Part.GetCompositeData should be used to get material data in this case
model (read only)	Model	The Model that the tshell is in
onPlanIntegrationPoints (read only)	integer	The number of on plan integration points that the thick shell has
part (read only)	Part	The Part the tshell is in
type (read only)	constant	The type for the tshell (will be Type.TSHELL)

Detailed Description

The Tshell class allows you to inspect thick shell elements in a model. See the documentation below for more details.

Details of functions

Blank(window[GraphicsWindow])

Description

Blanks the tshell in a graphics window

Arguments

window (GraphicsWindow)

GraphicsWindow) to blank the tshell in

Returns

No return value

Example

To blank tshell t in graphics window g:

t.Blank(g);

BlankAll(window[GraphicsWindow], model[Model]) [static]

Description

Blanks all of the tshells in the model

Arguments

window (GraphicsWindow)

GraphicsWindow) to blank the tshells in

model (Model)

Model that all the tshells will be blanked in

Returns

No return value

Example

To blank all of the tshells in model m, in graphics window gw:

Tshell.BlankAll(gw, m);

BlankFlagged(window[GraphicsWindow], model[Model], flag[Flag]) [static]

Description

Blanks all of the tshells in the model flagged with a defined flag

Arguments

window (GraphicsWindow)

GraphicsWindow) to blank the tshells in

model (Model)

Model that the flagged tshells will be blanked in

flag (Flag)

Flag (see AllocateFlag) set on the tshells to blank

Returns

No return value

Example

To blank all of the tshells flagged with flag f in model m, in graphics window gw:

Tshell.BlankFlagged(gw, m, f);

Blanked(window[GraphicsWindow])

Description

Checks if the tshell is blanked in a graphics window or not

Arguments

window (GraphicsWindow)

GraphicsWindow) in which to check if the tshell is blanked

Returns

true if blanked, false if not

Return type

boolean

Example

To check if tshell t is blanked in graphics window g:

if (t.Blanked(g) ) do_something...

ClearFlag(flag[Flag])

Description

Clears a flag on a tshell

Arguments

flag (Flag)

Flag (see AllocateFlag) to clear on the tshell

Returns

No return value

Example

To clear flag f on tshell t:

t.ClearFlag();

Deleted()

Description

Checks if the thick shell has been deleted or not

Arguments

No arguments

Returns

true if deleted, false if not

Return type

boolean

Example

To check if thick shell t has been deleted:

if (t.Deleted() ) do_something...

First(model[Model]) [static]

Description

Returns the first tshell in the model (or null if there are no tshells in the model)

Arguments

model (Model)

Model to get first tshell in

Returns

Tshell object

Return type

Tshell

Example

To get the first tshell in model m:

var t = Tshell.First(m);

FlagAll(model[Model], flag[Flag]) [static]

Description

Flags all of the tshells in the model with a defined flag

Arguments

model (Model)

Model that all the tshells will be flagged in

flag (Flag)

Flag (see AllocateFlag) to set on the tshells

Returns

No return value

Example

To flag all of the tshells with flag f in model m:

Tshell.FlagAll(m, f);

Flagged(flag[Flag])

Description

Checks if the tshell is flagged or not

Arguments

flag (Flag)

Flag (see AllocateFlag) to test on the tshell

Returns

true if flagged, false if not

Return type

boolean

Example

To check if tshell t has flag f set on it:

if (t.Flagged(f) ) do_something...

GetAll(model[Model], property (optional)[string]) [static]

Description

Returns an array of Tshell objects or properties for all of the tshells in the model. If the optional property argument is not given then an array of Tshell objects is returned. If the property argument is given, that property value for each tshell is returned in the array instead of a Tshell object

Arguments

model (Model)

Model that all the tshells are in

property (optional) (string)

Name for property to get for all tshells in the model

Returns

Array of Tshell objects or properties

Return type

Array

Example

To get all of the tshells in model m:

var t = Tshell.GetAll(m);

To return an array containing the value of property 'foo' (for example 'label' for a tshell) for each tshell in model m:

var a = Tshell.GetAll(m, 'foo');

GetData(component[constant], options (optional)[object])

Description

Returns the value for a data component.
Also see GetMultipleData

Arguments

component (constant)

Component constant to get data for

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
extra	integer	The extra data component number if component Component.SOX for solids, Component.BMX for beams or Component.SHX for shells and thick shells
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM). If the integration point is not defined it will use the integration point defined on the current GUI "data" panel, which defaults to the middle surface for shells, thick shells, and solids, and Mag All for beams, but may vary if changed by an interactive user. If consistent output from a script is required, independent of any prior interactive activity, an explicit integration point or surface should be defined
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])
referenceFrame	constant	The frame of reference to return values in. Either Constant.GLOBAL (default), Constant.LOCAL, Constant.CYLINDRICAL, Constant.USER_DEFINED or Constant.MATERIAL. This is only necessary for directional components (eg X stress) and then only when something other than the default Constant.GLOBAL coordinate system is to be used
user	integer	The user-defined component number if component Component.UNOS, Component.UNOV, Component.USSS, Component.USST, Component.UBMS or Component.UBMV

Returns

Number if a scalar component, array if a vector or tensor component (or null if the value cannot be calculated because it's not available in the model).
If requesting an invalid component it will throw an error (e.g. Component.AREA of a node).

Return type

real|array

Example

To calculate a component and check it has been calculated (note that in the example, the argument extra is optional):

var value = t.GetData(component, {extra: 1});
if (value !== null) do_something...

GetFlagged(model[Model], flag[Flag], property (optional)[string]) [static]

Description

Gets all of the tshells in the model flagged with a defined flag. If the optional property argument is not given then an array of Tshell objects is returned. If the property argument is given, that property value for each tshell is returned in the array instead of a Tshell object

Arguments

model (Model)

Model that the flagged tshells are in

flag (Flag)

Flag (see AllocateFlag) set on the tshells to get

property (optional) (string)

Name for property to get for all flagged tshells in the model

Returns

Array of Tshell objects or properties

Return type

Array

Example

To get all of the tshells flagged with flag f in model m:

Tshell.GetFlagged(m, f);

To return an array containing the value of property 'foo' (for example 'label' for a node) for all tshells flagged with flag f in model m:

var a = Tshell.GetFlagged(m, f, 'foo');

GetFromID(model[Model], label[integer]) [static]

Description

Returns the Tshell object for tshell in model with label (or null if it does not exist)

Arguments

model (Model)

Model to get tshell in

label (integer)

The Ansys LS-DYNA label for the tshell in the model

Returns

Tshell object

Return type

Tshell

Example

To get the tshell in model m with label 1000:

var t = Tshell.GetFromID(m, 1000);

GetFromIndex(model[Model], index[integer]) [static]

Description

Returns the Tshell object for tshell in model with index (or null if it does not exist)

Arguments

model (Model)

Model to get tshell in

index (integer)

The D3PLOT internal index in the model for tshell, starting at 0.

Returns

Tshell object

Return type

Tshell

Example

To get the 51st tshell in model m:

var t = Tshell.GetFromIndex(m, 50);

GetMultipleData(component[constant], items[array], options (optional)[object]) [static]

Description

Returns the value for a data component for multiple tshells. For each tshell a local property called data will be created containing a number if a scalar component, or an array if a vector or tensor component (or null if the value cannot be calculated). The data is also returned as an object.
Also see GetData

Arguments

component (constant)

Component constant to get data for

items (array)

Array of Tshell objects to get the data for. All of the tshells must be in the same model.

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
extra	integer	The extra data component number if component Component.SOX for solids, Component.BMX for beams or Component.SHX for shells and thick shells
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM)
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])
referenceFrame	constant	The frame of reference to return values in. Either Constant.GLOBAL (default), Constant.LOCAL, Constant.CYLINDRICAL, Constant.USER_DEFINED or Constant.MATERIAL. This is only necessary for directional components (eg X stress) and then only when something other than the default Constant.GLOBAL coordinate system is to be used
user	integer	The user-defined component number if component Component.UNOS, Component.UNOV, Component.USSS, Component.USST, Component.UBMS or Component.UBMV

Returns

Object containing the data. A property is created in the object for each tshell with the label. The value of the property is a number if a scalar component or an array if a vector or tensor component (or null if the value cannot be calculated)

Return type

object

Example

To calculate a component for tshells in array items and use the data property (note that in the example, the argument extra is optional):

Tshell.GetMultipleData(component, items, {extra: 1});
for (i=0; i<items.length; i++)
{
    if (items[i].data !== null) do_something...
}

To calculate a component for tshells in array items and use the return value (note that in the example, the argument extra is optional):

var data = Tshell.GetMultipleData(component, items, {extra: 1});
for (d in data)
{
    Message("Label is " + d);
    if (data[d] !== null) do_something...
}

Last(model[Model]) [static]

Description

Returns the last tshell in the model (or null if there are no tshells in the model)

Arguments

model (Model)

Model to get last tshell in

Returns

Tshell object

Return type

Tshell

Example

To get the last tshell in model m:

var t = Tshell.Last(m);

LocalAxes()

Description

Returns the local axes of the element in model space, expressed as direction cosines in a 2D array. Beam elements must have 3 nodes to be able to return local axes.

Arguments

No arguments

Returns

array of arrays

Return type

Array

Example

To get the local axes for tshell t:

var axes = t.LocalAxes();
var xAxis = [ axes[0][0], axes[0][1], axes[0][2] ];
var yAxis = [ axes[1][0], axes[1][1], axes[1][2] ];
var zAxis = [ axes[2][0], axes[2][1], axes[2][2] ];

Next()

Description

Returns the next tshell in the model (or null if there is not one)

Arguments

No arguments

Returns

Tshell object

Return type

Tshell

Example

To get the next tshell after tshell t:

t = t.Next();

Pick() [static]

Description

Allows the user to pick a tshell from the screen

Arguments

No arguments

Returns

Tshell object or null if cancelled

Return type

Tshell

Example

To pick a tshell:

var t = Tshell.Pick();

PlasticStrain(options (optional)[object])

Description

Returns the effective plastic strain for the thick shell (or null if the value cannot be calculated)

Arguments

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM)
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])

Returns

Plastic strain

Return type

real

Example

To return the effective plastic strain of thick shell t:

var strain = t.PlasticStrain();
if (strain !== null) do_something...

Previous()

Description

Returns the previous tshell in the model (or null if there is not one)

Arguments

No arguments

Returns

Tshell object

Return type

Tshell

Example

To get the previous tshell before tshell t:

t = t.Previous();

Select(flag[Flag]) [static]

Description

Selects tshells using an object menu

Arguments

flag (Flag)

Flag (see AllocateFlag) to use when selecting tshells

Returns

The number of tshells selected or null if menu cancelled

Return type

integer

Example

To select tshells, flagging those selected with flag f:

var total = Tshell.Select(f);

SetFlag(flag[Flag])

Description

Sets a flag on a tshell

Arguments

flag (Flag)

Flag (see AllocateFlag) to set on the tshell

Returns

No return value

Example

To set flag f on tshell t:

t.SetFlag(f);

StrainTensor(options (optional)[object])

Description

Returns the strain tensor for the thick shell

Arguments

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM)
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])
referenceFrame	constant	The frame of reference to return values in. Either Constant.GLOBAL (default), Constant.LOCAL, Constant.CYLINDRICAL, Constant.USER_DEFINED or Constant.MATERIAL

Returns

Array containing the strain tensor [Exx, Eyy, Ezz, Exy, Eyz, Ezx] (or null if the value cannot be calculated)

Return type

array

Example

To return the strain tensor of think shell t:

var tensor = t.StrainTensor();
if (tensor !== null) do_something...

StressTensor(options (optional)[object])

Description

Returns the stress tensor for the thick shell

Arguments

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM)
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])
referenceFrame	constant	The frame of reference to return values in. Either Constant.GLOBAL (default), Constant.LOCAL, Constant.CYLINDRICAL, Constant.USER_DEFINED or Constant.MATERIAL

Returns

Array containing the stress tensor [Exx, Eyy, Ezz, Exy, Eyz, Ezx] (or null if the value cannot be calculated)

Return type

array

Example

To return the stress tensor of thick shell t:

var tensor = t.StressTensor();
if (tensor !== null) do_something...

Topology()

Description

Returns the topology for the tshell in the model

Arguments

No arguments

Returns

array of Node objects

Return type

Array

Example

To get the topology for tshell t:

var topology = t.Topology();

Total(model[Model]) [static]

Description

Returns the total number of tshells in the model

Arguments

model (Model)

Model to get total in

Returns

The number of tshells

Return type

integer

Example

To get the number of tshells in model m:

var total = Tshell.Total(m);

TotalDeleted(model[Model]) [static]

Description

Returns the total number of thick shells that have been deleted in a model in the state given by its state property

Arguments

model (Model)

Model to get total in

Returns

The number of thick shells that have been deleted

Return type

integer

Example

To get the number of thick shells in model m that have been deleted in state 10:

m.state = 10;
var total = Tshell.TotalDeleted(m);

Unblank(window[GraphicsWindow])

Description

Unblanks the tshell in a graphics window

Arguments

window (GraphicsWindow)

GraphicsWindow) to unblank the tshell in

Returns

No return value

Example

To unblank tshell t in graphics window g:

t.Unblank(g);

UnblankAll(window[GraphicsWindow], model[Model]) [static]

Description

Unblanks all of the tshells in the model

Arguments

window (GraphicsWindow)

GraphicsWindow) to unblank the tshells in

model (Model)

Model that all the tshells will be unblanked in

Returns

No return value

Example

To unblank all of the tshells in model m, in graphics window gw:

Tshell.UnblankAll(gw, m);

UnblankFlagged(window[GraphicsWindow], model[Model], flag[Flag]) [static]

Description

Unblanks all of the tshells in the model flagged with a defined flag

Arguments

window (GraphicsWindow)

GraphicsWindow) to unblank the tshells in

model (Model)

Model that the flagged tshells will be unblanked in

flag (Flag)

Flag (see AllocateFlag) set on the tshells to unblank

Returns

No return value

Example

To unblank all of the tshells flagged with flag f in model m, in graphics window gw:

Tshell.UnblankFlagged(gw, m, f);

UnflagAll(model[Model], flag[Flag]) [static]

Description

Unsets a defined flag on all of the tshells in the model

Arguments

model (Model)

Model that the defined flag for all tshells will be unset in

flag (Flag)

Flag (see AllocateFlag) to unset on the tshells

Returns

No return value

Example

To unset flag f on all of the tshells in model m:

Tshell.UnflagAll(m, f);

VonMisesStress(options (optional)[object])

Description

Returns the von Mises stress for the thick shell (or null if the value cannot be calculated)

Arguments

options (optional) (object)

Object containing options for getting data. Can be any of:

Object has the following properties:

Name	Type	Description
ip	integer	Integration point number to get the data at (ip >= 1 or one of the constants Constant.TOP, Constant.MIDDLE or Constant.BOTTOM)
op	integer	On plane integration point number for shells and thick shells (op >= 1 [default])

Returns

von Mises stress

Return type

real

Example

To return the von Mises stress of thick shell t:

var svm = t.VonMisesStress();
if (svm !== null) do_something...