AMC ASAS Interface for Mathcad
Contents
1. amcsubsetnumber Jacket 20 returns the user number of the subsets which constitute load case number 20 of the model refered to as Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 19 AMC User Manual AMC Functions 4 10 Problem Solving When using AMC functions several different types of problem might arise These fall into three main groups e errors in function names and arguments e errors in values given to a function e errors in accessing the ASAS files Some problems may cause Mathcad to display its standard error indicator which is to highlight the offending function or variable in red If the erroneous expression is clicked upon an error message will be displayed This variable or function is not defined above usually means that you have mis typed the name or it may be that the amc32 d1l and or the amcinterface mcd have not been correctly installed This function needs more less arguments is self explanatory Use the Insert Function dialogue to get information about how many arguments are required for AMC functions This operation can only be performed on an array It can t be performed on a number means that the wrong type of arguments have been given such as text where a number is expected This is common when passing the model name to a function if the amcinterface mcd file has not been referenced Other problems cause AMC to display one2. 1010 for the third subset of loadcase 10 in the model defined by the variable Jacket amcgetglobal Returns all the result component information for a global result type Returned as a vector amcgetglobal model loadcase subset resulttype The components are returned in the same order as they are saved in ASAS amcgetglobal Jacket 10 3 REACTION SUM returns the global reactions for the third subset of loadcase 10 in the model defined by the variable Jacket amcgetnodal Returns all the nodal result component information for a result type at a node Returned as a vector amcgetnodal model node loadcase subset resulttype The components are returned in the same order as they are saved in ASAS amcgetnodal Jacket 3 10 11 history displacement returns the history displacement of node 3 for the 11th subset of loadcase 10 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 17 AMC User Manual AMC Functions 4 9 Miscellaneous Functions Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax amcresultant Returns the global load resultants for a specified load case Returned as a vector amcresultant model loadcases The total
3. 4 7 AMC User Manual AMC Functions 4 5 Beam Specific Functions Function Purpose Syntax Notes Example amcbeamaxis Returns the direction cosine components for beam element local axes Returned as a vector amcbeamaxis model element The direction cosine vector is returned as follows XX XY XZ YX YY YZ ZX ZY ZZ Where XY corresponds to the Y component of the local X axis The axis information returned relates to the final member orientation i e taking account of any rigid offsets amcbeamaxis Jacket 1001 returns the local axes direction cosines for element 1001 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 8 AMC User Manual AMC Functions Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example amcbeamforce Returns the forces and moments on a beam element for a given loadcase Returned as a vector amcbeamforce model element loadcase The forces and moments vector is returned as follows FX QY QZ MX MY MZ FX QY gt QZ MX MY MZ Where QY corresponds to the Y shear force at end 1 Results for non beam elements may be obtained with the amcelementresults function amcbeamforce Jacket 2050 10 returns the forces and moment
4. affiliates under a software license agreement that contains provisions concerning non disclosure copying length and nature of use compliance with exporting laws warranties disclaimers limitations of liability and remedies and other provisions The software products and documentation may be used disclosed transferred or copied only in accordance with the terms and conditions of that software license agreement ANSYS Inc is certified to ISO 9001 2008 U S Government Rights For U S Government users except as specifically granted by the ANSYS Inc software license agreement the use duplic ation or disclosure by the United States Government is subject to restrictions stated in the ANSYS Inc software license agreement and FAR 12 212 for non DOD licenses Third Party Software The products described in this document contain the following licensed software that requires reproduction of the following notices Formula One is a trademark of Visual Components Inc The product contains Formula One from Visual Components Inc Copyright 1994 1995 All rights reserved See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software and third party software If you are unable to access the Legal Notice please contact ANSYS Inc Published in the U S A Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates AMC User Manual Update Sh
5. of a specified node Returned as a vector amcnodecoor model nodenumber Co ordinates that were defined in the ASAS data in a system other than the global Cartesian system are converted prior to storage on the ASAS database The original definition cannot be retrieved amcnodecoor Jacket 1010 returns the global co ordinates for node 1010 in the model defined by the variable Jacket amcdisplace Returns the global displacements at a node for a specified load case Returned as a vector amcdisplace model node loadcase The displacements are returned in the same order that they are reported in ASAS If the node is skewed the displacements are in the skewed directions amcdisplace Jacket 1010 10 returns the displacement vector at node 1010 for loadcase 10 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 14 AMC User Manual AMC Functions Function amcreaction Purpose Returns the global reactions at a node for a specified loadcase Returned as a vector Syntax amcreaction model node loadcase Notes The reactions are returned in the same order that they are reported in ASAS If the node is skewed the reactions are in the skewed directions Example amcreaction Jacket 1010 10 returns the reaction vector at node 1010 for loadcase 10 in the model defined by the variable Jacket Contains proprietary and confidenti
6. AMC ASAS Interface for Mathcad Version 12 1 ANSYS Inc Southpointe 275 Technology Drive Canonsburg PA 15317 ansysinfo ansys com http www ansys com T 724 746 3304 F 724 514 9494 Copyright 2009 SAS IP Inc All Rights Reserved Unauthorised use distribution or duplication is prohibited ANSYS Inc is certified to ISO 9001 2008 Revision Information The information in this guide applies to all ANSYS Inc products released on or after this date until superseded by a newer version of this guide This guide replaces individual product installation guides from previous releases Copyright and Trademark Information 2009 SAS IP Inc All rights reserved Unauthorized use distribution or duplication is prohibited ANSYS ANSYS Workbench AUTODYN CFX FLUENT and any and all ANSYS Inc brand product service and feature names logos and slogans are registered trademarks or trademarks of ANSYS Inc or its subsidiaries located in the United States or other countries ICEM CFD is a trademark used by ANSYS Inc under license All other brand product service and feature names or trademarks are the property of their respective owners Disclaimer Notice THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFIDENTIAL AND PROPRIETARY PRODUCTS OF ANSYS INC ITS SUBSIDIARIES OR LICENSORS The software products and documentation are furnished by ANSYS Inc its subsidiaries or
7. Notes Example Function Purpose Syntax Notes Example amcrundate Returns the date and time for a given analysis Returned as a string amcrundate model This function returns a 17 character text string containing the date and time in the form 08 41 21 01 09 amcrundate Jacket returns the date and time information for the model defined by the variable Jacket amcruntitle Returns the title used for a given analysis Returned as a string amcruntitle model This function returns an 81 character text string containing the title in the form Example 2 1 Extreme Wave Analysis amcruntitle Jacket returns the title for the model defined by the variable Jacket amcprogversion Returns the program name and version information associated with a particular analysis amcprogversion model This function returns a 26 character description in the form ASAS 12 00 01 0 amcprogversion Jacket returns the program information for the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 6 AMC User Manual AMC Functions Function Purpose Syntax Notes Example Function Purpose Syntax Notes Function Purpose Syntax Notes Example amcunits Returns the units associated with a particular analysis Returned as a vector of strings amcunits model The unit names are retu
8. S 4 18 4 10 Problem Solving Wii 4 20 22 FE Ee AAA E E E E E E E ee 4 21 412 A a A a E A A A a s 4 21 4 13 Model Updates iiien neseserai arareo ests shes soteer oo de bavesastessesb geshegsved ssbessdedenescehestpsben SEEE iet 4 22 Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates i AMC User Manual Overview 1 Overview 1 1 Introduction AMC is an interface from ASAS to Mathcad It is intended to facilitate the development of Mathcad worksheets that require data from ASAS databases The interface consists of a series of functions that can be accessed within the worksheet to recover data directly from the ASAS database A typical example might be an application that tabulates forces in a particular member for several load cases and then undertakes a post processing exercise Key features are e Direct access to the ASAS database information using Mathcad Function calls e Recovery of element forces using element number and load case e Recovery of nodal displacements reactions using node number and load case e Error trapping e Simple installation e Cross platform interrogation of ASAS databases 1 2 Compatibility The functions are designed to work with Mathcad Professional Version 7 and subsequent versions running under Microsoft Windows The interface program does not require an ASAS dongle or security file to operate Contains proprietary and confidential informa
9. al information of ANSYS Inc and its subsidiaries and affiliates Page 4 15 AMC User Manual AMC Functions 4 8 Results Database Functions The following four functions can only be used with the new Unified Results Storage Database Therefore it is necessary to include the option RESU in the ASAS ASAS NL etc data file This will then produce a physical 45 file which the functions below will extract information from Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes amcgetelement Returns all the result component information for a result type at an element Returned as a vector amcgetelement model element loadcase subset resulttype The components are returned in the same order as they are saved in ASAS amcgetelement Jacket 2 10 3 stress returns the stresses applied at element 2 for the third subset of loadcase 10 in the model defined by the variable Jacket amcgetelementex Returns the requested element result extended for additional result availability amcgetelementex model element load subset result type result component surface node result position This is an extended version of amcgetelement all input is the same as that except for the result component additional surface node and result position which means that it acts the same as the function in AXL and returns a single value The additional par
10. ameters identify the particular component the surface on which it is to be obtained and the local element node number 1 to max number of nodes on the element and an optional result position which is used for results where there are multiple values of a result component for example STRESS in a time history based FATJACK analysis with rainflow counting amcgetelementex c ABCD WXYZ 72 11 1 RANGE HISTOGRAM STRESS 1 2 10 returns the 10 STRESS in the RANGE HISTOGRAM values at the second node on the first surface of element 72 The results are retrieved for the 11 loadcase 1 subset within the project ABCD structure WXYZ located in C amcgetelementflt Returns the requested element result filtered based on the given information amcgetelementflt model element load subset result type result component surface node result position filter type This is an extended version of amcgetelementex however it allows for the filtering of a range of values to be obtained Model result type result component and result position all function as per amcgetelementex The filtering is controlled by the filter type and requested value for which the following should be entered Filter type Filtering algorithm 1 Maximum 2 Minimum 3 Absolute Maximum i e furthest from zero 4 Absolute Minimum i e closest to zero Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliat
11. art Mathcad as usual e If you are creating a new worksheet use Insert Reference to make a link to the appropriate amcinterface xmcd file located in your ASAS installation amc interface mathcadxx folder the insertion should be undertaken at a point in the document which precedes where the AMC functions are to be utilised This brings up a dialogue window as follows Insert Reference Eg Insert reference to file C WINMCAD userefi amcinterface med Enter or locate the path to the document you want to reference This can be a document on your hard drive or a document on your company s network Jo Use relative path for reference OK Cancel The path and name of the interface file can either be typed directly or the Browse button may be used to locate the worksheet e Alternatively select ASAS worksheet from the File New Worksheet Templates This is a simple worksheet that contains the necessary reference to the amcinterface mcd file together with some basic function calls to assist in creating the ASAS interface e If an existing worksheet requires the interface to be added the reference file should be inserted before the point at which the AMC functions are to be employed AMC functions are included in formulae just like ordinary Mathcad functions such as sin cos max etc If you cannot remember the order or meaning of the arguments to the function use Mathcad s Insert Function dialogue box the AMC func
12. confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 12 AMC User Manual AMC Functions 4 6 Element Specific Functions Function Purpose Syntax Purpose Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example amcelementnode Returns the node numbers on an element Returned as a vector amcelementnode model element Nodes are returned in the same order as they are defined in the ASAS data amcelementnode Jacket 2050 returns the node numbers on element 2050 in the model defined by the variable Jacket amcelementtype Returns the ASAS element type Returned as a string amcelementtype model element This function returns the four character name by which an element type is identified within the ASAS system e g TUBE BM3D QUM4 etc amcelementtype Jacket 1001 returns the ASAS element type for user element 1001 in the model defined by the variable Jacket amcelementresults Returns forces or stresses for any type of element amcelementresults model element loadcase All the results for one load case on an element are stored as a list of numbers by ASAS It is necessary to know the order of the results and the node numbering of the element to extract the required result The amcbeamforce function should be used for retrieving results for the standard three
13. dimensional beam elements amcelementresults vessel 2050 10 returns the stresses associated with element number 2050 for loadcase 10 in the model defined by the variable vessel amcuserelementlist Returns the list of user element numbers amcuserelementlist model The element numbers are returned in ascending order Components are excluded from this list The number of elements in the model may be found using the Mathcad function rows e g NumberOfElements rows amcuserelementlist model amcuserelementlist Jacket returns the user element numbers for the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 13 AMC User Manual AMC Functions 4 7 Node Specific Functions Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example amcnodenumberlist Returns the list of user node numbers Returned as a vector amcnodenumberlist model The node numbers are returned in ascending order Non structural nodes those not connected to elements are excluded The number of nodes in the model may be found using the Mathcad function rows E g NumberOfNodes rows amcnodenumberlist model amcnodenumber Jacket returns the node numbers for the model defined by the variable Jacket amcnodecoor Returns the global co ordinates
14. ed recalculating if none of these numbers have changed It does not take account of the fact that the data in files outside Mathcad may have changed To force all the results to be reloaded select Math Calculate Worksheet from the main menu bar Mathcad will recalculate the worksheet and update all the values Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 22
15. eet for Version 12 1 November 2009 Modifications The following modifications have been incorporated Section Page s Update Addition Explanation Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates AMC User Manual Contents TABLE OF CONTENTS De A cach EA E EE EA AEA E EA E E EOE 1 1 1 1 NS ei ESEE E EE AEE SE EEEE ee ere 1 1 1 2 Compatibility esesten rea oeer EEE rE sp E EEES EE TEE E EE E EErEE EErEE Ee ESTE EE 1 1 PAR E NS 2 1 2 1 Installing AMG aia iio ed Ah a ha Rea alae aes 2 1 3 Running AMECA eis Bale eh ee 3 1 3 1 Using AME Functions esi scysscsssestessseestesdenessadevveedebssccostssvessssdsveceubbivesscesseasves sgtuabcodebasops sveushgnussssestasosses 3 1 Ao CS dvcsvnectautded dendovsecseesteds deesthoesenstadesteotneds ceavesedeusthwesectuedevteotsecsesss 4 1 4 1 Functional Intertace 23s ccccist SE T RAE EE ASE E O cnesvodoudepiceuemtetehebesbenen tee 4 1 4 2 Function Description O 4 2 4 2 1 D scipt ROO 4 2 4 2 2 Function Return Valles iii A CENNE 4 3 4 3 Available Functions dd ce 4 4 4 4 Administrative FUN AOS a a a r a r a A r e era na aR 4 6 4 5 Beam Specific Functions A OS 4 8 4 6 Element Sp cific FUNCHUONS verdeo int suse Oaa eoa Ea or iE 4 13 4 7 Node Specific FUNCUONS sieren ei e is rentar ven Bae is oa EEES EE A EE EE ASEOS e 4 14 4 8 Results Database Functions sosina e EE O N R 4 16 4 9 Miscellaneous Functions einn eren r a E E E E E E EE ETR
16. es Page 4 16 AMC User Manual AMC Functions Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Element load subset surface and node should have either a particular value assigned to limit the searching to a particular set of results or 1 entered to loop over each result available e g entering a loadcase of 1 will mean that all loadcases will be searched according to the filter type and requested value The retuned array will have rows of results as follows Return type Returned Result 1 Value of Result 2 Element Number at which the value can be found 3 Load Case Set for which the value can be found 4 Load Subset for which the value can be found 5 Surface at which the value can be found 6 Local node at which the value can be found amcgetelementf1t c ABCD WXYZ 1 100 0 API LRFDALLOED1 UC UC AXIAL 1 1 1 2 returns the array of values for all positions on all elements for loadcase 100 The results are retrieved for the project ABCD structure WXYZ located in C amcgetequation Returns all the result component information for a result type at a node Returned as a vector amcgetequation model node loadcase subset resulttype The components are returned in the same order as they are saved in ASAS amcgetequation Jacket 1010 10 3 displacement returns the displacements for node
17. esponds to the thickness of the top and bottom plates amcbeamsect jacket 1001 returns the section properties for element 1001 in the model defined by the variable Jacket amcbeamsectname Returns the section name s associated with a beam element For unstepped beams a string is returned otherwise a vector of strings is returned amcbeamsectname model element If section data has not been defined an error code will be returned Each section name recovered may be up to 12 characters long amcbeamsectname jacket 1001 returns the section name associated with element 1001 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 11 AMC User Manual AMC Functions Function Purpose Syntax Notes Example amcbeamsecttype Returns the section profile type s for a beam element amcbeamsecttype model element If section data has not been defined an error code will be returned Profiles returned will be one of the following Wide Flange Tube Fabricated Box Rolled Hollow Section Tee Angle Section Channel Prismatic Currently ASAS only permits stepped beams to consist of a common section type so this function will always return the same type for each step amcbeamsecttype jacket 1001 returns the section type of element 1001 in the model defined by the variable Jacket Contains proprietary and
18. etelementflt amcgetequation amcgetglobal amcgetnodal Miscellaneous Functions amcresultant amcgetequation amcloadnames amcgroupnumber amcgroupelements amcloadtimestep amcmodeltimestep amcnumberincrements amcsubsetnumber Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Returns analysis date and time for model Returns analysis title for model Returns the program name and version of the program utilised to create the database entry for the model Returns the units employed for the analysis of model Returns the version of the Mathcad interface Returns the list of models that exist in a given project file Returns beam local axes as direction cosines for the given element in the model Returns beam flexural properties for the given element in the model Returns beam local offsets for the given element in the model Returns beam section properties for the given element in the model Returns beam section type for the given element in the model Returns beam section name for the given element in the model Returns beam section forces for the given element and loadcase in the model Returns element forces for the given element and load in the model Returns the element type for the given element in the model Returns the list of user element numbers in the model Returns the node numbers associated with a given element in the model Returns the list of user node numbers in the model R
19. eturns the coordinates of a given node on the model Returns the global displacements for a given node and loadcase in the model Returns the global reactions for a given node and loadcase in the model Returns all the result component information for a result type at an element Returns the requested element result extended for additional result availability Returns the requested element result filtered based on the given information Returns all the result component information for a result type at a node Returns all the result component information for a global result type Returns all the nodal component information for a result type at a node Returns the global load resultants for a given loadcase in the model Returns the loadcase numbers that were utilised in the model Returns the loadcase names that were defined in the model Returns the user group numbers within a model Returns the user element numbers within a group Returns the time steps of the subsets within a load case Returns the time steps of loads and subsets within a model Returns the number of increments within a model Returns the user number of the subsets within a load Page 4 4 AMC User Manual AMC Functions Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 5 AMC User Manual AMC Functions 4 4 Administrative Functions Function Purpose Syntax Notes Example Function Purpose Syntax
20. h of the element after the application of offsets For stepped beams the length returned is for each step For properties that are not applicable to a particular beam type a value of zero will be returned amcbeamprop Jacket 1001 returns the properties for element 1001 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 10 AMC User Manual AMC Functions Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example amcbeamsect Returns the section dimensions for a beam element For unstepped beams a vector is returned otherwise a matrix is returned with each column representing a step amcbeamsect model element The properties for each step are returned as follows diameter TUB thickness TUB depth WF RHS BOX TEE ANGL CHAN PRI web thickness WF RHS BOX TEE ANGL CHAN breadth WE RHS BOX TEE ANGL CHAN PRI flange thickness WF RHS BOX TEE ANGL CHAN fillet radius WF RHS CHAN ANGL TEE If section data has not been defined an error code will be returned For TUBE elements however the dimension information can still be retrieved using this function For RHS and ANGL sections only one thickness is defined Both TW and TF are set to this value For BOX sections TW corresponds to the thickness of the side plates For BOX sections TF corr
21. ions directly The effort involved can be seen by double clicking on the reference icon this will bring up the interface file There is no advantage to be gained by using the DLL functions directly so this should be avoided at all times The functions are designed to be relatively straightforward to use All arguments are in terms of user numbers user element number user loadcase number etc rather than ASAS internal numbers The AMC interface requires no special configuration no start up macros etc Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 1 AMC User Manual AMC Functions 4 2 Function Description There are five main classes of function Administrative functions that return run time information for a particular analysis Beam specific functions that provide information that is particular to the two node beam elements Element specific functions that give information about any element type in ASAS Node specific functions that return nodal information Miscellaneous functions returning information such as load names and numbers GR ators The list of functions below is complete at the time of writing but more functions will be added as and when necessary 4 2 1 Description Many of the functions start with an argument called model in the descriptions below This argument defines the ASAS project the structure or component being investigated and the d
22. irectory in which the files are located It is a string consisting of three parts separated by semi colons directory project structure component tree so for example C USER PROJ PILE JACO would specify a component with the assembled name JACO in structure PILE which is in an ASAS project called PROJ with all the files stored in a directory called USER on drive C The best way of entering this data 1s to create a variable that is equated to the model description e g model clasasidemo 1 proj jack The variable model can then be used in a call to any of the AMC functions that require the model name Thus the example in section 3 1 could be rewritten as model CAALPHA PLAT JACK amcdisplace model 2020 401 Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 2 AMC User Manual AMC Functions 4 2 2 Function Return Values Functions may return either e A single value or string such as the run title e A vector containing more than one value or string such as the element forces on an element for a given loadcase e A matrix of results such as the section properties for a stepped beam where each column corresponds to a step and each row is for a given property In certain circumstances a function may return either a vector or a matrix as is the case of the function returning section properties for a beam unstepped beams return a vector stepped beams return a mat
23. load resultant is that calculated by ASAS during the data check Hence it will be inaccurate if the resultant load calculated during the data check is inaccurate amcresultant Jacket 1010 returns the load resultant for loadcase 1010 in the model defined by the variable Jacket amcloadnames Returns the titles of the loadcases analysed Returned as a vector of strings amcloadnames model If only one loadcase has been analysed then this function returns a variable amcloadnames Jacket returns the loadcase titles in the model defined by the variable Jacket amcloadnumbers Returns the user loadcase numbers employed in an analysis Returned as a vector amcloadnumbers model If only one loadcase has been analysed then this function returns a variable amcloadnumbers Jacket returns the user loadcase numbers for the model defined by the variable Jacket amcgroupnumber Returns the user group numbers within a model Returned as a vector amcgroupnumber model Group number zero contains all those elements not specified by a group Amcgroupelements Jacket returns the user group numbers within the model referred to as Jacket amcgroupelements Returns the user element numbers within a group Returned as a vector amcgroupelements model group Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 18 AMC User Manual AMC Functions Notes Example Function Purp
24. of its own error messages These messages are generally self explanatory A list of these errors is given in the appendix below Some general rules for solving problems are e Check that the model files are readable by using the amcuserelementlist function If this cannot retrieve the element list then either the model data is incorrect or there is something wrong with the ASAS files e Ifan error message is described as unable to open file this usually means that something in the first part of the function call is wrong perhaps the directory name is wrong or the project or structure name Perhaps the files have been deleted e If the ASAS analysis has been re run since the worksheet was last used make a null edit of the variable defining the ASAS model and Mathcad will re calculate as if you had changed the model even though you know that you have not This may clear up problems due to Mathcad displaying out of date results The individual functions in the DLL are designed to be fairly robust so they will not cause Mathcad or Windows to crash in the event of problems They only read from ASAS files so cannot corrupt any data It is however not advisable to attempt to read from an ASAS backing file at the same time as an ASAS program is trying to write to it Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 20 AMC User Manual AMC Functions 4 11 Restrictions All
25. ose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Function Purpose Syntax Notes Example Group number zero will return all those elements not specified by a group amcgroupelements Jacket 3 returns the user element numbers within group 3 of the model referred to as Jacket amcloadtimestep Returns the time steps of the subsets within a load case Returned as a vector amcloadtimestep model loadcase The results will be in the order as they appear in the database amcloadtimestep Jacket 3 returns the time steps of the subsets of load number 3 of model Jacket amcmodeltimestep Returns the time steps of loads and subsets within a model Returned as a vector amcmodeltimestep model The results will be in the order as they appear in the database amcmodeltimestep Jacket returns the time steps of the loads and subsets of model denoted by Jacket amcnumberincrements Returns the number of increments within a model Returned as a scalar amcnumberincrements model This function is primarily designed to be used with ASAS NL results amcnumberincrements Jacket returns the number of increments within the model refered to as Jacket amcsubsetnumber Returns the user number of the subsets within a load Returned as a vector amcsubsetnumber model load This function is primarily designed to be used with ASAS NL results
26. results should be checked by the user There are no facilities for writing information back to the ASAS files The DLL functions can be accessed directly from Mathcad bypassing the amcinterface mcd However this is not recommended because of the need to pass strings as numerical vectors which requires the use of the Mathcad functions vec2str and str2vec 4 12 Performance The AMC functions are designed for convenience not speed The functions in the DLL do include some local caching to reduce the amount of file access when a single model is being used However they do perform a lot of input from the ASAS file system to retrieve even small amounts of data since they comply with the general Windows recommendation for not keeping files open between calls which also means that they do not require initialisation or close down and should not cause system problems if the ASAS files are updated while Mathcad is running Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 21 AMC User Manual AMC Functions 4 13 Model Updates Like all spreadsheet programs Mathcad tries to avoid doing unnecessary recalculation If nothing has changed in a spreadsheet it does not automatically recalculate it This can cause a problem with ASAS results where models may have been rerun As far as Mathcad is concerned a function asking for say the forces in member 123 at node 567 for load case 89 does not ne
27. rix Users should be aware that Mathcad treats vectors and matrices in a different fashion but access to these variables may be controlled by determining the number of columns of the return from a function call This can be obtained by use of the Mathcad function cols which returns the number of columns associated with a variable Thus cols amcbeamprop model 1001 would provide how many steps are associated with beam element number 1001 in the model There are no explicit functions for returning the number of elements nodes or loadcases in an analysis This can be achieved instead by using the Mathcad function rows when retrieving appropriate lists Thus rows amcuserelementlist model would give the number of elements used in the analysis associated with model Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 3 AMC User Manual AMC Functions 4 3 Available Functions FUNCTIONS DESCRIPTION Administrative Functions amcrundate amcruntitle amcprogversion amcunits amcversion amcgetmodel Beam Specific Functions amcbeamaxis amcbeamprop amcbeamoffset amcbeamsect amcbeamsecttype amcbeamsectname amcbeamforce Element Specific Functions amcelementresults amcelementtype amcuserelementlist amcelementnode Node Specific Functions amcnodenumberlist amcnodecoor amcdisplace amcreaction Results Database Functions amcgetelement amcgetelementex amcg
28. rned in the following order FORCE LENGTH ROTATION MASS TEMPERATURE TIME If units were not used in the analysis an appropriate error message is returned Each unit name may be up to 13 characters amcunits Jacket returns the units used in the model defined by the variable Jacket amcversion Returns a text string identifying the version of the interface worksheet file amcinterface mcd and the associated dynamic link library amc32 dll which are currently being used This is mainly intended so that support personnel can identify possible problems due to the use of superseded software amcversion dummy This returns a string similar to AMC MCD Version 7 00 00 0 AMC32 DLL Version 12 00 01 0 Note that the function requires a dummy argument amcgetmodel Returns the list of component and structure names or models stored in the project file Returned as a vector of strings amcgetmodel Directory Project Directory is the full path name of the directory in which the project file is stored e g C USER Project is the four character identifier of the ASAS project An entry for a component does not imply that results exist for any instance of the component amcgetmodel C USER PROJ returns the list of components and structures stored on the project PROJ residing in the directory C USER Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page
29. s for element 2050 for loadcase 10 in the model defined by the variable Jacket amcbeamoffset Returns a beam element rigid offset information in terms of the element local axes Returned as a vector amcbeamoffset model element The offset vector is returned as follows X Y Zi X gt Yo Za Where Xi 1s the offset at end 1 of the beam for the local x axis If an offset has not been defined a value of zero will be returned amcbeamoffset jacket 1001 returns the offsets for element 1001 in the model defined by the variable Jacket Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 4 9 AMC User Manual AMC Functions Function Purpose Syntax Notes Example amcbeamprop Returns the flexural properties for a beam element such as length area inertia etc For unstepped beams a vector is returned otherwise a matrix is returned with each column representing a step amcbeamprop model element The properties for each step are returned as follows Element or step length GRIL BM2D BM3D BEAM TUBE Area GRIL BM2D BM3D BEAM TUBE Inertia about Y axis GRIL BM3D BEAM TUBE Inertia about Z axis BM2D BM3D BEAM TUBE Torsion constant GRIL BM3D BEAM TUBE Shear area for Y axis BM2D BM3D TUBE Shear area for Z axis GRIL BM3D TUBE For unstepped beams the length returned is the total physical lengt
30. tion of ANSYS Inc and its subsidiaries and affiliates Page 1 1 AMC User Manual Installation 2 Installation 2 1 Installing AMC The notes below relate to Version 13 0 of Mathcad Earlier versions may differ slightly from the suggested installation The MathCAD installation folder is normally c program files mathsoft mathcad 13 however this may be different on your system Due to the various different versions of Mathcad available there are some files that need to be manually moved to complete the installation of ASAS these are located in your ASAS installation folder if you are not confident in this procedure we suggest you consult your IT services provider Copy the file AMC32 DLL to the MathCAD userefi folder from ASAS amc dll Copy the file ASAS worksheet xmct to the MathCAD Template folder from ASAS amc Interface mathcad13 Replace the MathCAD doc fundoc user_EN xml amp MathCAD doc help_EN user userman htm files with those provided in the amc interface mathcad13 folder if you have previously edited these files or have performed a similar procedure for another software provider then you may need to merge each of these files before you can use the Insert Function feature of MathCAD Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 2 1 AMC User Manual Running AMC 3 Running AMC 3 1 Using AMC Functions AMC is simple to use as follows e St
31. tions are listed together with those supplied with Mathcad A simple example is shown below amcdisplace C ALPHA PLAT JACK 2020 401 This function returns the displacement vector for node 2020 in load case 401 for the specified structure JACK in project PLAT stored in directory C ALPHA Contains proprietary and confidential information of ANSYS Inc and its subsidiaries and affiliates Page 3 1 AMC User Manual AMC Functions 4 AMC Functions 4 1 Functional Interface The ASAS interface for Mathcad consists of two main parts e a dynamic link library called amc32 dll e a referenced Mathcad worksheet called amcinterface xmcd The dynamic link library or DLL is a set of functions written in the C language These functions understand enough about the ASAS file system to extract information from it The referenced worksheet provides an interface to the functions stored on the dynamic link library DLL to access the ASAS file system These functions can be used like any other functions in a Mathcad worksheet All the functions have names starting with the prefix amc and can be inserted via the insert function menu option Note that the DLL functions can be called directly by omitting the reference to the interface file This is not recommended however since it is not possible to pass text strings directly to and from the DLL functions it will be necessary to undertake string conversion before and after calling the funct
Download Pdf Manuals
Related Search