批量处理

当您在批处理模式下启动 Tecplot 360 时，需要提供要执行的宏文件名。启动批处理模式的最小命令如下：

该-b标志指示 Tecplot 360 以批处理模式运行，而-p告诉 Tecplot 360 运行其后指定的文件名（本例中为 mymacrofile.mcr）。

将布局文件与批处理结合使用既强大又灵活，也是推荐的操作流程。通过布局文件，您可以在单个文件中使用一个或多个帧来组织绘图。布局文件管理数据集，并可在运行时通过命令行或加载布局文件的宏进行动态修改。

例如，要在批处理模式下执行以下任务序列：

可按如下方式设置批处理脚本：

在Batch Processing Using a Layout File中，我们设置 Tecplot 360 处理用户提供的数据文件（一个或多个）并创建单个输出文件。如果需要对大量输入文件（每次一个）重复上述过程，可以通过循环实现：在 Tecplot 360 外部使用操作系统的 shell 循环结构，或在 Tecplot 360 内部使用 Tecplot 宏语言中的流程控制命令。

Each time Tecplot 360 runs in batch mode, it creates a file defined by the name in theBATCHLOGFILEenvironment variable; if this environment variable is not defined, it uses a file namedbatch.login the directory where Tecplot 360 was launched. If the name given in theBATCHLOGFILEenvironment variable is a relative path, the startup directory of Tecplot 360 is automatically prepended. Real-time records of operations performed in Tecplot 360, along with warnings and error messages, are sent to thebatch.logfile.

Two command-line options of Tecplot 360-o和-convertallow you to more easily convert existing datasets to SZL (Tecplot's high-performance subzone data format, with file extension.szplt). Since it is command-line driven, this feature is suitable for converting large numbers of files without user intervention, or as a step in solver post-processing.

When launched using these two options, Tecplot 360 does not require a license, so you can perform data file conversion on any available workstation without concern. Only Tecplot 360 installation is needed.

In a restricted batch session launched via-o或-convert, Tecplot 360 can read data files (using any of its data loader plugins) and write data in SZL format, but cannot perform most other operations. As with all batch operations, there is no graphical user interface; batch conversion is strictly a command-line function.

In most cases, you will want to use the-ooption for SZL conversion. For more information on scenarios where theWriting SZL Files With Macrosoption is used, please refer to-convert。

Loading Data Files by Name

The -oThe option outputs any loaded data to the specified.szpltoutput file. Simply add-ofollowed by the output file name or path to the command line typically used for loading data. Tecplot 360 will then write the data to SZL format (and exit) instead of displaying graphics in the workspace. For example, if you typically use the following command line to start exploring data in two Tecplot.pltfiles:

You can instead use the following command line to have Tecplot 360 convert these data files into a single.szpltfile:

If your data is in a non-Tecplot format, it may not be possible to load all data into Tecplot 360 at once via a simple command line as described above. Some formats (e.g., CGNS) support loading multiple files but require all files to belong to the same case, with additional cases needing further load operations. Other loaders do not support multiple files at all and require all subsequent loads to be appended after the first load. In such cases, you can record a macro to load the data.

Loading Data Files with Macros

Create a macro to load part or all of the data when one or more of the following conditions are met:

Simply follow the process you typically use with the Tecplot 360 graphical user interface to record a macro for loading data. For more information on recording macros, seeMacro Creation。

The recorded loading process can include multiple load operations with additional options, any number of different file formats, and the selection of advanced loader options. After recording the macro, specify it on the command line when callingtec360. As before, simply add-ofollowed by the SZL file name to be created:

The recorded macro contains fixed file names and directory paths for the loaded files, making it difficult to use the macro for other data files. We will address this later with some simple macro modifications.

Using Multiple Macros to Load Files

Tecplot 360 allows you to specify multiple macros on the command line, which will be executed in the order they appear in the command. Therefore, instead of creating a single macro that loads multiple files, you can record multiple macros, each loading one data file, and then specify only the macros actually needed for a specific project. For example:

Combined with the techniques in the following sections that allow macros to load data files other than those recorded, you can create a macro "toolkit" for converting various types of files you typically handle.

There is one issue with using multiple macros on the command line. When you record a load operation, the resulting macro may contain an instruction telling the loader to erase any loaded data. When you attempt to load data, the second macro file specified will erase the data loaded by the first macro, and so on for the third, fourth macros, wasting time and making it appear that only the last macro loaded data.

Fortunately, this is easy to fix. Simply load the macro into any text editor (Notepad.exewill do), find any line containing:READDATAOPTION = NEWChange it toREADDATAOPTION = APPENDinstead. Such macros will work correctly even if specified first on the command line, because each conversion is a completely new Tecplot 360 session starting with no data loaded.

Mixing Macros and Data Files

A macro is just another data file: Tecplot 360 happens to execute it as instructions. Therefore, you can mix data files and macros on the command line to load data, using macros only for files that cannot be loaded directly by specification. Files are processed in the order they appear on the command line. For example:

This will loadcube.plt(a regular Tecplot data file), then executeloadcircle.mcr, the macro may load another data file (or even multiple files). The loaded data is then written tooutput.szplt.

Using Relative Paths

As mentioned earlier, the file paths you load and save become part of the recorded macro. The macro will always load the input file with the same name and in the same directory as when it was recorded. Similarly, the output file will always be saved with the same name and in the same directory as when the macro was recorded.

If you have set up your simulation workflow so that the solver always generates output files with the same name, but each case is in a different directory, you only need to edit the recorded macro to use relative paths. This way, the macro will work with files in the current directory (regardless of the directory), and you simply need to switch to the directory containing the files to be converted before executing the conversion.

For example, here is a simple macro,loadcube.mcr, which we recorded to load a single.pltfile. (The actual macro might be longer, because loading a.pltfile doesn't even require a macro, but we'll keep it simple here.)

All recorded macros include the definition of the variableMFBD, which points to the current (or working) directory that was active when the macro was recorded. Since we loadedcube.pltfrom the desktop folder (which is also the working directory), the macro uses theMFBDvariable in theREADDATASETcommand. If we load a data file from a directory other than the working directory, theREADDATASETcommand will include the full path (for example, on Windows, it might start withC:\). Below is what the macro looks like whencube.pltis located in `C:\:

. We don't actually need theMFBDvariable, so we can remove theVarSetcommand and the correspondingRemoveVarcommand (though keeping them won't hurt). We will also remove everything except the file name from theREADDATASET and WRITEDATASETcommands. We will also changeREADDATAOPTION到APPEND, as described in the previous section. Below is the modified macro.

This macro now reads thecube.pltfile from the current (or working) directory. Save it asloadcube.mcrAfter that, the conversion can be invoked as follows:

Note that when invoking the conversion, you must specifyconvert.mcrthe full path, as it is not in the working directory. If the Tecplot 360bindirectory is not in the systemPATHvariable, you must also providetec360the full path to the executable. (For simplicity, our example assumestec360is located inPATH.)

Using Environment Variables in Loader Macros

. When the data files to be converted may have different names but the same format and require the same loader options, you can write a macro that accepts paths specified externally. The most straightforward method is to set environment variables before starting Tecplot 360. The macro file then uses these environment variables as input file paths. Here, we will use the variableINFILEalong with the macro from the previous section. Since it no longer only loadscube.plt, we will name the macroloaddata.mcrinstead ofloadcube.mcr.

. To invoke it, set the environment variables before starting the conversion:

Windows:

Linux or Mac (bash shell):

Absolute or relative paths can be used in environment variables; relative paths are always relative to the current or working directory.

If the file loading process requires specifying multiple input files for the macro, simply add oneINFILEvariable for each file, appending numbers, e.g.,INFILE1, INFILE2, etc., and modify the macro accordingly. If using multiple macros, use different variables in each macro to avoid conflicts.

A Batch File for Conversion

The command-line instructions from the previous section can be placed in a batch file (Windows) or shell script (Linux or Mac) to specify all necessary paths in a single command line. This file (convert.bat or convert.sh) can be placed in the same directory asloaddata.mcrfrom the previous section, as long as that directory is in the systemPATH.

Windows — convert.bat:

Now you can invoke it as follows:

Linux or Mac OS — convert.sh:

Createconvert.shAfter creation, execute the following command to make it executable:

Then the script can be invoked as follows:

The same technique can be applied to other macro files and filenames; you simply need to set the environment variables required by each macro based on the script parameters.%1, %2etc., used in Windows batch files$1, $2etc., used in Linux or Macbashscripts).

Writing SZL Files With Macros

The main difference between the two is:-o and -convertWhen you use-o, Tecplot 360 writes the SZL data for you; whereas when using-convert, you need to write the data file through a macro. All the macro usage methods we learned earlier still apply, and the following are valid application scenarios:

You can create a macro that writes to.szpltfile by recording the save operation, but the necessary commands are provided here for reference:

You can adjust this macro to use relative paths or environment variables, just as we did when creating macros for loading data. Here is the macro rewritten using environment variables:OUTFILE:

The scenarios for using -convert instead of -o are relatively limited. One possible use is to write multiple copies of the .szplt file.szpltfile, for example to create backups (although usingCOPY or cpshell command might be better).

Another use case might be to automatically name files based on certain attributes of the loaded data,szpltwithout needing to manually specify the name. Note that when using the-convertprovided restricted macro environment, you can check andAUXDATASET, AUXFRAME或AUXZONEuse built-in variables (or combinations thereof) to name files, for example:

VariableDATASETFNAMEcontains the full path of the loaded data file, which can be used to make the output file have the same base name as the input file. Since this variable may contain multiple paths when loading multiple files, we recommend always using an index to specify the desired path; otherwise, allallpaths of the loaded files will be substituted into the command, causing the save to fail.

You can use|DATASETFNAME[2]|, |DATASETFNAME[3]|etc. to reference the path of a specific file, indexed by load order.

For a complete list of available macro variables, please refer to the Scripting Guide for more information.