Learning the Basics

2 Running and configuring Adams

Running and Configuring Adams
This section of the online help provides you with instructions for running and setting up the Adams® suite of products. It describes:
• Running Adams products. • Creating user dynamic-link libraries that extend the functionality of Adams and run them with

the associated Adams products.
• Configuring Adams products so they work the way you want them to.

Installing Adams
The install guides for UNIX and Windows can be accessed throught MSC.Software support website.
View an electronic version (PDF) of the guides

Adams Interfaces
There are four types of interfaces that you can use to access Adams products and create libraries of custom operations for the products:
• Adams Toolbar (on UNIX only)- The Adams Toolbar is your starting point to using Adams

products. The Toolbar gives you access to the major products you installed. It uses a registry service that maintains values and settings that you need when running Adams.
• Adams Program Folder (on Windows only) - The Adams program folder is your main starting

point for running and customizing Adams products.
• Adams Selection Menu - The Selection Menu is a menu- and text-based interface that allows you

to enter information on the command line. You can enter all of the commands on one line to quickly start the product. Note that you cannot access all products nor change all settings from the Selection Menu.
• Command-Line Parameters - You can enter command-line parameters at the command prompt to

run Adams. Although you can use the Adams Selection Menu, on UNIX we recommend that you use the Adams Toolbar because it provides an easy-to-use interface and lets you run all products. Because of its advantages, this online help focuses on how to run and configure Adams products using the Adams Toolbar. For information on how to use the Adams Selection Menu, see Selection Menu.

Adams Program Folder on Windows
The Adams program folder on the Start menu is your starting point for running and customizing Adams products. It provides you with access to all the Adams products which you installed. Note that if you are not licensed to run a product, it will not run even though it is in the program folder.

Learning the Basics 3

Each of the Adams products is listed in the Adams program folder. You may have fewer items than shown in figure above, depending on which products you installed. the program folder also contains options for creating and running user libraries, for setting Application defaults, and for generating problem reports. The following table groups the options by their function. For example, it groups all options that run products

4 Running and configuring Adams

The option: Product group: Adams/Car Adams/Driveline Adams/Chassis Adams/Flex Adams/Insight Adams/PostProcessor Adams/Solver Adams/View Adams - Command

Does the following: Runs Adams products. The run options are described in Running Adams Products on Windows and Running Adams Products on UNIX.

Opens the Adams Selection Window in a Windows command shell.
• Creates user libraries of user-written subroutines to customize

Adams products. For more information, see Creating User Libraries. Adams - License Setup Sets up passwords and a license server to manage access to Adams products. See the Adams Installation and Operations Guide for more information. Starts the Adams online help. Opens the Adams release notes in your default browser. Allows you to control the look of your screen through the graphics drivers and select the amount of memory you need for your model. For more information, see Setting Preferences for Adams on Windows or on UNIX. Creates a troubleshooting report that examines your system configuration and places important debugging information in the file adams_problem_report.txt. For more information, see Troubleshooting. Opens FLEXlm where you can configure your license. Refer to the Adams Installation and Operations Guide for more information.

Adams-Online Help Adams-Release Notes Adams-Settings

Adams Troubleshooting Report FLEXlm Configuration Utility

Adams Toolbar on UNIX
The Adams Toolbar provides access to many of the Adams major products, which all have tools on the Toolbar as shown in the figure below. Adams also has add-on modules or plugins, which expand the functionality of the major products, such as Adams/Controls, Adams/Durability, and Adams/Vibration.

manage memory models. Hold the cursor over a tool to see the name of the associated product. you need to know the command to display the Adams Toolbar.Right click to set up Toolbar.Click to run product or right-click to configure products and create user libraries. Deleting a tool does not remove it permanently. for example adams07r1). To start the Adams Toolbar: • Enter the command to display the Adams Toolbar (the standard command that MSC. The Adams Toolbar appears as shown next: Adams Toolbar tool . and templates that come with Adams products. access online help and Technical Support resources and more Product tools . . you first run Adams/Car or Adams/View and then select the command to run Adams/Vibration. See your system administrator for assistance. • Displaying the Toolbar • Setting Up the Toolbar • Exiting the Adams Toolbar • Viewing Licensing Information Displaying the Toolbar Your system administrator typically sets the command required to run the Adams Toolbar. to run Adams/Vibration. Setting Up the Toolbar You can change the orientation of the Adams Toolbar and remove tools representing products that you do not use frequently. Therefore. It is also helpful to know where the software is installed so you can troubleshoot and access examples. demonstrations. before you begin. you can still restore it.Software provides is adams07x where x is the version number.Learning the Basics 5 You run these products from within the major products. For example.

. Note: If you would like to remove a product tool from the Toolbar. After viewing the information. you must first be sure that the tool is not set to run the product with a user library. For example. and then select Reset Icons. right-click the tool. Viewing Licensing Information Using the Adams Toolbar. the number of licenses you have purchased. and then select Remove from Toolbar. To restore all tools to the Toolbar: • Right-click the Adams Toolbar tool. To remove a product tool from the Toolbar: • Right-click the tool you want to remove. see Adams/View Preferences. point to Support. and then select Exit. and select Horizontal or Vertical depending on the current orientation of the Toolbar. The listing includes the major version of the products you are running. select Close. and then select License Information. To check what a product tool is set to run. and the date when the licenses expire. to remove the Adams/Insight tool. To view licensing information: 1. and then select Remove Adams/Insight from Toolbar. Exiting the Adams Toolbar To exit the Adams Toolbar: • Right-click the Adams Toolbar tool. 2. If it is. you can only select to remove the library. The Adams License Information dialog box appears. Right-click the Adams Toolbar tool.6 Running and configuring Adams To change the orientation of the Toolbar: • Right-click the Adams Toolbar tool. you can generate a listing of the software for which you are licensed.

A Windows example is shown next. It contains a list of options.Adams 2007 x (where x is the release number). point to MSC. Before you begin. and then select Adams . .Software. • On UNIX: Enter the command to run the Adams Selection Menu. To start the Selection Menu: • On Windows: • From the Start menu. It provides you with access to all the Adams products for which you are licensed. The Adams Selection Menu appears. for example adams07r1. point to Programs.Learning the Basics 7 Selection Menu The Adams Selection Menu is a command-line interface for building and running Adams products. or selection codes. point to MSC. for the products for which you are licensed. The standard command that MSC.Software provides is adams07x -c where x is the version number. therefore. • Enter the command to run the Adams Selection menu. • Displaying the Selection Menu • Entering Selection Codes • Getting Help • Exiting the Selection Menu Displaying the Selection Menu Your system administrator can change the command to run the Adams Selection Menu to access Adams products.Command. • Where the software is installed. you need to know: • The command to run the software.

Runs the MSC. aview. Runs standard Adams/Solver. and for certain products.8 Running and configuring Adams • The following table explains all the possible selection codes available from the Adams Selection Menu: The code: cr-user Does the following: Leads you through the creation of an Adams analysis product user library. A user library is one or more userwritten subroutines. appt. refer to the Adams/Flex online help. Runs the Adams/Flex toolkit. Creates a library for the Adams analysis products: Adams/Solver and Adams/Tire. ainsight flextk redit rtool Runs the MSC.Software registry shell tool. leads you through the creation of the user libraries. Runs Adams products with and without user libraries.Software registry in stand-alone mode. . Runs Adams/Solver with a user library. For more information on the Adams/Flex toolkit and MNF files. adriveline. ru-standard ru-user acar. which lets you view and work with a modal neutral file (MNF). which describes a flexible body.

exit help Returns to the system level. it returns to the operating system prompt.Learning the Basics 9 The code: cmm Windows only Does the following: Runs a Python tool prompting you to enter various uconfg parameter sizes. Entering Selection Codes To perform operations through the Adams Selection Menu. you can enter help or h to get help. exiting at any of the other prompts returns you to this menu.dll is created. h to indicate help. you can use e to indicate exit. If you use an incorrect abbreviation and get an error message. the Adams Selection Menu returns. For example. Whenever you complete or interrupt a program. ru-s to indicate ru-standard. press Enter to continue. Getting Help Anytime that you are using the Adams Selection Menu. Displays information about each of the other choices. You can use either upper. . you enter a selection code. and av to indicate aview. If you enter exit at the Selection Menu. after the prompt at the bottom of the screen.or lower-case letters. and you can abbreviate to the shortest unique abbreviation (except when entering file names). Help text appears in the window. Exiting the Selection Menu You can enter exit or its abbreviation (e) at any prompt to exit from the prompt and return to the Selection Menu. press Enter. To exit from the help. A new uconfg_user.

To enter command line parameters. As the command executes.f). build a user library in interactive mode.10 Running and configuring Adams Command-Line Parameters In addition to using the Adams Selection Menu and entering selection codes and responding to prompts. If you make an error in a command-line parameter. be sure the .dll In this example. The system level returns after linking the library file.f -n cam. Windows Example For example.c extension is lowercase. Because the last e is a response to the menu. an error message appears and prompts you to enter exit. You must use spaces to separate the various parameters. the following command-line parameters create a user library named library cam. you can enter command-line parameters. the command aborts and displays the Adams Selection Menu. If you enter exit. followed by a series of strings representing prompt selections. use -none or its abbreviation (-n). To indicate pressing Enter. the y answers the question about working in debug mode and the -n indicates a return in response to the second subroutine file prompt.dll: c:> adams07r1 cr-u y sub.o -n cam. the -n indicates pressing Enter in response to the second subroutine file prompt and e represents exit. When entering source files. the operating system prompt returns after creating the library file. . UNIX Example For example. and name the library cam. You enter command-line parameters at the operating system prompt. the following command-line parameters compile and link the Adams/Solver code to the object version of a subroutine (sub. Use spaces to separate the various parameters. You can enter the complete selection codes or abbreviations. you enter the command to run Adams Selection Menu.f or .so: % adams07r1 -c cr-u n sub. menus or prompts do not appear.so e In this example.

or check box to let you change or set the value.Lists settings for the folder selected in treeview and lets you edit its value Message Area . . nothing changes. Click an item listed in the Registry area. 2.Displays messages Resets parameters to default settings To make a choice in the Registry Editor: 1. The value of the item appears as a text box. Treeview .Learning the Basics 11 Adams Registry Editor The Registry Editor lets you edit the settings that the Adams Toolbar stores for the different Adams products.Displays folders of preferences Resgistry area . In the treeview. option menu. The elements of the Registry Editor are shown in the figure below. If the registry item that you selected cannot be changed. click a folder that you want to change or view. It appears whenever you create a user library or set preferences. as they appear when you select to view all elements in the Registry Editor. the Registry Editor provides a file browser where you can enter a specific file name or browse for a file or directory. To help you find files. The Registry area displays the contents of the folder you selected.

A file browser appears. select OK. and then select Select A Directory. Note: If you modify a registry item.lst. the Editor prompts you to save your modifications.lst. You can select multiple files by clicking each file name you want. 2. A directory browser appears. Right-click a text box that requires a directory to be specified. To browse for a directory: 1. . 4. Select OK. Select another item. Therefore.12 Running and configuring Adams 3. list files have the extension *. or select a different folder in the treeview. The dialog box closes and the current text box displays the files you selected. To help narrow your search. Select OK. set File Type in the browser to *. The dialog box closes and the current text box displays the directory you selected. 2. Browse through the directories and click the one you want. For example. To browse for a file or files: 1. Right-click a text box that requires a file. to search for only list files. you can browse for a specific file type using a file extension. You can also select Always throw away changes and switch directories so you no longer receive this message. and then select Select A File or Select Files. Select No and then OK to save your changes or select Yes to exit without saving the changes. 3. and then select a new folder to browse in the treeview.

you must run the problem report from the license server. read the topics described next.txt. Send the file using e-mail or print the file and fax it to the technical support for your area. you may want to look over the report for error messages before sending it to MSC. Open the adams_problem_report. and then select Adams . you may want to save it under a different name because Adams overwrites the file each time you generate a report. not the client machine.Software. . press Enter. point to MSC. 4. If you are an experienced Adams user. 3. Note: For correct results. Add any comments in the comments section. Before contacting Technical Support.com.mscsoftware. If the problems persist. Our Knowledge Base articles http://support. 2. contact Technical Support.Learning the Basics 13 Troubleshooting If you have questions or problems with any of the Adams products. If you have problems running Adams products.Adams 2007 x (where x is the release number). point to Programs.mscsoftware. To close the window.txt file using a text editor and edit the first page of the report to include your name and phone and fax numbers. To generate a troubleshooting report on Windows: 1. From the Start menu. A message appears informing you that the report is being created and providing the name of the report. you can generate this report and send it to MSC. point to MSC.Troubleshooting Report. get help by viewing the Technical Support Web page at http://support.Software.com/kb/ and Frequently Asked Questions (FAQs) are especially useful. After you generate the report. • Windows problem reports • UNIX problem reports • Log information on UNIX • Technical Support Windows Problem Reports The troubleshooting report examines your system configuration and places important debugging information in the file adams_problem_report.Software.

Before sending the report. not the client machine. if any. have the following information available: • Version of FORTRAN. Right-click the Adams Toolbar tool.com Before contacting Technical Support. • Copy of the Adams/View log file (aview. • Copy of all error messages (you can send it by fax or through e-mail). This file uses the default file name of PROBLEM. . contact your local support center. Either send the file using e-mail or print the file and fax it to Technical Support for your area.RPT and places the file in the directory $HOME. you can generate this report and send it to MSC.log) and Adams/Solver message file (. • Troubleshooting report. if applicable (for example. which can be found at http://support.RPT. you can examine your system configuration and place important debugging information in the file PROBLEM. To generate a troubleshooting report on UNIX: 1. Technical Support To obtain technical support. point to Support.mscsoftware. 11 on the HP 9000/700). point to Support. open it into a text editor and edit the first page of the report to include your name and telephone and fax numbers. If you have problems running Adams products. Select Generate Hotline Report. After viewing the information. • Hardware type. An Alert dialog box informs you that the report has been created and gives you the name of the report. You should save the file under a different name since Adams overwrites the file each time. and then select Technical Support. 3. To find out more about contacting Technical Support on UNIX: 1.Software. You can also add any comments in the comments section.msg). Select Close. • Version of the UNIX operating system. Note: For correct results. 2. select Close. you must run the hotline (problem) report from the license server. where $HOME is your home directory.14 Running and configuring Adams UNIX Problem Reports Using the Adams Toolbar. and then select Technical Support. Right-click the Adams Toolbar tool. Information about the various ways in which you can obtain technical support appears. 2.

Running Adams Products .

You must have created the library in debug mode.The product runs with a command file at a specified time. see Creating User Libraries. It also collects information on the batch run in a batch log file that you specify.18 Running and Configuring Adams Running Adams On UNIX. For example. such as Adams/Durability. • Scripted . On Windows.acf) commands. or Adams/Vibration. For more information on running plugins. When you select interactive mode. you can set debug mode (also referred to as interactive debug mode) when you run a user library. To learn how to create a user library in debug mode. The command file helps you automate the creation of a model. to run Adams/Vibration. depending on the product that you are running.The product runs with a command file that you specify. You can set the same modes when you run a product with a user library. the subroutines in the user library. Note: To run add-on modules or plugins. On UNIX Modes in Which You Can Run Products You can run Adams products in the following modes: • Interactive mode . a system-level program.The product starts and waits for you to enter commands. . • Batch mode . Adams/Flex. see their online help. Each Adams product runs using its default preferences. A command file is either a set of Adams/View commands (. Batch mode only applies to Adams analysis products. The debug utility helps you detect and locate any problems in the user libraries.cmd) or Adams/Solver (. Debug mode runs a debug utility. use the Adams Toolbar to run Adams products and libraries of user-written subroutines. usually dbx. or investigate simulation results. use the Adams program folder and Selection Menu. perform a simulation. you can enter a command file that runs when the product starts. you must first run the product in which the plugin runs. Standard Products You can use the Adams Toolbar to run standard products by clicking the associated tool. and then select the command to run Adams/Vibration. In addition. that steps you through. first run Adams/Car or Adams/View. or isolates parts of.

The products are: • Adams/Car lets you create.Running Adams Products 19 To run a standard product: • Click the product tool. the product runs the specified command file. referred to as Adams template-based products. If the product default is to run in scripted mode. Adams/View Adams/Solver Adams/Car Adams/Driveline Adams/Chassis Adams/Insight Adams/PostProcessor Adams/Flex The product starts. If you want to run just the standard version of these products. and analyze suspension and full-vehicle assemblies. you can select a binary file that the product reads at startup to change the look of menus. The template-based products let you select to run their user interface or their version of Adams/Solver. In addition. in that order. Template-Based Products MSC. and commands. When you run a template-based product. refer to the online help for your product. It runs the first library that it finds.Software provides products built on Adams/View. and standard location. . dialog boxes. site. for a user library to run. • Adams/Driveline lets you model drivelines to create and analyze virtual prototypes of driveline subsystems. For more information on running Adams products. the Toolbar searches the product's private. be sure that there are no libraries in your private or site location. catalogue.

For example. point to [Product] . Click the product tool again.Interface. and then select a binary.Solver. right-click the Adams/Solver tool . For more on user libraries.20 Running and Configuring Adams The template-based product then reads the binary file that you have specified. point to Run. as explained in Adams/View Preferences. Adams/Solver tool changes to . and standard location and read the first binary it finds. the tool changes from to library as the default by clicking the tool. point to Select Library. You can specify that it read the binary file that is in either the private. To run Adams/View or Adams/Solver with a user library: 1. and standard locations. and then select a binary. or standard locations. and select a library. for a user library to run. see User Library Overview. for Adams/View. When you select to run a user library with Adams/View and Adams/Solver. Right-click the product tool. To run template-based products with Adams/Solver: • Right-click the product tool. . for Adams/Car. site. such as Asolver1. the associated product tool on the Toolbar changes to indicate that you are working with a user library. and then select [Product] . right-click the Adams/Car tool. Instead. You can also specify that it search the private. You can then select to run the product with the user You can also run Adams/View with an Adams/Solver user library by setting it as a default preference. For example. site. point to Run. site. The tool changes to indicate that the default is to run the product with the selected user library. point to Run. Running User Libraries User libraries are subroutines that extend the functionality of Adams products to meet individual needs.Solver. For example. the Adams Toolbar searches your private. right-click the Adams/Car tool. for Adams/Solver. point to Select Library. point to Run. For example. you can use a library of subroutines that define functions for motion or force magnitudes. point to ACar . For example. . and then select ACar . for Adams/Car. To run template-based products with their interface and a particular binary: • Right-click the product tool. and then select a user library. For Adams/Car.Interface. 2. For example. You run a user library by selecting it from Adams Toolbar and then running it with its associated product. in that order. you cannot specifically select a user library.

to run Adams/Vibration. For instructions on running Adams products. You access them by selecting the Adams/Solver option. point to MSC. point to Programs. Enter ru-user. For more information on the commands and execution of Adams/Solver. if you are licensed to do so. as well as run user libraries with Adams/Tire. point to Programs.Adams 2007 x (where x is the release number). such as Adams/Flex. as explained below. point to MSC. enter ru-standard.Command. point to ASolver. and Adams/Vibration. To run a user library: 1. Adams/Linear and Adams/Tire are analysis modules of Adams/Solver. which expand the functionality of the major products. or press Enter. Running Adams/Solver You can run either standard Adams/Solver or Adams/Solver with a user library. see the Adams/Solver online help. To run Adams/Solver: 1. refer to the online help for your product. Do one of the following: • From the Start menu. if you have created one. Adams/Durability.Running Adams Products 21 On Windows Running Adams on Windows The Adams program folder and Selection Menu provide access to many of the Adams major products. 3. Adams/Controls. From the Start menu. 2. you first run Adams/Car or Adams/View and then select the command to run Adams/Vibration. You run these products from within the major products. Adams also has add-on modules or plugins. and then select Adams . 2.Adams 2007 x (where x is the release number). and then select Adams . Adams/Solver starts running. • From the Adams Selection Menu. Standard Adams/Solver You can select to run Adams/Solver without the Adams/View graphical interface. .Software. point to MSC.Solver. Enter the name of the custom library that you want to run. For example.acf). point to MSC.Software. User Libraries with Analysis Products You can run user Adams/Solver libraries from either the Program Folder or the Selection Menu. Enter the name of the Adams command file (. A window appears prompting you for information.

You can use Adams/View to build. see the Adams/Solver online help. and then select Adams . Running Adams/View from the Selection Menu lets you select the mode in which to run Adams/View. For more information on the commands and execution of Adams/Solver.22 Running and Configuring Adams 4. if you have one.View. or press Enter. which helps you solve your design problems.acf). point to Programs. Enter the name of the Adams command file (. Adams/Solver starts running. and refine virtual models of any mechanical system. Running Adams/View Adams/View is a powerful modeling and simulating environment. . simulate.Software. refer to its online help. • Adams/View from the Program Folder • Standard Adams/View from the Selection Menu • User Libraries with Adams/View Adams/View from the Program Folder To run Adams/View from the program folder: • From the Start menu. point to AView. Standard Adams/View from the Selection Menu You use the Adams/View Selection Menu that appears when you select aview from the main Selection Menu to run and create Adams/View user libraries. For information about working with Adams/View. You can run Adams/View from the program folder or the selection menu. point to MSC. point to MSC.Adams 2007 x (where x is the release number). The Adams/View main window appears. as well as run it with user libraries.

From the Start menu. It also collects information on the batch run in a batch log file that you specify. To run Adams/View with a user library: 1. point to Programs. including Adams/Solver user libraries. For information on setting the Adams/Solver user library after starting Adams/View. • To run in interactive mode. point to MSC.The product runs with a command file that you specify at a specified time. The Selection Menu displays. Enter ru-standard. select i or press Enter. Select the mode in which you want to run the executable. In the Adams Selection Menu. Enter the name of the Adams/View user library. When you run a Adams/View.Software. 4. you can often enter a command file that runs when the product starts. Enter ru-user. • To run in batch mode. Note: You can also set the Adams/Solver user library after you've started Adams/View. and then press F1 for help. To run standard Adams/View through the Selection Menu: 1. Enter aview. Runs Adams/View with a user library. select Settings -> Solver -> Executable. When you select interactive mode through the Selection Menu. 2. . 3. select b.The product starts and waits for you to enter commands.Command. you can select the following modes: • Interactive mode . enter aview. • Batch mode . 2. 3. User Libraries with Adams/View You can run Adams/View with user libraries that you created. 4. If you selected batch mode. enter the name of a file containing Adams/View commands. point to MSC. The Adams/View main window appears.Adams 2007 x (where x is the release number).Running Adams Products 23 This selection code: cr-user ru-standard ru-user Provides this action: Leads you through the creation of an Adams/View library. and then select Adams . Selects standard Adams/View.

For example. catalogue. For example. The products are: • Adams/Car lets you create. you can also choose the binary (for example. Template-Based Products from the Program Folder The Adams program folder lets you run the template-based products through Adams/View or Adams/Solver. For information on the different products. see the online help for that product. or Adams/Driveline runs the first user library that it finds as it searches your private. • Adams/Driveline lets you model drivelines to create and analyze virtual prototypes of driveline subsystems. A binary contains the database information for a customized interface. referred to as Adams template-based products. Adams/View begins running. select Adams . and standard locations for a user library to run. Tip: If you want to run the standard version of the product without a user library. When you enter a command to run a template-based product. Adams/Driveline (Solver) main command window appears. and then select the appropriate command. point to MSC. Enter the name of an Adams/Solver user library. point to Programs. Adams/Car. do one of the following: • From the Start menu. acar. (View) main window appears. be sure that there are no user libraries in your private or site location. point to MSC. site.Software. If you use the Selection Menu to run a product. The Adams/Car. . and analyze suspension and full-vehicle assemblies. Running Template-Based Products MSC. For information on creating user libraries.24 Running and Configuring Adams 5.bin ) you want to use. You can run the template-based products alone or with different user libraries in your private. ADriveline. • From the Start menu. and then select the appropriate command. the standard location. the product searches the private. orAdams/Driveline.Car (solver).Adams 2007 x (where x is the release number). see Custom Template-Based Product Libraries. point to MSC. select Adams . point to ACar. It runs the first library it finds. The Adams/Car. and standard locations. site.Software provides products built on Adams/View.Adams 2007 x (where x is the release number). finally. and. site.Software. To run template-based products from the program folder: • Depending on whether you want to run the product through Adams/Solver or Adams/View. point to MSC. or ADriveline. point to ACar.Car (view). point to Programs.

enter acar. A Selection Menu appears. Selection menu contain the same type of options. The Adams/Driveline. The following sections explain how to use the Selection Menu to choose the version for the product to run: Displaying the Selection Menu To display the template-based product's selection menu: • At the Adams Selection Menu. or adriveline . The following figure applies to Adams/Car.Running Adams Products 25 Template-Based Products from the Selection Menu The Selection Menu lets you run the template-based products and choose the binary that you'd like to use. .

identifies where Adams/Car places the binary. cr-acarsite. and standard locations for a library to run. the product searches the private. and so on) for any warnings or error messages that may have occurred during the building of the binary file. and standard locations.26 Running and Configuring Adams The code(s): cr-acarprivate. cr-solverprivate. . site. 2. It also uses the first version of the Adams/Car binary that it finds as it searches the private. You can also specify to search the private. The string after the ru. ru-private. aride. Tip: If you want to run the standard version of the product without a user library. site. The string after the cr. refer to the table above.log. and standard locations and read the first binary found. site. site. ru-acar Runs the first private.identifies which binary to use.log. You can specify a binary file in the private. enter acar. At the Adams Selection Menu. or adriveline. Creates a custom Adams/Car binary file that Adams/Car runs when it starts up. ru-standard ru-solver Running Template-Based Products with Adams/View When you enter a selection code to run a template-based product. ru-site. or standard locations. Note: We strongly encourage you to review your product's log file (acar. be sure that there are no user libraries in your private or site location. enter one of the selection codes depending on the binary file that you want to read. To run template-based products with Adams/View: 1. The string after the cr. cr-solversite cr-privatebin. site. or standard binary. site.identifies where Adams/Car places the library and whether the version runs with Adams/View or Adams/Solver. or standard library of Adams/Car that it finds. Runs the first private. The template-based product then reads the binary file that you have specified. It runs the first library that it finds. For more information on the selection codes. site. site. cr-sitebin Do(es) the following: Creates a user Adams/Car library and places it in your home (private) or site directory. At the Selection Menu. and standard locations. or standard library of Adams/Car that it finds and then uses the specified private. Runs the Adams/Car version of Adams/Solver that it finds as it searches your private.

Running Adams Products 27

Running Template-Based Products with Adams/Solver You can run the standard version of a template-based product with Adams/Solver or run user libraries that are in the private or site locations. The Selection Menu searches the private, site, and standard locations and runs the first user library that it finds.

Tip:

If you want to run the standard version of the product without a user library, be sure that there are no user libraries in your private or site location.

To run template-based products with Adams/Solver: 1. At the Adams Selection Menu, enter acar, or adriveline. 2. Enter ru-solver. 3. At the command file prompt, do one of the following:
• Press Enter.

A main command window appears.
• To launch the product with a command file, type the name of the command file and press

Enter. The product reads in your command file and its main command window appears.

28 Running and Configuring Adams

Creating User Libraries

30 Running and Configuring Adams

User Library Overview
You can create user libraries and run them with your Adams products. There are two types of user libraries:
• Adams Interface or Adams/View libraries - These libraries let you change the definition of your

model by adding compiled design-time functions for use in Adams/View expressions. You can also change post-processing by adding or changing functions that determine how simulation results are computed. You can use these functions in the same way you would use the built-in design-time functions. For more information, see the Adams/View Function Builder online help.
• Adams/Solver libraries - These libraries let you add run-time functions for motion or force

magnitudes to directly define the behavior of your model and change the way the simulation is performed. They let you take advantage of existing software to define complex modeling relationships, such as hydraulic actuators or tire forces. For more information on writing userwritten subroutines, refer to the Adams/Solver online help. Adams/View Executable Adams/Solver Executable

Interface Library

Adams/Solver Library

Adams/Solver Library

Products, such as Adams/View, and Adams/Car, can run both an interface library and an Adams/Solver library because they run Adams/Solver internally. To set the Adams/Solver user library to run internally with these products, set the preference solverUserLibrary as explained in Adams/View Preferences. Once you create a library, you need to set up your modeling entities, such as motions or forces, to reference these subroutines and use the library whenever you perform a simulation on models referencing these subroutines. For information on using the subroutines in your model definition, refer to the Adams/Solver and Adams/View online help. When you run an Adams/Solver library, the associated Adams product only loads the library when a user triggers it, such as when a user selects a command that executes the subroutines in the library. This is because Adams/Solver libraries are demand-loaded. When you run an interface library, the associated Adams product loads the library at startup so that design-time functions can be registered and available for immediate use.

For Adams/Car. and Adams/Driveline. it can be included in an Adams/Solver user library. On UNIX. . Currently. to which all users have access. the scripts on UNIX do not support the compiling of C code. For the product: Adams/Car Adams/Driveline Adams/Solver Adams/View Learn how to: • Create user libraries on UNIX You can create the user library: Interface and Adams/Solver Interface and Adams/Solver Adams/Solver Interface and Adams/Solver Its location: Private or site Private or site Any directory Any directory • Create user libraries on Windows Windows will compile C code for Adams/Solver.Creating User Libraries 31 Creating User Libraries You can create user libraries for the products listed in the table shown next. If you are creating a site library. Once the C code is compiled for UNIX. The table also lists the type of user library you can create (interface or Adams/Solver) for that product and where you can place the user library. the Adams Toolbar automatically creates a directory structure to help manage the different libraries. but UNIX does not. you can only specify either your home (private) directory or the site location. be sure that you set up the site directory as explained in Directory Structure for Template-Based Products.

as explained in the online help for your template-based product. the Adams Toolbar creates a directory structure for you as you create libraries and binaries. you need to create a site directory and specify its location. by default. If you do not have write permission. Adams/Car. You can also specify its location as explained in TemplateBased Product Preferences. • For the private location. • For a site location. Windows Before creating a site library.bin hpux11 acariface. If you do not have write permission. uses the private directory that it creates when you first run the product.32 Running and Configuring Adams Directory Structure for Template-Based Products To create libraries and binaries for template-based products. the product returns an error. Adams Toolbar uses the directory that it creates when you first run a template-based product. An example of the structure of a site location for Adams/Car with two different platform libraries (SGI and HP) is shown next. the Toolbar creates a different subdirectory in which to store the library or binary. If you are creating a private library. • UNIX • Windows UNIX To help you create binaries and libraries for the template-based products. and Adams/Driveline. Adams/Driveline. the product returns an error. The product stores the binaries and libraries in the directory at the same level.sl The process for creating the directory structure varies by platform. My_site irix32 acar. You must have permission to write to the directories.so acar. You must have permission to write to the directories.bin acariface. Adams/Car. . you need to have the proper directory structure. For each platform for which you create a library or binary. you must create the base site directory and specify its location as explained in Template-Based Product Preferences.

acf and then select Apply.exe 5. Debugging on Windows To debug an Adams/Solver user library: 1. you will have to create a solutions file by pressing Save. From the Command pull-down menu.f and set a breakpoint on a line in your user subroutine. Set the working directory to the location where the . In MS Visual Studio. A command window appears. Browse for: install_dir/solver/win32/solver. using: Debug -> Start Note: If this is your first time debugging.dll. except: • The command to create the library is: . and . From the command window. 8. that steps you through the subroutines or isolates parts of them. select Browse.Net automatically starts up.f -n mysolver. Run the library file in debug mode as explained in Running Adams/Solver. The debug utility helps you detect and locate any problems in the user-written subroutines.dll. you would enter: adams07r1 ru-user mysolver. To debug an Adams/View interface library: • Follow the instructions above for Adams/Solver libraries. showing Adams/Solver initialization commands. Set the command argument to user. 6. Open user. The program execution then halts in the debugger at the breakpoint that you've specified.dll user. . right-click on mysolver.acf. from Solution Explorer.acf Microsoft Visual Studio. 2.adm files are located.dll Make sure the . Running a user library in debug mode invokes the debug utility. From the command window.f extension is lowercase. 7. you would enter: adams07r1 cr-user y user.Creating User Libraries 33 Debugging User Libraries Debugging on UNIX You can choose to create the user library in debug mode. a system-level program. 4. Create a library file with debugging information as explained in User Libraries on Windows. Run the project. 3. and then select Properties.

exe .c -n myview.dll • The command to run in debug mode is: adams07r1 aview ru-u i myview.dll -n • You browse for: install_dir/aview/win32/aview.34 Running and Configuring Adams adams07r1 aview cr-user y user.

such as AView1. You cannot create two libraries with the same name. right-click the product tool. if required. and then select [Product] User Library. because you cannot run the resulting library directly from the Adams Toolbar. Not available for Adams/Car. The parameters. such as what it does or how it was created. because you cannot run the resulting library directly from the Adams Toolbar. Not available for Adams/Car. description Text that describes the library. point to New. and Adams/Driveline. The list file must contain one file per line. source or object files. and Adams/Driveline. such as AView1. Do one of the following: • For a product for which you can only create one type of user library. • For a product for which you can create either an interface or Adams/Solver library. ASolver1. Click the parameters you want to change and enter their values as needed. Selects whether or not to build the library in debug mode. The Enter Parameters for User Library list appears in the Registry area with several parameters that you can modify. such as AView1. right-click the product tool. debug . name and libPath. point to New. have default values based on a simple counting scheme and the name of the product for which the user library is being created. and.so. sourceFiles One or more individual C or FORTRAN files. 2. select the location for the library you want to create. You can use other values that have more significance. point to [Product] . because you specify the library location when you first create it as either your private or site location. AView2. The project name must be unique. It also determines the file name of the library. and so on.and Adams/Driveline. libPath A directory indicating where to store the resulting library.Creating User Libraries 35 UNIX User Libraries on UNIX To create a user library on UNIX: 1.lst) that contains a list of C or FORTRAN files. Parameter: name Meaning: A project name identifies the user library. You can mix C and FORTRAN source files. or a list file (*.Interface or [Product]-Solver. Not available for Adams/Car.

For example. 3. Click description and enter text describing the library. For example. Deleting User Libraries You can delete any library registered in the Adams Toolbar. • If the directory you specified for libPath does not exist. If you select to just remove the library from the Toolbar. 4. and then select Import Existing Custom Library. Select OK. A window appears. To import user libraries: 1. To delete a library: • Right-click the tool for the product whose library you want to import. the Adams Toolbar does not create a library. Select OK.36 Running and Configuring Adams Note: You must enter one or more source files for the parameter sourceFiles. 3. the following occurs: • A new entry appears on the Select Library menu from the product icon on the Toolbar. 2. When you delete the library. Importing Existing User Libraries You can import user libraries that have been created by others so you can run them from your Adams Toolbar. The name of the file is the name of the menu. right-click the Adams/View tool. and then select Import Existing Custom Library. you can add it back into the Toolbar as explained in Importing Existing User Libraries. Adams Toolbar adds the library to the list of libraries available to run with that product. Adams Toolbar asks you if you want to just remove the library from the Toolbar or delete the actual library file from its directory. and then select Remove Custom: Aview1. and then select Remove Custom: [customName]. . • Adams Toolbar creates or changes the appropriate registry entries to reflect the new entity. When the creation is complete. Click name and enter the name of the library file. Adams Toolbar creates it. showing the compilation and linking process that builds your custom library. right-click the Adams/View tool. Right-click the tool for the product whose library you want to import. if you are importing an Adams/View library. It places the new library and a log file about the creation in the directory. If you do not enter source files.

From the Start menu. or list file containing your subroutines. a source file (.f or . point to Programs. Enter the name of the first object. Note: You can also use a list file (.c in the directory /install_dir/aview/usersubs/. • Pressing Enter to end the list of subroutines linked to Adams/View.lst file (for example. 2. enter one of the following options: • To run in debug mode. Sample C functions are in the file vc_init_usr.c extension is lowercase. You must place an @ sign before the name of the list file (for example. Repeat Step 2 as many times as necessary by either: • Entering an object file containing one or more user-written subroutines. or a .c). If entering a source file. Enter cr-user. point to MSC. @sub_list. you can create user libraries for the following: • Adams/View • Template-based products • Analysis products Custom Adams/View Libraries You can add your own C routines to create a user Adams/View library. Enter aview. .obj). 7. @names. enter y. point to MSC. Enter a name for the Adams/View user library that you want to create. where install_dir is the directory in which you installed Adams software. 6.f or . To create an Adams/View library: 1. 3.Command. source.Adams 2007 x (where x is the release number).lst).Creating User Libraries 37 Windows User Libraries on Windows On Windows. You've now created a user library that Adams/View can run. be sure the . and then select Adams . 4.lst) to enter the names of several object files at once. You can enter an object file (for example. mysubs. At the debug prompt. 5.Software. • To run in standard mode. enter n or press Enter.lst).

Creating Libraries for Template-Based Products The following steps explain how to create interface or Adams/Solver user libraries that run with Adams/Car. enter one of the following options: .c). point to Programs. From the Start menu. 5. or adriveline. 4.lst file (for example. At the debug prompt. or adriveline. Enter the code to create a private or site library (for example. as explained in Directory Structure for TemplateBased Products. To create an interface user library: 1. You can choose to place any of the libraries in your private or site location. • Pressing Enter to end the list of subroutines linked to Adams/View. • To run in standard mode. Enter acar. be sure to set up the directory. mysubs.Command. @sub_list. a source file (. point to MSC. point to Programs.Software. 3. and Adams/Driveline.38 Running and Configuring Adams Custom Template-Based Product Libraries For Adams/Car.Software. At the debug prompt.Adams 2007 x (where x is the release number). Enter the name of the first object. point to MSC.Adams 2007 x (where x is the release number). point to MSC. point to MSC. You can enter an object file (for example. or a . Enter the code to create a private or site library (for example. From the Start menu. To create an Adams/Solver library: 1.f or . If entering a source file. see their online help. 3.obj). be sure the .lst).f or . 2. and then select Adams . or list file containing your subroutines. 2. 4. and then select Adams . For information on running the libraries. 6.c extension is lowercase. cr-acarprivate or cr-acarsite). see Running Template-Based Products. If you are creating a library in your site location. you can create user interface or Adams/Solver libraries. You can create the libraries in your private (home) directory where only you can access them or place them in the site location for all users to access. Learn about the Directory Structure for Template-Based Products. Repeat Step 4 as many times as necessary by either: • Entering an object file containing one or more user-written subroutines. enter one of the following options: • To run in debug mode. Enter acar. For more information on customizing these products. source. enter n or press Enter. enter y. Adams/Driveline.Command. enter cr-solverprivate or crsolversite).

by either: • Entering an object file containing one or more user-written subroutines. • To run in standard mode. mysubs.obj). You can enter an object file (for example. From the Start menu. enter one of the following options: • To run in debug mode.lst). Enter a name for the Adams/Solver library you want to create and press Enter to begin the linking process. @names. Adams/Controls. 6.f or .lst file (for example. where install_dir is the directory in which you installed Adams software.Software.f or . 5.Adams 2007 x (where x is the release number). and Adams/Tire. Repeat Step 4 as many times as necessary.lst).Creating User Libraries 39 • To run in debug mode. To create a user library: 1. enter y. 5. enter n or press Enter. point to MSC. You can enter an object file (for example.Command.c). be sure the . a source file (. @sub_list. Note: You can also use a list file (.f or .f or . @sub_list. source. 3.lst) to enter the names of several object files at once. • Pressing Enter to end the list of subroutines. or list file containing your subroutines. which include Adams/Solver. You must place an @ sign before the name of the list file (for example. enter n or press Enter. • Pressing Enter to end the list of subroutines linked to Adams/Solver.c extension is lowercase. mysubs. enter y.c). . by either: • Entering an object file containing one or more user-written subroutines.lst file (for example. Enter the name of the first object. point to MSC. Enter the name of the first object. or a . 4. a source file (. 6.c extension is lowercase. or list file containing your subroutines. or a . Enter cr-user.lst). • To run in standard mode. point to Programs. If entering a source file. User Libraries for Analysis Products You can create user libraries for the Adams analysis products.f file in the directory c:/install_dir/solver/samples/. If entering a source file. 2. At the debug prompt. source. You can also run the user libraries from within Adams/View when running Adams/View with an integrated Adams/Solver. be sure the . Repeat Step 2 as many times as necessary. and then select Adams . Sample user FORTRAN subroutines are in the tire.obj).

40 Running and Configuring Adams .

Managing Files .

the following commands create a new menu named New Menu and a button named DO IT under the menu: interface menu create & menu_name=.42 Running and Configuring Adams Binary Files You can create a binary file. tool. point to MSC.main. and then select the location for the binary file. point to [Product] Binary. point to A/Car Binary.aca_sta_mbar. or adriveline. 3. To create a binary file on Windows: 1. or adriveline_build. point to MSC. acar.log. see the Customize tab in your template-based product's online help. Note: We strongly encourage you to review your product's log file (acar. or adriveline. For example. for Adams/Car. you create a command file containing Adams/View commands for modifying the interface. point to New.cmd. When you start a template-based product with your binary file. For more on command files. point to New. see Directory Structure for Template-Based Products. point to Adams/Car. enter cr-privatebin or cr-sitebin). Adams/Driveline. For more on creating acar_build. From the Start menu.Adams 2007 x (where x is the release number). For example. Select OK. (depending on your product) and must be in your private or site directory.gui_man. dialog boxes. and so on) for any warning or error messages that may have occurred during the building of the binary file.new_menu & enabled=yes & label ="New Menu" interface push_button create & push_button_name = . Right-click the Adams/Car. For information on directory structure for storing binary files. Enter acar.Software. To specify the interface changes that you want in the binary file. or Adams/Driveline).Command. 2. and then select Adams . You can create the binary files in your private (home) directory where only you can access them or place them in the site location for all users to access.gui.aca_sta_mbar_new_menu. and buttons that appear in template-based products (Adams/Car. To create a binary file on UNIX: 1. 2.cmd.ACAR" The name of the command file must be acar_build.do_it & enabled = yes & label = "DO IT" & command = "list_info entity=. . point to Programs. the product reads in your customized interface instead of the standard binary file.cmd. and then select the location for the binary file. see the Adams/View online help. that contains database information for the customized menus. Enter the code to create the binary (for example.

the command and options are: cl /c /G7 /Ox /MD /Z7 . For C. that you let Adams Toolbar run your compiler since there is less chance for errors. The options are explained in the table shown below. It also ensures that the correct compile flags are set so that your files are compiled and linked using the same options that were used for Adams product code. use the following command: adams07r1 -c cr-user n Windows You can input C or FORTRAN source files to create Adams/Solver user libraries and only C source files to create Adams/View user libraries. refer to your compiler documentation and the hardware and software specifications.Managing Files 43 Language and Compiling You can submit your subroutines as any of the following types of files: • FORTRAN and/or C source files. • File containing a list of source files. • Object file containing one or more user-written subroutines. UNIX You can either let Adams Toolbar run your compiler by supplying source files. To view the list of compiler options valid on your platform. the command and options are: ifort/c /architecture:pn4 /MD /Ob2 /automatic /Z7 /Gm Note: /Z7 should only be used for debug mode.mscsoftware. or you can compile and link your subroutines on your own and create object files. with one name per line. You must use the following C and FORTRAN compiler command and options for your user subroutines. however. To find out what type of compiler you need. We also recommend that you purchase a debugger. Also. for further instructions.com). For FORTRAN. read the hardware and software specifications that come with your Adams product (you can also see them at http://support. We recommend.

.44 Running and Configuring Adams This variable: /c /G7 /architecture:pn4 /MD /Ob2 or /Ox /automatic /Z7 /Gm No linking Provides the following: Pentium 4 or Athlon optimization (C compiler) Pentium 4 optimization (FORTRAN compiler) Multi-threaded applications (Adams is a multi-threaded application) Automatic inlining Puts local variables on the run-time stack Adds debugging information Compatibility switch for the Intel Fortran compiler The linking procedure allows you to supply FORTRAN or C files (depending on the Adams product).

where /install_dir/ is the directory in which you installed Adams software and adams_product is the name of the product. we've provided sample source files for creating user libraries in the directory /install_dir/adams_product/usersubs/.Managing Files 45 Sample Source Files For Adams/Car. and Adams/View. Adams/Solver. .

dat . work: • Path files • Startup files • Log files • Binary files Path Files An Adams interface product creates an Adams default aview. The aview. including Adams/Car.pth file at installation time. It is in the aview product subdirectory.pth file: .adm . . You can have multiple paths for each extension by adding another line with the same file extensions and an alternate path.req .pth file allows you to specify search paths for the different types of files that can be loaded into Adams. you do not have to name your files with the standard Adams/Solver and Adams/View extensions.bin . Below is an example of an aview.bin. All UNIX systems are case sensitive for the path.cmd .46 Running and Configuring Adams Adams Files You can set up the following files to change the way in which the interface products. The first line in the example file above specifies a search path for files with an extension of . and Adams/View.igs . This is useful for files that are shared with other users. Therefore. install_dir. You can use a single space and tab or combine spaces and tabs to create separation between the extension and search path. underneath the installation directory.gra . • Use the correct case for file extensions in the Path file.idb . Any file extension can be put in the Adams path file. (period). • Begin each file extension with a .dct /install_dir/aview/ $workdir/idbfiles/ ~jsmith/adams/datasets/ /usr/aview/cmd_files/ /usr/adams/test_data/ /staff/my_home_dir/adams/output/ /staff/my_home_dir/adams/output/ /staff/my_home_dir/adams/output/ /staff/my_home_dir/iges_files/ /install_dir/aview/ Each line in the file specifies a search path for a specific file extension. • Separate the extension and search path for the extension with a space. and are not in your current working directory. Use the following conventions to add a file extension to the path file: • Begin each line in column one with the desired file extension. on your machine. Remember each line must begin with a file extension.res . Adams is case sensitive with regard to file extensions.

starting from the root ('/') of the file system.cmd . Log Files The aview. Copy the default Adams path file to your current working directory.pth file mentioned above. From the Adams Toolbar. so you may lose the edits you make. For more information on the content of command files and how to create them. or modify the file to specify your file search paths.cmd • productBS. right-click the Adams/View tool A/View Settings. where product is the name of the product. While running Adams. delete. The searchPath is visible in the treeview. You can begin a search path with the ~ character to indicate a UNIX home directory. (aview. Click searchPath and specify the full path to your local aview. 4. You can type in the path or use the browser to select it. If you want to make the changes to the path file affect all Adams users.cmd files in the aview. refer to the Adams/View online help. 2. edit the default aview. Adams creates this file in your local directory. 3. and adriveline) are: • product. Adams searches for it in the directories specified for .log file is a text file containing a log of your commands for an Adams session. BS stands for Before Startup. and then select Change In the file names. To make the changes only affect you: 1.Managing Files 47 • Complete each search path. Startup Files The three files that interface products read when they start up. and AS stands for After Startup. including the file name. and you cannot change them. Adams first searches for the command files in the current working directory. meaning that Adams reads it after it reads other setup files. • Ensure that each line is less than 255 characters in length. you can change the name of the log file for that session with the command: . • End each search path with a trailing /. or with a $ character to indicate a UNIX environment variable. meaning that Adams reads it before it reads other setup files. The startup files contain Adams/View commands that Adams executes on startup. You can edit any of the files to execute Adams as desired when it starts up. If a command file does not exist locally.pth file. Note that many products overwrite the BS and AS files when you select to save options.cmd • productAS.pth file. The command file names are hard-coded. Add. acar.

You can create your own copy of aview. Adams/View first searches for aview. Alternatively.bin file.bin to save the state of your modeling session. The aview. .bin provided with Adams/View contains database information for the standard menus.log file each time it starts. panels. issue the Adams/View command: FILE BINARY READ FILE_NAME = "filename" The name aview. If you use the name aview. Adams/View automatically reads the aview. we recommend that you follow the instructions in Binary Files. you can use a different name for the binary file you save. If aview. For more information on the content of log files and how to create them.bin to save a customized interface (menus. You can also create an aview. When you start Adams/View again in the directory containing your version of aview. and buttons you have modified).pth file. panels. Adams/View reads it on startup. refer to the Adams/View online help.bin file and restores your modeling session. Adams/View reads in your customized interface and ignores the standard aview. Adams/View searches for it in directories specified for .bin file is a binary file containing the Adams/View database.bin.48 Running and Configuring Adams FILE LOG_FILE FILE_NAME = "filename" Adams overwrites any existing aview.bin for the file. You cannot change it. The aview. Binary Files Note: When changing binary files for Adams/Car. the next time you start Adams/View in that directory. To restore the state of you modeling session. and buttons.bin in the current working directory.bin files in the aview.bin is hard-coded in Adams/View as the default binary file it reads upon startup.bin does not exist locally.

Using Memory Models .

Consult with the other users before changing the allocated size.52 Running and Configuring Adams Memory Models If you have a large model and are using the Adams FORTRAN based solver. Remember that creating or using a large memory model size uses significant system resources and can potentially impact other processes running on the system. Note: Memory size changes do not take effect until you restart the Adams product. . you may need to change your memory allocation to avoid program faults during simulations.

The maximum number of RPN instructions in all function expressions. Used to store column titles and spline types.Using Memory Models 53 Memory Model Sizes The following table shows the variable and array sizes for the memory options. The maximum size of the RPN stack. This array or variable: MD array OPRM array CD array LD array LCEXPR FPSIZE NINSIZ MXSTAK Is: Main storage array for Adams/Solver analysis. The memory section for interactive modification of function expressions. splines. . function expressions. request comments. arrays. and more. The maximum number of constant values in all functions. userwritten subroutines. Used to store character strings. and more. Variable Array Standard Large Extra Large Huge MDSIZE MD 1100000 3000000 20000000 60000000 OSSIZ OPRM 100000 100000 100000 200000 CDSIZ CD 4000 4000 8000 16000 LDSIZE LDSIZE 2000 2000 5000 50000 LCEXPR CEXPR 100 200 300 1000 FPSIZE FPVARS 250 250 1000 3000 NINSIZ NINSTR 1000 1000 5000 15000 MXSTAK MSTAK1 50 100 300 300 The following table explains each variable and array. The maximum number of lines in any function expression.

you may see the following: MDI_AVIEW_MEMSIZE=LARGE MDI_SOLVER_MEMSIZE=HUGE . For example. 3. select System Command. From the Tools menu. printenv|grep MEM • On Windows: In the Command Text box. 4. 5. To display the memory model size: 1. Open Adams/View. enter the following UNIX command. enter set. Select OK. Select to write the output to the information window. 2. See your operating system documentation for more information. you can use a system command to determine what your environment settings are used for memory model size. Adams/View displays your environment settings in the information window. Perform one of the following: • On UNIX: In the Command Text box.54 Running and Configuring Adams Viewing Memory Model Size from Adams/View From within Adams/View.

On Windows. the Adams Toolbar saves the parameters in the Adams registry. The error occurred in subroutine "OPMAIN" while allocating "DOUB" space from "TEMP" for the "IZ".4e6 If you already have your memory model set to HUGE. Therefore. When Adams starts. if you are running with the memory model set to HUGE and you get the following error message: ! ! ! ! ! ERROR: ***** ADAMS MEMORY OVERFLOW ***** A larger MD array is required. and creates a FORTRAN subroutine for the platform on which you are currently running the Adams Toolbar. if used. The Adams Toolbar uses a directory structure under $HOME/.Software provides several standard memory models for you to use as explained in Memory Model Sizes. the space needed to run the simulation is: Space Requested . you need to create a custom memory model to accommodate the large memory requirements. Space Available is the amount of space that is left to run with the current memory model. The error occurred in subroutine "OPMAIN" while allocating "DOUB" space from "TEMP" for the "IZ". it searches the following locations in the following order for a custom memory model: • The location where the user executable is found. MSC. by default. however. . Do not change the contents or structure of the memory model directory.Space Available + Current Memory Model For example. On UNIX. Often. Remember that selecting a memory size affects the machine and every user. when you create a custom memory model. Space Requested is the space that is needed for the simulation to continue. Consult with other users before decreasing the allocated size. you receive the following message: ! ! ! ! ! ERROR: ***** ADAMS MEMORY OVERFLOW ***** A larger MD array is required. • install_dir/win32/uconfg_user directory. Space Available: 348496 Space Requested: 7651872 The amount of memory necessary to run the simulation is: 7651872-348496 + 20000000 = 27.Using Memory Models 55 Setting Custom Memory Model Size Custom Memory Models You must have a FORTRAN compiler to create a custom memory model. when you are simulating very large models. Adams places the custom memory model in the directory install_dir/win32/uconfg_user.msca/cmm to store the FORTRAN subroutines and corresponding libraries. Space Available: 348496 Space Requested: 7651872 In the message.

A window displays a list of build parameters as the library creation takes place. 2. point to Manage Custom Memory. you have to rebuild your custom memory models. Right-click the Adams Toolbar tool. 3. you may have to rebuild if you switch to a new architecture or if something goes wrong with your current model directory. point to Manage Custom Memory. Rebuilding a memory model Occasionally. and all libraries. and then select Rebuild Memory Models. source file. and then select Delete Memory Model. the model directory. Note: This deletes the model parameters in the registry. and enter a name for the memory model. and then select Create Memory Model. Select OK. In the treeview. 4. Click name. click the name of the memory model that you want to delete. Refer to the tables in Memory Model Sizes for explanations of each of the array values. A shell window displays each custom memory model being rebuilt as needed. Select one of the following topics: • Creating a custom memory model • Deleting a custom memory model • Rebuilding a custom memory model • Changing a custom memory model Creating a custom memory model To create a memory model: 1.56 Running and Configuring Adams Maintaining Custom Memory Models on UNIX This topic explains how to maintain your custom memory models. For example. point to Manage Custom Memory. Select OK to build the necessary directories. Adjust the array values in the options. 3. . 2. To rebuild a memory model: • Right-click the Adams Toolbar tool. Right-click the Adams Toolbar tool. Deleting a memory model To delete a memory model: 1. and library.

A shell window displays each custom memory model being rebuilt as needed. point to MSC. A new uconfg_user. and then select either View/Change Memory Model. Adjust the array values in the options. Set the memory model size for both Adams/View and Adams/Solver to Custom.Software. Right-click the Adams Toolbar tool. Run adams07r1 cmm and select your uconfg parameter sizes. Setting Custom Memory Model Size on Windows To set a custom memory size on Windows: 1.Adams 2007 x (where x is the release number). Refer to the tables in Memory Model Sizes for explanations of each of the array values.dll is created in the install_dir/win32/uconfg_user directory. In the treeview.Using Memory Models 57 Changing a memory model To change a memory model: 1. click the name of the memory model that you want to change.Settings. point to MSC. Your memory model size is set. . point to Programs. Select OK. and then select Adams . 2. 3. The Adams registry editor appears. 4. Set the custom memory setting as the default as explained in Adams Environment. 2. 3. 4. Select OK. From the Start menu. point to Manage Custom Memory.

58 Running and Configuring Adams .

Setting Environment Variables .

. and others apply specifically to one product.60 Running and Configuring Adams Environment Variables Adams contains many environment variables. Using the system registry. Some are common to all Adams products. you can change these variables to further customize your use of Adams.

it is possible for duplicate zerovalue entries to appear in Adams/Controls results. Set this environment variable to on to suppress the initial duplicates. Currently. What it does: Changes the delay in start-up of function evaluation mode when using Adams/Controls with Easy5. MSC_ACONTROLS_SUPPRESS_INIT_DUPS on/off .Setting Environment Variables 61 Adams/Controls Environment Variables The following are Adams/Controls environment variables: Variable name: ADAMS_CONTROLS_WTIME Variable value: An integer number such as 5 or 10.

where <job_name> is the name given on the FILE argument of the first FEMDATA statement. last . Generates an ASCII file that maps the loads from MBD to FE for DAC output only.Keep Writing of DAC files can be problematic if multiple solutions exist at the same time. MDI_ADAMS_EQUALTIMES keep (default) .dac MDI_DUR_LOADHEADER MDI_DUR_LOADMAP MDI_DUR_LOADOFFSET . DAC files start with the names: job_name_001.62 Running and Configuring Adams Adams/Durability Environment Variables The following are Adams/Durability environment variables: Variable name: DUR_HOTSPOT_LIMIT DUR_MSR_MB_LIMIT Variable value: Integer Real What it does: Sets an upper limit on the number of hot spots to report. without an offset set.dac job_name_002. Default is 200.dac job_name_302. These extra all time steps (sometimes unwanted) time blocks are created when first . of the first equal time step This environment variable removes equal time steps. The name of this file is <job_name>. the DAC file names start with: job_name_301. Prints header information to the loadmap file.Take the value of the last equal time step MDI_DUR_DEFNODE Recovers data for all nodes in the flexible body if no nodes or hot spots are specified in the FEMDATA statement.Take the value processing certain simulation commands. Sets the maximum swap space (in megabytes) when performing a modal stress recovery (MSR). Integer Creates a gap in the sequential naming of DAC channel numbers.dac If MDI_DUR_LOADOFFSET is set to 300. For example.map. Default is 400 MB.

1. max_increase.0 max: When step size changes.Setting Environment Variables 63 Adams/Flex Environment Variables The following are Adams/Flex environment variables: Variable name: MDI_FLEX_BODY_TESTING_OPTIONS Variable value: gamma: Scale factor. cratio changes by max 1% cratio: Initial value of cratio across all modes debug: Only applicable when using Adams/Solver (C++) What it does: The variable for auto_damping overrides the traditional flex-body default damping. cratio_initial) debug UNIX example: setenv MDI_FLEX_BODY_TESTING_OPTIO NS "auto_damping(1.0. useful range is 0 to 1.01.0)" . Variable: MDI_FLEX_BODY_TESTING_OPTIO NS Value: auto_damping(gamma. 0.

It creates a shell file at the start of the simulation with the naming prefix you specify.Use Adams/Solver (FORTRAN) MDI_ADAMS_CONTACT_OUT on/off Controls the export of intermediate contact events in data for a contact model. For example: var set var=test string=(PUTENV("MDI_ADAMS_SHELL_FILE_ PATTERN".64 Running and Configuring Adams Adams/Solver Environment Variables The following are Adams/Solver environment variables: Variable name: Variable name: MDI_ADAMS_CPU_COLUMN Variable value: Variable value: What it does: Waht it does: Displays elapsed CPU time for each simulation."msc")) Will result in files named as follows: msc1. Valid for Adams/Solver (C++) only. On: Enables intermittent contact output Off: Disables intermittent contact output MDI_ADAMS_SHELL_FILE_PATTERN Exports.shl . MDI_SOLVER_SELECT CXX or F77 Specifies the Adams/Solver type to use.Use Adams/Solver (C++) F77 . CXX . Note: This variable must be set before the simulation begins.shl msc2. as shell files. tessellated geometry representations used during contact.shl msc3.

0.05 ADAMS_VIBRATION_MIN_FLEX_PARTICIPATION Same as ADAMS_VIBRATION_MIN_PARTICIP ATION. This environment variable changes the percentage that is ignored. except valid for flex modes. Adams/Vibration finds the largest modal coordinate and ignores any other coordinates that are less than 10% of that value. (Use ADAMS_VIBRATION_MIN_FLEX_PA RTICIPATION for flex modes. set this environment variable to 0.) To include all system modes in the animation. .Setting Environment Variables 65 Adams/Vibration Environment Variables The following are Adams/Vibration environment variables: Variable name: ADAMS_VIBRATION_MIN_PARTICIPATION Variable value: What it does: Currently. during a vibration animation of flexible bodies. to ignore all modal coordinates that are less than 5% of the largest coordinate. on UNIX enter: setenv ADAMS_VIBRATION_MIN_PARTICIP ATION 0. Use this variable for system modes. For example.

Arial. Changes the default font used in Adams products. makes available several language functions used for DDE. Setting this may cause text on certain dialog boxes not to be displayed. MDI_GUI_FONT_SIZE MDI_MOTIF_STYLE MDI_MENUBAR_FONTSIZE MDI_MENUITEM_FONTSIZE MDI_NATIVE_PLOT_GRAPHICS 1 Size of text in menubar. specified in pixels. 11. this will deliver faster pageturning performance. An integer number such as 11 or 12. and Bookman. specified in pixels. X11 only If set. MDI_GUI_FONT_FAMILY Any font available on your system. MDI_AVIEW_DDE MDI_AVIEW_EXPERIMENTAL When set. specified in pixels. Contact Technical Support for more information. Entries are separated with a colon (:) on UNIX and semicolon (. runs the interface in native look and feel (usually Motif on SGI. Size of text in menus. Turn off the internal shell optimization code by setting to any value. so it is recommended to use values such as 10. Changes the default font size used in Adams products.66 Running and Configuring Adams Adams/View Environment Variables The following are Adams/View environment variables: Variable name: MDI_AVIEW_BITMAPS MDI_AUX_BITMAPS Variable value: What it does: Search path(s) for bitmap files. or 12. experimental code becomes functional. MDI_NO_SHELL_OPT . the native SGI style). MDI_COURIERFONT_SIZE X11 only Size of text in multi-line fields and selection lists.) on Windows. Windows only When set. On most platforms. It is now possible to have plots displayed using the native OpenGL driver rather than HOOPS. Examples include Rockwell.

Turns on dump of expressions in which recursion has been detected. This is a debug aid for very advanced users. Specifies the path for the Parasolid Schema files. X11 only Allows you to specify the general interface font with an X11 font pattern. enables stereo viewing. MDI_STEREO MDI_USE_DESKTOP_SETTINGS MDI_SHOW_NOWARN MDI_WARN_RECURSIVE 0 or 1 If set. MDI_X11_FONT_PATTERN . Set to any value other than null to stop displaying warning messages. If set to 0 or disabled. Specifies the path for the top level directory for help documents. the dialog will always be hidden.Setting Environment Variables 67 Variable name: MDI_ONLINE_BROWSER MDI_ONLINE_DIR MDI_P_SCHEMA MDI_PROGRESS_METER Variable value: What it does: Specifies the path to the browser to use for online help on UNIX platforms. If set. the desktop color scheme is not used. enables the progress meter dialog box when needed. If not set.

Currently. Set to new (for Netscape) or newtab (for Mozilla). set the environment variable to 1. The number of points could be so large that several points would be drawn at the same pixels. Setting MSC_PLOT_CONDENSE_THRESHOLD to a high value will impact performance.68 Running and Configuring Adams Variable name: MSC_FLATTEN_ADM Variable value: 0 or 1 What it does: Specifies the level of hierarchy in the adams_view_name tag. The degree of impact is dependent on several factors .the number of points. MSC_HELP_WIN_OPEN MSC_PLOT_CONDENSE_THRESHOLD 0 or An integer Number Opens a new browser window on UNIX. submodels. etc. To restore the previous behavior. Note: Some environment variables (MDI_PROGRESS_METER. . case insensitive). This benefits applications that use model hierarchy (UDEs. all datasets are written with full hierarchical names in the adams_view_name tags. and so on) and simulate with the external solver. for example) are only considered set if their value is either 1 or enabled (without quotes. the capabilities of the graphics card in use. The MSC_PLOT_CONDENSE_THRESHOLD capability was put in place because plot curves with a large number of points were being drawn somewhat slowly. The code was put in place to try to minimize the redundant drawing of pixels. only the drawing of the curves. No change was made to the curve data. This allows XML results files created with an external solver to be read in while retaining the same hierarchy as the model. Specifies the maximum number of condensed threshold points for curve plotting.

For example: 1. right/left Defines the preferred side for creating/modifying symmetric components. Launches a text editor where you can edit property files. Restores version 12.0.Setting Environment Variables 69 Template-Based Environment Variables The following environment variables are used in various Adams template-based products. The default is off. Sets the orientation of the global reference frame using direction cosines. The default is left. Toggles results file being written in xrf format. dialog boxes. sets the default selection in the Welcome dialog box. Variable name: MDI_ACAR_USERMODE MDI_ACAR_PLUS_AVIEW MDI_ACAR_USE_EDITOR Variable value: expert/standard yes/no Path to your text editor. your template-based product automatically outputs an analysis results file. Sets the orientation of the global reference frame using direction cosines. yes/no What it does: Sets the user mode.-1. MDI_ACAR_LOGO_BMP Path to the image you Replaces the image on the Welcome and Exit want to use. MDI_ACAR_WRITE_RES Outputs an analysis results file. Use is discouraged. yes/no yes/no on/off . For example: 0.0 CDB search algorithm. Gives you access to Adams/View. Direction cosines.0.exe. Sets your template-based product so that it does not display the Welcome dialog box at start up. Image size should be 192x192 pixels. If the model includes a flexible body. Writes the expanded file names to the adm deck. If you have expert-user access. For example: C:/Program Files/Windows NT/Accessories/wor dpad. MDI_ACAR_SIDE_PREF MDI_ACAR_INITMODE MDI_ACAR_MODEPROMPT MDI_ACAR_VEHICLE_REAR MDI_ACAR_VEHICLE_LEFT MDI_CDB_SEARCH MDI_CDB_EXPAND_PATH MDI_ACAR_XRF template_builder/sta ndard_interface yes/no Direction cosines.0.

to the analysis log file. log2. or use product default). Defines the path to your private configuration file.70 Running and Configuring Adams Variable name: MDI_ACAR_ANL_LOG1 MDI_ACAR_ANL_LOG2 MDI_ACAR_ANL_LOG3 MDI_<product name>_PRIVATE* MDI_<product name>_SITE* MDI_<product name>_PRIVATE_DIR* MDI_<product name>_PRIVATE_CFG* MDI_ACAR_SOLVER_PREF Variable value: Component name. and log3. about the components you specify. You can select up to three components to correspond to log1. Defines the path to the private repository. C++. F77/CXX/none Defines the type of solver you are using (FORTRAN. What it does: Writes additional information. . For example: hardpoints and parts. Defines the path to the site repository.

essentially returning to the v2003 release behavior. simply add the following line into your private configuration file: MDI_UPDATE_CFG . Adams/Car defaults to the 'live' private configuration file. and the MDI_UPDATE_CFG environment variable allows a user to turn off the auto-update feature. This autoupdate of the private configuration file is also referred to as the 'live' configuration file. yes/no This environment variable tells Adams/Car whether the private configuration file should be automatically updated during the session to reflect CDB Database changes. with a default error tolerance of the value specified.Setting Environment Variables 71 Variable name: MDI_AENG_HHT_ERROR Variable value: What it does: Any positive number Sets the HHT integrator as the default integrator. To disable the auto-update of the private configuration file.

"verbose" or 2 Driving Machine settings logged to (. This setting produces a large output file and slows execution speed. *Where product name can be ACAR.3 What it does: Full Vehicle Simulation Debugging To aid debugging full vehicle simulations Adams/Car adds new logging capabilities. "develop" or 3 Driving Machine data structures dump to debug file. "on" or 1 Additional information logged in the solver message (.1. The settings for VEHICLE_SOLVER_DEBUG as shown in the table below may be case insensitive strings or integers. .acar.72 Running and Configuring Adams Variable name: MSC_ADAMS_VDM_DEBUG Variable value: 0.2.cfg file. Setting Action ------------------------------------------------"off" or 0 No additional logging performed.sdl) file. You access these capabilities by setting the value of the environment variable VEHICLE_SOLVER_DEBUG in your private .msg) file.

Setting Preferences .

and all module licenses (Adams/Tire ) in these cases: • You run a simulation using the external Adams/Solver (as before). Adams/Solver.cshrc file. kinematic. hold_solver_license. by default.Software Applications . and dynamic). • After a design study. setting default colors for plotting in Adams/Solver. then Adams/View checks out the necessary licenses when you perform a model verify operation (because of the degrees of freedom calculation. You can also use the Adams toolbar to set preferences for Adams products. such as your . which uses Adams/Solver) or any type of simulation using the internal. however. • If you set hold_solver_license to no. and so on) using the integrated Adams/Solver. Adams/Solver License Sharing When you use Adams/View to perform a simulation. • When you reset after a single simulation (transient. set a simulation preference. it uses an Adams/Solver license. or optimization analysis (licenses are held throughout the parametric analysis). or integrated. and others. You can change the simulation preference using the Adams/View command: simulation set hold_solver_license=yes/no • If you set hold_solver_license to yes. it does not check the license back in for another user. You can. Once the simulation is complete. You must exit Adams/View before other users can use the Adams/Solver license. • After a model verify operation. Note: Memory size changes do not take effect until you restart the Adams product. use the Command Navigator to enter the commands simulation set.74 Running and Configuring Adams UNIX Preferences Some infrequently used configuration options for Adams/View and Adams/Solver require that you set environment variables by modifying startup scripts. Adams/Solver Preferences You can use environment variables to do the following for Adams/Solver: • Modifying the Default Colors in Adams/Solver • Setting Remote X11 Access to MSC. A dialog box appears in which you can temporarily set the default. static. It only releases the licenses when you exit Adams/View or when you run a simulation using the external Adams/Solver. design of experiment. Adams/View releases all Adams/Solver licenses (static. These options include as setting license sharing. To change the default for only one Adams/View session.

in a startup script. Setting Color Display You can modify default colors for displays and plots by setting environment variables. shown below. Setting Monochrome Display If you have a monochrome screen or if you want the screen image to appear in monochrome. you can replace TYPE (in uppercase letters) with COLOR for color or MONOCHROME for a black and white.Setting Preferences 75 Default Colors in Adams/Solver You can modify the default colors for interactive graphics in Adams/Solver by setting the values of the environment variables.cshrc. line. the name of a variable. You can set the screen so that it is monochrome or you can set the colors of background. and the name of the color or type for the preceding variable. The following is an example of the Adams/Solver color settings: # Modify these variables to change the default colors for Adams/Solver # setenv ADAMSPP_SCREEN_RENDITION "TYPE" setenv ADAMSPP_BACKGROUND_COLOR "BLACK" setenv ADAMSPP_LINE_COLOR "GREEN" setenv ADAMSPP_TEXT_COLOR "WHITE" setenv ADAMSPP_PLOT_GRID_COLOR "ORANGE YELLOW" setenv ADAMSPP_PLOT_CURVE1_COLOR "CYAN" setenv ADAMSPP_PLOT_CURVE2_COLOR "GREEN" setenv ADAMSPP_PLOT_CURVE3_COLOR "BLUE" setenv ADAMSPP_PLOT_CURVE4_COLOR "YELLOW" Each command includes the instruction. such as "BURNT . text. and plots. such as . Setting this variable to monochrome overrides any settings for color even if you set one or more environment variables for colors in the same Adams/Solver session. You must use double quotation (" ") marks to enclose a type name with embedded spaces. you can set the following environment variable: setenv ADAMSPP_SCREEN_RENDITION TYPE In the environment variable. set one or more of the following variables: setenv setenv setenv setenv setenv setenv setenv setenv ADAMSPP_BACKGROUND_COLOR "COLOR NAME" ADAMSPP_LINE_COLOR "COLOR NAME" ADAMSPP_TEXT_COLOR "COLOR NAME" ADAMSPP_PLOT_GRID_COLOR "COLOR NAME" ADAMSPP_PLOT_CURVE1_COLOR "COLOR NAME" ADAMSPP_PLOT_CURVE2_COLOR "COLOR NAME" ADAMSPP_PLOT_CURVE3_COLOR "COLOR NAME" ADAMSPP_PLOT_CURVE4_COLOR "COLOR NAME" You can replace COLOR NAME (in uppercase letters) with any of the available 65 colors. To change the colors for some or all of the variables.

Available colors are: APRICOT AQUAMARINE BITTERSWEET BLACK BLUE BLUE GREEN BLUE GREY BLUE VIOLET BRICK RED BROWN BURNT ORANGE BURNT SIENNA CADET BLUE COPPER CORNFLOWER CYAN FOREST GREEN GOLD GOLDENROD GREY (GRAY) GREEN GREEN/BLUE GREEN/YELLOW INDIAN/RED LAVENDER LEMON/YELLOW MAGENTA MAHOGANY MAIZE MAROON MELON MIDNITE/BLUE MULBERRY NAVY BLUE OLIVE GREEN ORANGE ORANGE RED ORANGE YELLOW ORCHID PEACH PERIWINKLE PINE GREEN PINK (CARNATION PINK) PLUM RAW SIENNA RAW UMBER RED RED ORANGE RED VIOLET SALMON SEA GREEN SEPIA SILVER SKY BLUE SPRING GREEN TAN THISTLE TURQUOISE BLUE VIOLET/PURPLE VIOLET/BLUE VIOLET/RED WHITE YELLOW SPRING GREEN The color names in parentheses are alternative names for the preceding color. if you are using an X terminal to log onto a workstation . If you do not set a color for a given variable. Adams/Solver uses the default color. such as GOLD. it does not display an error message.Software applications graphics by setting the DISPLAY environment variable. Adams/Solver displays an error message. If you misspell a COLOR NAME. For example. If you misspell a variable. Adams/Solver uses the default color for that variable. however. You do not need to use the double quotation marks to enclose a type name if it is a single word. Remote X11 Access to MSC.Software Applications You can use a remote X11 device to display the MSC.76 Running and Configuring Adams ORANGE".

3. You can use the environment variable TMPDIR in your . Right-click the Adams Toolbar tool. To set the number of times to check out a license: 1.0 For more information on accessing Adams/View through remote X11 devices. 2. click MSCA. enter the following in your . see Adams/View Preferences. You can direct Adams to place the temporary files in any directory. Set the number of times. as long as you have the appropriate permissions to that directory. The Registry Editor appears with options for setting all products. is 60 seconds. In the treeview. and the Adams Registry Editor displays any shared preferences for each product.cshrc to set where Adams places the temporary files.cshrc: setenv TMPDIR /usr/users/me/tmp In the Adams Toolbar Preferences in the Adams Toolbar You can set preferences for all products at once or for a particular product. it places them in /var/tmp. By default. and then select Start Registry Editor. In addition. you can set the DISPLAY environment variable at the operating system prompt to include the name of the X terminal: X terminal name is: xcitement DISPLAY variable: setenv DISPLAY xcitement: 0. Not all products have preferences that you can set.Software applications. to direct Adams to place temporary files in the directory /usr/users/me/tmp. 4. In the Registry area. For example. Adams Product License Checkout You can specify the number of times an Adams product attempts to check out a license. Adams Toolbar checks the registry entry licenseRetry to determine how many times it should try to check out its license. and then select OK. click licenseRetry. . Temporary File Location You can change where Adams places temporary files it generates during a simulation. which you cannot change. many products share preferences with other products.Setting Preferences 77 licensed to run MSC. The default is 60 attempts and the time interval between each check.

To set preferences for a particular product: 1. For your convenience. shown in the table below. the preferences for Adams/Solver are included with the preferences for Adams/Chassis in the Registry Editor. Right-click the product's tool. workingDirectory is empty and does not affect the location in which the output files are generated. see Adams/Solver Preferences. or change the location where Adams/Chassis looks for input files. Change the preferences as listed in the next sections: • Adams/View Preferences • Adams/Solver Preferences • Adams/PostProcessor Preferences • Template-Based Product Preferences • Adams/Chassis Preferences 3. For more information.78 Running and Configuring Adams To set all product preferences at once: • Right-click the Toolbar tool . By default. Note: Any defaults for Adams/Solver also apply to Adams/Chassis. Parameter: guiMode Description: Sets the mode in which Adams/Chassis runs: Standard .Runs Adams/Chassis analysis environment. 2. For information on preferences specific to Adams/Solver. . and then select the Change Settings command. workingDirectory Specifies a directory where Adams/Chassis writes output files and searches for input files. and also has a private set of its own. Adams/Chassis Preferences Adams/Chassis shares preferences with Adams/Solver. The Registry Editor appears with options for setting all products. and then select Start Registry Editor. see the Adams/Chassis online help. as shown below. Select OK.

you also affect the graphics preferences for Adams/Car. be sure that you are setting the preferences for the desired library or standard Adams/Solver. Before setting your preferences. Note: You may have several user libraries. To verify Adams/Solver: • On the Adams Toolbar. The name you assigned to the library appears in the tip text. see Adams/View Preferences. For more information. for standard Adams/Solver and for user libraries that you created to run with Adams/Solver. indicates that you are running Adams/Solver with a user library. the Graphics folder appears when you select Change Adams/PostProcessor Settings from the Toolbar. To verify which one is active. see Creating User Libraries. and select Info to see information about the library. listed in the table below. right-click on the tool.Setting Preferences 79 Adams/PostProcessor Preferences Adams/PostProcessor shares graphical settings with Adams/View. . move your mouse over the tool until the tip text appears. Adams/Solver Preferences You can set preferences. Note: When you change graphical preferences for Adams/Processor. check the appearance of the Adams/Solver tool: indicates that you are working with the standard Adams/Solver. For more information about user libraries. and Adams/View. For your convenience. Each library has its own set of preferences. Alternatively.

Currently. For more information on the different solvers. For this to take effect. check with the administrator who installed the Adams products.80 Running and Configuring Adams Parameter: solverSelection You can select either: Description: Fortran Solver . remoteHostID memSize custMemModel . C++ Solver . numCPUs You can set the number of CPUs on which you want to run Adams/Solver on SGI R10000.Our commercially available solver (F77). memSize must be set to custom. see the online help for Adams/Solver. Sets the memory model Adams/Solver uses to simulate a model. Note: Network access and multi-task package licenses allow you to submit tasks to Adams/Solver while Adams/View runs on one of many desktop workstations. and has an improved methodology for identifying and handling redundant constraints. The name of the Adams/Solver installation directory on the remote machine. For information on creating a memory model. Sets the name of a custom memory model that you have previously created. You can select the standard memory models provided.Our C++-based solver. If the corresponding number of licenses is not available at the time of the simulation. The directory is optional. The number also indicates the number of licenses Adams/Solver checks out during a simulation. provides new linear analysis capabilities. as well as any custom models you created. see Creating a custom memory model. check the licensing information on the password certificate that is included in the Installer's Kit. which is faster. If you do not know the type of license you have. Adams/Solver issues an error message indicating that the number of licenses is not available and suggests that you reduce the number of CPUs requested. remoteHost remoteHostWD Specifies a directory that Adams/Solver uses to write out its files and search for input files. Name of the remote host where you run Adams/Solver.and 12000-based systems. it does not support all modeling elements that the FORTRAN Solver supports. You need to specify it only if the user's file system is not automounted on the remote machine upon log in. To see if you can submit multiple tasks to Adams/Solver.

The parameters are global graphics settings. check the appearance of the product tool: indicates that you are working with standard Adams/View.Adams runs with the command file that you specify in workingDirectory runMode the parameter inputFile. (If you have not specified a command file and you run in scripted mode. You can enter the path name of your command file or right-click in the text box and select one using the File Browser. Before setting your preferences. • Scripted . such as Adams/Car. or change the location where Adams/Solver looks for input files. Sets the mode in which Adams runs: • Interactive .Adams/Solver runs with the command file specified in the inputFile. They affect all Adams products that have a user interface. Specifies a directory where Adams/Solver writes output files and searches for input files. indicates that you are running Adams/View with a user library. . You can view and change them only when you are working with standard Adams/View.Adams runs and waits for user input. Adams/Solver launches interactively. • Preferences for Adams/View only . By default. Adams/View Preferences You can set two types of preferences in Adams/View: • Preferences for Adams/View and any user library . and run in batch mode. Adams/Solver launches in interactive mode. the parameter is empty and does not affect the location in which the output files are generated.) • Batch . To verify Adams/View libraries: • On the Adams Toolbar.The parameters can be different for each user library that you create to run with Adams/View and for standard Adams/View.Setting Preferences 81 Parameter: inputFile Description: Specifies that Adams/Solver use the command language file (. be sure that you are setting the preferences for the desired library or standard Adams/View. They appear in the Registry area as a subfolder. If you have not specified a command file.acf) when running in scripted or batch mode. Graphics.

Adams/View runs with the command file that you runMode specify in the parameter inputFile. see Modifying the Adams Path Files. inputFile searchPath description . Specifies that Adams/View use a specified command language file (*.Adams/View runs and waits for user input. memSize must be set to custom. For this to take effect. and select Info to see information about the user library. The name you assigned to the user library appears in the tip text. Alternatively.) custMemModel solverUserLibrary memSize Sets the name of a custom memory model that you have previously created. Allows you to specify the path file that contains search paths for different types of files that can be loaded into Adams/View. such as what it does or how it was created. or change the location where Adams/View looks for input files. verify which one is active by moving your cursor over the tool until the tip text appears. Available for user libraries only. Sets the Adams/Solver user library to run from within Adams/View.cmd) when running a product in scripted mode. You can select the standard memory models provided as well as any custom models you created. right-click on the tool. the parameter is empty and does not affect the location in which the output files are generated. Sets the mode in which Adams/View runs: • Interactive . (If you have not specified a command file and you run in scripted mode. For more information on path files. Adams/View launches in interactive mode. see Creating a custom memory model. For information on creating a memory model. Text that describes the library. By default. General Preference Settings in Adams/View Parameter: workingDirectory Description: Specifies a directory where Adams/View writes output files and searches for input files.82 Running and Configuring Adams Note: If you have many user libraries. • Scripted . Sets the memory model Adams/View uses to simulate a model.

Adams/View places the cache in memory. textEditor Available for standard Adams/View only. The cache can be as large as several hundred megabytes. A project name that appears on the Adams Toolbar and identifies the user library. When performing animations that contain flexible bodies. Adams/View often produces a large cache of data before it can perform the animation. Adams/View may exit with an Out of Memory message. If the disk space is not available. such as AView1.Setting Preferences 83 General Preference Settings in Adams/View Parameter: shortName Description: Available for user libraries only. fileCaching Available for standard Adams/View only. Note that storing the cache on disk results in longer animation setup time (up to two times). The default is to produce these caches on disk if there is enough disk space available. . You can disable file caching to increase animation setup speed but if there is not enough memory to produce a cache. Specifies the text editor to be used by default.

it uses the hardware acceleration to render overlay planes. OpenGL Software Assisted is slower than Graphics Driver because the screen refresh rate for the overlay plane will be affected by the other geometry in the view. extrusions. If you have one of these graphics cards. Object names when in selection mode. Select X11 to resolve this problem. OpenGL Software Assisted . and revolutions. Temporary geometry when sketching curves. The overlay planes are used for the: Rubber band box drawn for selection or zoom. then you should use OpenGL Software Assisted. and the native driver lets Adams/View use any specialized or high-performance graphics hardware on the system. The X11 driver lets Adams/View run from remote X terminals. Temporary geometry (arrows) displayed when creating joints. Adams/View supports the X11 window driver as well as the one for the native graphics capabilities of the system. If the machine on which you are displaying Adams/View does not have the hardware to meet Adams specifications. If you selected the option Native Open GL for Graphics Driver. Some graphics cards do not offer hardware acceleration for overlay planes.84 Running and Configuring Adams Global Graphics Settings in Adams/View Parameter: Graphics Driver Description: On all platforms. Software assistance simply means that Adams/View draws the overlay plane geometry instead of relying on the hardware. a warning message appears.

Specifies the name and location of your private configuration file. The default setting is 300 dots per inch (DPI). disable this option to remove the background and leave the text. see the online help for your template-based product. see the online help for your template-based product. which the background is. and a shared set with Adams/Solver and Adams/View. Hardcopy Resolution does not affect wireframe images.1 and earlier) used a default resolution of 75 DPI. For more information. such as the names of modeling elements and position coordinates. For more information.Setting Preferences 85 Global Graphics Settings in Adams/View Parameter: Double Buffering Description: Double buffering of screen updates in Adams/View provides fluid animation updates. Specifies the location of your private repository. If you are using the X11 Window driver in Adams/View. and will likely increase processing time for the printer. Note also that larger values produce larger postscript files. Parameter: siteDir Description: Specifies the location of the site repository in which you have created user libraries or binary files. Because some graphics cards do not fully support OpenGL with overlay planes. For more information. shown in the table below. doublebuffering uses more memory and generally runs slower than double-buffering with native graphics. Overlay Backgrounds Controls whether or not a background appears behind pop-up text. Note that earlier versions of Adams/View (10. you may not be able to see the text. see User Library Overview and Binary Files. privateDir privateCfg . such as xy plots. We do not recommend that you use a resolution lower then 75 or higher then 600 DPI. If this occurs. Specifies the resolution for shaded images written to a postscript file. Hardcopy Resolution Template-Based Product Preferences The template-based products have a private set of preferences.

cmd)when running in scripted mode. the template-based product launches in interactive mode. the parameter is empty and does not affect the location in which the output files are generated. If you have not specified a command file. and run in batch mode.Runs and waits for user input.acf) when the Adams/Solver executable runs in scripted or batch mode.86 Running and Configuring Adams Parameter: runMode Description: Sets the mode in which the product runs: • Interactive . or change the location where the product looks for input files.cmd) when the Adams/View executable runs in scripted mode. the preferences for Adams/View and Adams/Solver are included with the preferences for the template-based product in the Registry Editor. workingDirectory Specifies a directory where the template-based product writes output files and searches for input files.Runs with the command file specified in the parameter inputFile.Runs with the command file that you specify in the parameter inputFile. By default. • Scripted . as shown next: For information on preferences specific to Adams/Solver and Adams/View. inputFile Specifies that the template-based product use a specified command language file (*.) • Batch . see Adams/Solver Preferences and Adams/View Preferences. • For Adams/Solver: specifies the command file (. the template-based product launches in interactive mode. • For Adams/View: specifies the command file (. . (If you have not specified a command file and you run in scripted mode. For your convenience.

• HOOPS OpenGL and MSW driver • Miscellaneous graphics settings . Native OpenGL with software assistance is slower because the screen refresh rate for the overlay plane will be affected by the other geometry in the view. 4.Turns on/off double buffering. 3. • Object names when in selection mode. then you should use Native OpenGL with software assistance. which the background is. Adams Environment You can set the following options for the Adams/View and Adams/Solver environment: • Current Graphics settings . • Temporary geometry (arrows) displayed when creating joints. The overlay planes are used for the: • Rubber band box drawn for selection or zoom. you may not be able to see the text. double-click System. Software assistance simply means that Adams/View draws the overlay plane geometry instead of relying on the hardware. Some graphics cards do not offer hardware acceleration for overlay planes. Enter the variable MDI_PAUSE and set it to 1.The options are: • Native OpenGL either hardware or software-assisted . and revolutions. Because some graphics cards do not fully support OpenGL with overlay planes.Setting Preferences 87 Windows Preferences Adams/Solver Pausing You can set the variable MDI_PAUSE to set a pause after Adams/Solver starts running in interactive mode.Controls whether or not a background appears behind pop-up text. 2. disable this option to remove the background and leave the text. and then select Control Panel. From the Start menu. point to Settings.OpenGL with hardware assistance uses the hardware acceleration to render overlay planes. . To activate the pause: 1. extrusions.The options are: • Double buffering . Select OK. If this occurs. The default setting is 0 for no pause. and then select the tab Environment. • Temporary geometry when sketching curves. • Overlay backgrounds . such as the names of modeling elements and position coordinates. From the Control Panel folder. If you have one of these graphics cards.

3. • Adams editor . it must be found by the PATH environment variable in Windows. or enter another editor in the Other text box (for example.1 and earlier) used a default resolution of 75 DPI.bin .Specify a default Adams working directory by entering it directly. install_dir.cmd .gra . beneath the installation directory. and will likely increase processing time for the printer.88 Running and Configuring Adams • Memory model size . It is in the aview subdirectory. and then select Adams .dat . point to MSC. Note that if you enter the name of another editor. 2. point to MSC. You can also define a custom memory model as explained inSetting Custom Memory Model Size on Windows.Adams 2007 x (where x is the release number). Select OK. The following tables show the variable and array size for the memory options and explain each variable and array.You can set the memory model size for when Adams/View is loading a model or when Adams/Solver is solving the equations of motion. The aview.Software.igs c:/install_dir/aview/ c:/install_dir/datasets/ c:/aview/cmd_files/ c:/adams/test_data/ c:/staff/my_home_dir/adams/output/ c:/staff/my_home_dir/adams/output/ c:/staff/my_home_dir/adams/output/ c:/staff/my_home_dir/adams/iges_files/ . point to Programs. Hardcopy Resolution does not affect wireframe images. Set the options. Memory Model Sizes • Current product settings . Search Paths At installation.req .The option is: • Hardcopy Resolution . Adams/Driveline. Select the standard Windows Notepad editor. From the Start menu. To set preferences: 1. The default setting is 300 dots per inch (DPI).pth file: .Specifies the resolution for shaded images written to a postscript file. such as xy plots. Below is an example of an aview.res . The Adams registry editor appears. as necessary. Note that earlier versions of Adams/View (10. and Adams/View. Adams products. • Adams home directory . including Adams/Car.Settings. We do not recommend that you use a resolution lower then 75 or higher then 600 DPI.Specify a text editor. vi.exe). or by browsing your file system.pth file.adm . This is useful for files that are shared with other users. Note also that larger values produce larger postscript files. and are not in your current working directory. create a default aview.pth file allows you to specify search paths for the different types of files that can be opened in Adams/View.

you do not have to name your files with the standard Adams/Solver and Adams/View extension. • Complete each search path. Use the following conventions to add a file extension to the path file: • Begin each line in column one with the desired file extension. If you want to make the changes to the Adams/View path file affect all Adams/View users. Therefore. edit the default aview. • Separate the extension and search path for the extension with space. • Begin each file extension with a .bin. The first line in the example file above specifies a search path for files with an extension of . starting from the root (/) of the file system. . or a combination of these.pth file mentioned above. • Ensure that each line is less than 255 characters in length. (period).Setting Preferences 89 . Remember that each line must begin with a file extension. Any file extension can be put in the Adams/View path file. You can use a single space. • End each search path with a trailing / (forward slash). tab. You can have multiple paths for each extension by adding another line with the same file extensions and an alternate path.dct c:/usr/install_dir/aview/ Each line in the file specifies a search path for a specific file extension.

90 Running and Configuring Adams .

Sign up to vote on this title
UsefulNot useful