Batchoptions and Analysis Configurations in the Registry

Analysis configurations are used to specify machines and options for local, remote, and distributed analysis, including capabilities that are enabled by HPC licenses.

How Analysis Configurations are Stored in the Registry

A configuration contains information beyond the machine or machines to use for a solution. Examples are the number of processors to allocate to the analysis for each machine in the list, memory limits, directory locations for personal libraries and temporary files, and many other preferences.

Note:
  • Options are arranged as keys and values (in a structure similar to the Windows Registry). However, these options are not a part of the Windows Registry, but are separately stored and maintained by the Ansys Electronics Desktop software. For more information concerning the configuration files comprising the options registry, see the following topics:

    Setting Options Via Configuration Files
    Setting the Temporary Directory

  • For access to options and functionality beyond what is directly accessible via the user interface or batch options, refer to the documentation of the UpdateRegistry tool. This tool is discussed in the following help topic and in the topics that follow it in the same branch of the product help:

    Setting or Removing Option Values in Configuration Files: UpdateRegistry Command

General settings are associated with the Desktop application or 3D Editor. "HPCLicenseType" and "tempdirectory" values are at the root level of the registry. Other options are specific to a particular product or design type. For example, certain mesh, boundary, and memory limit settings as well as many other preferences are product-specific and are therefore associated only with the applicable design types. Such options appear with a consistent value name, but in a different registry path for each applicable design type.

Copying a Configuration from One Design Type or Product to Another

To copy a configuration from one design type (or product) to another:

  1. Click Tools > Options > HPC and Analysis Options. The HPC and Analysis Options window appears.
  2. On the Configurations tab of the HPC and Analysis Options window, use the Export… button to export the configuration to a file.
  3. Switch to the destination design type (or product) and use the Import… button to import the configuration data.

    Any data that is not applicable to the destination design type is ignored; any settings present in the destination design type that were not present in the source configuration will be assigned default values. The user may then edit the copy as desired.

Using HPC and Analysis Options for Configurations

Due to the complexity of the registry values for the configurations, directly editing these values using the UpdateRegistry tool is not recommended. Instead, use the HPC and Analysis Options window to edit or create a configuration. (See Setting HPC and Analysis Options.) Configurations created or edited using the interface are stored in the user_machine level of the registry. You can create a configuration for one of the other registry levels the following steps:

  1. Create the configuration using the Analysis Configurations interface, then export the configuration to a file.
  2. Delete the configuration using the interface so that it will not be present in the user_machine level. Then exit the software.
  3. Use the UpdateRegistry command to import the data into the desired registry level using the -FromFile option to specify the file exported via the software, and using the -RegistryLevel option to specify the registry level where the configuration is to be stored. For example, an administrator may use this approach to create a configuration at the install level that may be used by any user on any machine.

Batch Options

There is a large number of both general and product-specific options supported by the software. These options have evolved over time. Therefore, older batchoptions files may no longer be valid, and the options listed in the user interface of the current software may differ from earlier versions you have used. Additionally, there are options beyond those listed within the user interface, which provides a subset of the available options. You can generate a more complete list of options by running the UpdateRegistry command with the -GetKeys switch and piping the output to a text file, as detailed in the following Windows procedure:

  1. In a command window, navigate to the following folder:

    <installation_directory>\v<version>\Win64

  2. Type and enter the following command:

    UpdateRegistry -GetKeys -ProductName ElectronicsDesktop20xx.y > <text_file_path>\Batchoptions.txt

    Substitute the last two digits of the installed product version year and the minor release number for xx.y (such as 24.1). Also, substitute the desired text_file_path (such as %UserProfile%\Desktop).

    The resulting Batchoptions.txt file will contain a nearly complete list of available options.

This procedure also works from the <installation_directory>/v<version>/Linux64 folder on the Linux platform.

When you submit jobs to a remote computer or cluster, you can specify batch options using the job submission interface. When using the software, you select the batch options from a list and therefore avoid typographical errors. For the most commonly used batch options, there is detailed information about the allowed values. Click Submit on the Simulation ribbon tab to access the Submit Job To window. Then, click Add to access the Add Batchoption dialog box pictured below:

Add Batchoption window with registry keys listed

To assist users who need to specify batch options and are unable to use the job submission interface, a new help option has been added. If the Electronics Desktop application is launched with the ‑batchoptionhelp command line argument, a message box is displayed that lists and describes the most common design type-specific batch options:

Message box that details batch options