The interface works in both a Plug-in and a Reader mode.
The existence of the Plug-in is recognized by NX based on the UGII_CUSTOM_DIRECTORY_FILE environment variable. If the variable points to a text file, NX reads the text file and interprets each line as a directory containing a NX third party Plug-in. NX loads the ANSYS NX geometry interface from the appropriate directory specified in the file.
In Linux, however, the plug-in mode for the ANSYS geometry interface is not supported. The reader mode uses a client-server implementation of the ANSYS NX geometry interface.
After launching NX, if the ANSYS (version specific) menu is not displayed, run the CAD Configuration Manager with NX selected for configuration (Start->Workbench->Utilities->CAD Configuration Manager in Windows or ansys_inc/v(version specific)/commonfiles/CAD/bin/linx64/Ans.CadInt.CADConfigUtilityGUI.exe in Linux).
See CAD Configuration Manager for usage information.
For detailed installation information about the CAD Configuration Manager, see:
| Linux: Configuring CAD Products> Using the CAD Configuration Manager |
| Windows: Configuring CAD Products> Using the CAD Configuration Manager |
At the time of release, detailed version support information for the Linux and Windows platforms is accessible via Geometry Interface Support.
Both part and assembly document import is supported.
Information about post-release CAD system compatibility with ANSYS Workbench is viewable via the ANSYS, Inc. website (Support> Platform Support). See ANSYS Platform Support.
Table 17: Import Preference Support for UG NX geometry interface
| Import Solids | Yes | ||
| Import Surfaces | Yes | ||
| Import Lines | Yes — lines consumed by NX features are not imported | ||
| Parameter Processing and prefix/suffix key | Yes | ||
| Attribute Processing and prefix | Yes | ||
| Named Selection Processing and prefix | Yes - from ANSYS Named Selection Manager and programmatically created attributes, user attributes, colors, etc. | ||
| Material Processing | Yes | ||
| Analysis Type |
| ||
| Associativity | Yes | ||
| Coordinate Systems | Yes - including visible WCS | ||
| Work Points | Yes | ||
| Reader Save File | Yes | ||
| Instancing | Yes, except lines | ||
| Smart Update | No | ||
| Enclosure and Symmetry Processing | No | ||
| Mixed Import Resolution | Yes - for parts that include both solid and surface bodies AND the Import Solid and Import Surface preferences are set to Yes | ||
| Decompose Disjoint Geometry | No |
Tabular Material Data When importing tabular data for a material property, the first data point is used to complete the material definition.
NX Color Attributes NX color attributes can be imported using the 'Color' key in the list of attribute or the named selection keys. Once the attribute or named selection import is enabled in the WB2 geometry properties window, append the 'Color' key in the list of keys, separated by semicolons, to import the NX color attributes. Note that, beginning with Release 14.5, the option for 'NX Color Processing' is not supported and is removed from the CAD configuration.
Load Options Load options for a part can be specified during the import. The Plug-in will first attempt to load the options from the options file specified using the UG_LOAD_OPTIONS environment variable. If it fails, an attempt to load the load_options.def file from the part directory is made. If both the attempts fail, a third attempt is made to load the options from %HOME%\load_options.def, where HOME is an environment variable pointing to the user's home folder. See the NX documentation for more information on the usage of load options.
Part Units in an Assembly All parts in an assembly must have the same unit for a successful import. Use the ug_convert_part command to convert all parts in an assembly in the same unit. To do this, launch the NX command prompt from the programs menu. For NX 11.0 the command prompt can be found in Programs > Siemens NX 11.0 > NX Tools > Command Prompt. Type 'cd< Directory>' to change to the directory containing the assembly. Run the command 'ug_convert_part -mm -d -s -y' or 'ug_convert_part -in -d -s -y', without the quotes to change the unit to millimeter or inch, respectively. See the NX documentation on the ug_convert_part command for more information.
Using Multiple Versions of NX If you have multiple versions of NX installed, you must make sure that the UGII_BASE_DIR and UGII_ROOT_DIR environment variables point to the correct version of NX when running the ANSYS Mechanical application in Reader mode.
The NX reader will use the version of NX set by these variables when processing the attach or updates. Parts files are saved in the format designated by the above two variables. In Linux, the environment variable can be set in the shell configuration file to achieve this.
Maintaining Associativity of Persistent IDs The object associativity is of particular importance if you update/refresh a geometry with applied loads and supports. The ANSYS NX geometry interface uses the User Defined Objects (UDO) to store persistent IDs. To maintain the associativity of the geometry between NX and the ANSYS Mechanical application, you need to save the part file at the end of a NX session (Plug-in), or save the NX part file from within the ANSYS Mechanical application (reader). Saving the part file from within the ANSYS Mechanical application at attach time requires that you first check the 'Reader mode saves updated file' checkbox under the 'Advanced Geometry Options' group on the ANSYS Workbench Project page. The part file will be saved at the end of an attach process using the same file name in the same directory. The current part file will be backed up by changing the extension of the file to bak before saving the part. Make sure that the file is not set to read-only.
If you do not save the parts files, during an update after the initial attach, the loads and supports could disappear or be applied to the wrong entities.
You should avoid setting Reader Save Part File to Yes on Linux platforms if a CAD file is open. Doing so can result in an unexpected behavior.
Facet Smoothness Control The geometry faceting obtained by the ANSYS NX geometry interface is view-dependent. That means the facet smoothness of the imported geometry depends on how the object is displayed on the screen. Although the default settings are generally acceptable for most of the cases, these may not be adequate for a geometry needing smoother facets. The facet smoothness in such cases can be controlled by the ANS_UG_FACET_AFFINITY environment variable.
The variable can be set to any floating point number from 1e-8 to 1e+8. The higher the value is, the finer the facet will be and the longer it will take to import the geometry. If the variable is absent or outside the acceptable range, 1.0 will be assumed as the default value for it.
Note that this environment variable may get removed entirely or replaced by a more user friendly variation in the future release.
Using the Teamcenter Import Double-click on the NX part file in the Teamcenter Portal. This will open the part file in NX. Attach the model into the ANSYS Mechanical application using ANSYS 18.2 > Workbench menu item and optionally perform one or more analyses.
Save the project archive file into the Teamcenter database using File> Save to Teamcenter in the ANSYS Workbench project page. It will prompt you for the Teamcenter user name and password and other information. Provide your credentials to check-in the project archive.
For detailed information, see CAD Integration ANSYS Teamcenter Connection (Workbench help> CAD Integration > ANSYS Teamcenter Connection).
AIM Behavior Attempting to start AIM from the ANSYS menu in CAD with an unsaved model will issue an exception in AIM.
Imported Body Size All NX bodies must be within a 1000 x 1000 x 1000 meter cube, centered about the origin of the absolute coordinate system.
Initial Launch After installation of ANSYS Workbench, importing an NX model using the Reader mode requires the CAD be launched one time. Otherwise, the first attempt to import will fail, but subsequent attempts will work normally.
Large Number of Named Selections In an assembly or a part with a large number of named selections, close to about a thousand, NX might close unexpectedly when you try to add more than 10 named selections at a time in the list. To avoid the problem, add few named selections at a time, close the named selection manager and save the part. This problem does not affect a list of named selections less than about a thousand, and the workaround is not needed for such cases.
Length Unit The ANSYS Mechanical application automatically sets the length unit in the part or assembly to match the unit saved in the NX file. No adjustment of length unit is necessary or possible.
Linux Issues Linux uses a client-server implementation of the NX reader. Currently, there is no Plug-in version of the feature. For this reason, some of the features that require direct communication with NX, are not supported by the Linux version. For example, the associativity support and Teamcenter import are not available in Linux.
If a problem is observed during an import in Linux, you should use the corresponding Windows version for it. The saved project can then be opened in Linux version of the ANSYS Workbench for further processing.
Material Property Values There are known irregularities in material property values passed from NX to ANSYS Workbench. The user should validate all material data prior to solving.
Missing BSpline Geometries in DesignModeler Some solids, surfaces and lines containing Bspline geometries may not import correctly into the DesignModeler application, but should import correctly in the ANSYS Mechanical application. Since these Bspline geometries do not conform to the Parasolid standard, they do not import correctly into the DesignModeler application. Newer geometries containing Parasolid-friendly Bsplines can be imported into the DesignModeler application without any problem.
Mixed Unit Support All parts and sub-assemblies should be in the same unit. Models with mixed units imported into the ANSYS Mechanical application will trigger a warning indicating the mixed unit. Note that Siemens NX and PTC Creo are the only CAD systems that can provide mixed unit assembly data correctly to ANSYS Workbench.
Multibody Parts For multibody parts, the bodies are grouped together and placed under part node in the ANSYS Mechanical application. If the multibody part is also multi-dimensional (i.e. contains both surface and solid bodies), this may cause a meshing problem. Bodies with different dimensions in the same part cannot be meshed in ANSYS Mechanical. An assembly, instead of a multi-dimensional multibody part, can solve the problem in such cases.
Named Selection Delete Problem with Wave Linked Features Features containing wave linked geometries may not show the correct number of named selections after some of the named selections are deleted. For example, if an "Extracted Face" feature is created from a solid body and a named selection is created containing both the geometries, deleting that named selection may not delete it from the list. To fix the problem, close the Named Selection Manager and update the geometry using Edit> Feature> Playback or Tools> Update> Update for external change. The named selection manager should reflect the correct number of named selections after the update.
Parameter Update Fails Instead of Displaying a Warning Message The NX plug-in performs an undo operation when it encounters an error or a warning during a parametric update. The undo operation allows the user to change the parameter back to a correct value. Please fix the error or the warning message in NX before performing a parametric update on such a part. Alternatively, set an environment variable called UGII_UPDATE_FAIL_OPTION with a value “ACCEPT” or “ACCEPT_ALL” without the quotes and unset the variable once the parameter update is done. This will allow the import to work even if there is a warning or a failure.
Promoted and WAVE Linked Instances If the instanced bodies are promoted, they will be treated as independent bodies. The algorithm to avoid duplicate copies of instanced bodies will skip promoted bodies. Thus, if there are assembly-level operations on the promoted instances, the modified bodies from those operations will get imported correctly. The same is true for WAVE linked instances as well.
Surface Body with Thickness If your NX surface body model has a thickness defined and it does not get transferred to the ANSYS Mechanical application, this could mean that you do not have an NX Scenario (Structural) license. Moreover, only the mid-surfaces created using the offset command can have thickness property and are imported correctly. Mid-surfaces created using face pair or user defined methods cannot have a thickness and cannot be imported. In addition to that, any thickness assigned on the surfaces inside the Advanced Simulation application cannot be imported in ANSYS either.
Unique Parameters Name When you transfer NX expressions/parameters into the ANSYS Mechanical application, make sure that all feature parameter names are unique within a part and all non-feature parameter names are unique within an assembly. The non-feature parameters could be from one or more components of the assembly.
See the NX Errors Related to CAD Integration section in CAD Integration Troubleshooting for detailed information.