Contents     Functions              PDF Index

ans2sdt

• BuildUp
• def
• conv
• read
• Def
• ESLread
• Write

Purpose

Interface between ANSYS and SDT (part of FEMLink)

Syntax

 ans2sdt('read FileName')         % .rst, .cdb, .matrix, .mode  files
 ans2sdt('write FileName')        % .cdb file
 ans2sdt('BuildUp FileName')      % .rst and .emat files
 ... = ans2sdt('def FileName.rst')% .rst or .mode files 

Description

BuildUp

ans2sdt('BuildUp FileName') reads the binary files FileName.rst for model definition and FileName.emat for element matrices. The result is stored in Up (a type 3 superelement handled by upcom). FileName.mat is used to store the superelement. Valid calls are

Up=ans2sdt('buildup file');  
[m,k]=upcom(Up,'assemble not');

For recent versions of ANSYS, you will have to manually add the ematwrite,yes command to the input file to make sure that all element matrices are written. This command is not accessible from the ANSYS menu.

There is a partial attempt to fill in element properties in Up.il. You can also use data=stack_get(model,'info','RealConstants','getdata') to obtain the cell array containing the ANSYS real constants for various elements. The index in this cell array corresponds to element ProId values.

def

def=ans2sdt('read','file.mode') reads deformations in .mode files.

To read responses .rst files you should use

 model=ans2sdt('readdef','test.rst'); % read all data
 def=stack_get(model,'curve','NSL');
 % Partial read of only specific entries  
 model=ans2sdt('rstdef','sdtforced.rst', ...
   struct('DefUse',{{'NSL'}})); % give the block names to be read

Since multiple blocks can be read, the results is saved in the model stack and can be retrieved by name using stack_get(model,'curve','NSL'); or similar calls. The standard names used by ANSYS are NSL (displacement), VSL (velocity response), RF (reaction forces), ESL (element solution, see ans2sdt ESLread). If you are interested in reading other results, please send a test case.

conv

This command lists conversion tables for elements, topologies, face topologies. You can redefine (enhance) these tables by setting preferences of the form setpref('FEMLink', 'ansys.elist',value), but please also request enhancements so that the quality of our translators is improved.

read

This command reads files based on their standard ANSYS extension.

• .matrix files are read assuming ASCII Harwell Boeing format obtained with HBMAT, Fname,Ext,--,ASCII,STIFF. RHS vectors or binary matrices are not read yet. You can read the mapping file at the same time using ans2sdt('matrix','k.txt','k.mapping'); or DOF=ans2sdt('mapping','k.mapping').
• .mode files contain deformations which are read into the usual SDT format.
• .rst files contains model information topology, some material/element properties and boundary conditions (but these are more consistently read in the .cdb), ...
  • When an .emat file is present, the read call attempts to run the BuildUp command.
  • Responses are read using a call of the form ans2sdt('readdef','file.rst'), see ans2sdt def
• .cdb input files also written by ANSYS using the CDWRITE ALL,FileName,cdb command. Please also request enhancements on the support of this format so that the quality of our translators is improved.

ANSYS does not store boundary conditions in the .rst files so that these can only be imported from .cdb file. If you only have fixed boundary conditions, you can easily generate those with

 model=ans2sdt('buildup test');         % read model
 def=ans2sdt('def test.rst');           % read deformations
 model = fe_case(model,'fixdof','Fixed_Dofs', ...
   fe_c(model.DOF,def.DOF,'dof',2));
 cf=feplot; cf.model=model; cf.def=def; % display

Def

def=ans2sdt('def FileName.rst') or def=ans2sdt('def FileName.mode') reads deformations in .rst or .mode files

ESLread

To read element output data if any, that were detected during the reading of an output file (.rst).

model=ans2sdt('ESLreadtoken',model); will generate a stack entry named ESL:token in the model that will contain the element data.

token is an element output data identifier as documented by ANSYS, and mentioned in the model stack entry info,ptrESL.

Command option groupi allows generating the output for a given group number i

Write

ans2sdt('write FileName.cdb',model) is the current prototype for the ANSYS writing capability. In ANSYS .cdb files are written with the CDWRITE ALL, FileName, cdb command. This does not currently write a complete .CDB file so that some manual editing is needed for an ANSYS run after the write.

See also

FEMLink