Linux
User Libraries on Linux
To create a user library on Linux:
1. Do one of the following:
■For a product for which you can only create one type of user library, right-click the product tool, point to New, and then select [Product] User Library.
■For a product for which you can create either an interface or Adams Solver library, right-click the product tool, point to New, point to [Product] - Interface or [Product]-Solver, and, if required, select the location for the library you want to create.
The Enter Parameters for User Library list appears in the Registry area with several parameters that you can modify.
2. Click the parameters you want to change and enter their values as needed.
Parameter: | Meaning: |
|---|
name | A project name identifies the user library, such as AView1. It also determines the file name of the library, such as AView1.so. The project name must be unique. You cannot create two libraries with the same name.
Not available for Adams Car, and Adams Driveline, because you cannot run the resulting library directly from the Adams Toolbar. |
description | Text that describes the library, such as what it does or how it was created. Not available for Adams Car,and Adams Driveline, because you cannot run the resulting library directly from the Adams Toolbar. |
libPath | A directory indicating where to store the resulting library. Not available for Adams Car, and Adams Driveline, because you specify the library location when you first create it as either your private or site location. |
sourceFiles | One or more individual C or FORTRAN files, source or object files, or a list file (*.lst) that contains a list of C or FORTRAN files. You can mix C and FORTRAN source files. The list file must contain one file per line. |
debug | Selects whether or not to build the library in debug mode. |
The parameters, name and libPath, have default values based on a simple counting scheme and the name of the product for which the user library is being created, such as AView1, AView2, ASolver1, and so on. You can use other values that have more significance.
Note: | You must enter one or more source files for the parameter sourceFiles. If you do not enter source files, the Adams Toolbar does not create a library. |
3. Select OK.
A window appears, showing the compilation and linking process that builds your custom library. When the creation is complete, the following occurs:
■A new entry appears on the Select Library menu from the product icon on the Toolbar. The name of the file is the name of the menu.
■If the directory you specified for libPath does not exist, Adams Toolbar creates it. It places the new library and a log file about the creation in the directory.
■Adams Toolbar creates or changes the appropriate registry entries to reflect the new entity.
Deleting User Libraries
You can delete any library registered in the Adams Toolbar. When you delete the library, Adams Toolbar asks you if you want to just remove the library from the Toolbar or delete the actual library file from its directory. If you select to just remove the library from the Toolbar, you can add it back into the Toolbar as explained in
Importing Existing User Libraries.
To delete a library:
■Right-click the tool for the product whose library you want to import, and then select Remove Custom: [customName]. For example, right-click the Adams View tool, and then select Remove Custom: Aview1.
Importing Existing User Libraries
You can import user libraries that have been created by others so you can run them from your Adams Toolbar.
To import user libraries:
1. Right-click the tool for the product whose library you want to import, and then select Import Existing Custom Library. For example, if you are importing an Adams View library, right-click the Adams View tool, and then select Import Existing Custom Library.
2. Click name and enter the name of the library file.
3. Click description and enter text describing the library.
4. Select OK.
Adams Toolbar adds the library to the list of libraries available to run with that product.