NAME

CAE::Nastran::Nasmod::Entity - an entity of a nastran model

SYNOPSIS

    use CAE::Nastran::Nasmod::Entity;

    # create new Entity (an empty nastran card)
    my $entity = CAE::Nastran::Nasmod::Entity->new();

	# define its content
    $entity->setComment("just a test"); # comment
    $entity->setCol(1, "GRID");         # column 1: cardname
    $entity->setCol(2, 1000);           # column 2: id
    $entity->setCol(4, 17);             # column 4: x
    $entity->setCol(5, 120);            # column 5: y
    $entity->setCol(6, 88);             # column 6: z

    # print entity to STDOUT
    $entity->print();
    

DESCRIPTION

create new entities, set data fields, extract data, match against filters and print data

API

new()

creates and returns a new Entity

# create a new Entity
my $entity = CAE::Nastran::Nasmod::Entity->new();

setComment()

sets the comment of the entity (and deletes existent comment)

# set a new comment
$entity->setComment("hi there");

# set a new comment
$entity->setComment("im the first line", "and i'm the second one");

# set a new comment
my @comment = ("i'm the first line", "and i'm the second one");
$entity->setComment(\@comment);

addComment()

adds a line of comment to an entity without deleting existent comment

# add a line
$entity->addComment("hi there");

# add a second line
$entity->addComment("i'm the second line");

setCol()

sets the value for a certain column

# set column 1 to value 'hello'
$entity->setCol(1, 'hello');

getCol()

gets the value of a certain column

# get column 1
my $value = $entity->getCol(1);

getRow()

returns all data columns as an array.

my @row = $entity->getRow();

match()

match all data against a filter. returns true if filter matches otherwise returns undef

# filter for GRID (NID=1000)
my @filter = (
    "",                   # pos 0 filters comment:  entities pass which match // in the comment. (comment => no anchors in the regex)
    "GRID",               # pos 1 filters column 1: only entities pass which match /^GRID$/ in column 1. (note the anchors in the regex)
    "1000"                # pos 2 filters column 2: entities pass which match /^1000$/ in column 2. (note the anchors in the regex)
    ""                    # pos 3 filters column 3: entities pass which match // in column 3. (empty => no anchors in the regex)
)

my $result = $entity->match(\@filter);

print()

prints the entity in nastran format to STDOUT

$entity->print();              # prints to STDOUT

TAGS

CA, CAE, FEA, FEM, Nastran, perl, Finite Elements, CAE Automation, CAE Automatisierung

AUTHOR

Alexander Vogel <avoge@cpan.org>

COPYRIGHT AND LICENSE

Copyright (c) 2012-2014, Alexander Vogel, All Rights Reserved. You may redistribute this under the same terms as Perl itself.

cpanm CAE::Nastran::Nasmod

perl -MCPAN -e shell
install CAE::Nastran::Nasmod