Skip to main content

Home screen

The Input Preprocessor is used to establish files defining the input domain. Input Preprocessor is here for You to build and manage input distributions for all types of projects supported by Uptimai software. You can choose the type of input distribution best fitting to Your project, set boundary conditions to them, and also visualize and check resulting distribution shapes. It is highly recommended to examine all inputs and their compatibility with the Uptimai software, especially when these are prepared in an external application or script. It prevents possible computation fails or misinterpretation of results.

How to use it#

On Figure 1, it can be seen the initial state of the application's window which is split into two main sections. Here can the user either create a new set of input files or work with already existing ones.

The About button on the bottom right shows the menu dedicated to accessing the link to this document (Help), contacting Uptimai company to get the support (Company), and showing the information about the currently installed version of the program (Version).

Figure 1: Input Preprocessor - Main window

New input#

Under the New input section o the software you can start to prepare input files needed for the work with other programs from the Uptimai family. First, the method intended to be used further has to be chosen from options found under Select method. Currently, it is possible prepare inputs for four methods of the Uptimai Solver:

  • Uncertainty Quantification : Building the mathematical model describing how changes in input variables propagate and affect the observed outputs. The data is obtained from the third-party computational software coupled with the Uptimai Solver. The model can be analysed in the Postprocessor tool to obtain visual description of results.
  • Preliminary Analysis : Analysis showing the sensitivity of the variance of results to input variables. Simplified process which does not require to build the full surrogate model, significantly reduced number of samples is required.
  • Data Analyzer : Building the mathematical model from already existing data, e.g. results of performed experiments. The postprocessing of the model offers the same features as in the case of Uncertainty Quantification method.
  • Design of Experiments : Preparing design space sampling according to classic DoE methods such as Latin Hypercube Sampling. Also, suitable for complementing of an existing DoE scheme with new samples.

The Create input button brings the user to the Input preparation screen which corresponds to the selected method. The software suggests a generic name for the set of input files in the Input name field. For each input, there are three files defining the domain of the project and the sampling:

  • Variable file : <prefix>_InputSet.txt describes the definition of probability distribution types and their parameters for each input variable
  • Domain file : <prefix>_InputDomain.txt contains the settings of probability distribution boundaries and the position of the nominal sample
  • Data file : <prefix>_XDis.txt holds the Monte Carlo sampling of the domain used for the model propagation and visualizations
  • DoE file : <prefix>_Design.txt describes settings of the Design of Experiment sampling

The name prefix can be changed by the user, but it is not allowed to proceed with already existing names. Also, the software generates automatically names of files related to the particular set of inputs. These files are saved into the inputs folder inside the current project. Also, the information about the created input and its corresponding files is written into the <project>.uptim file of the current project. This file with metainformation should not been edited by users.

Existing input#

When there are any already existing sets of input files, these can be accessed via the Open existing input button. This will open the Open Existing Input dialog, as shown on Figure 2. In case there are inputs recognized for the current project (need to be listed in the <project>.uptim file and found in their destinations), you can select them by clicking from the list appearing on the left under the Inputs found in project sign.

For each selected input the list of corresponding files will be displayed on the right together with the input name and the method of the Uptimai Solver. Then, the Continue button will bring the user to the input preparation screen which corresponds to the selected method. The Cancel button closes the dialog and shows the initial screen of the Input Preprocessor.

Figure 2: Input Preprocessor - Open Existing Input, select from list of recognized inputs

If no input was found in the project, either because it was not listed in the <project>.uptim file or the user wants to use an input from another project, it is possible to select input files manually using the Select files manually button. After selecting the Variable file containing the definition of input variables' distributions and also selected Method, the program will allow to select the Domain file and the Data file with the Monte Carlo sampling. The Input name can be edited, meaning it is possible to share same files for multiple inputs - e.g. Variable file, Domain file, and Data file for the Uncertainty Quantification method can be used for the Data Analyzer method, which has than two additional files describing existing samples together with their results.

Figure 3: Input Preprocessor - Open Existing Input, select input files manually