Applications validation

The validation of MonolixSuite applications can be performed using an executable included in the suite.

Validation of the graphical interface

To validate the graphical interface, follow the steps described here. This simple procedure ensures that the installation is correct, the interface functions properly, and the link between the interface and the calculation engine is established.

Validation of Monolix

Steps:

1. Navigate to the installation folder of MonolixSuite (default locations):

   • Windows: C:/Program Files/Lixoft/MonolixSuite2024R1

   • Mac: /Applications/MonolixSuite2024R1.app/Contents/Resources/monolixSuite

   • Linux: /home/<your username>/Lixoft/MonolixSuite2024R1

2. Execute the following command:

   • Windows:
     .\lib\validationSuite.exe --no-gui -s monolix -i .\resources\validationSuite\monolix

   • Linux & Mac:
     ./lib/validationSuite --no-gui -s monolix -i ./resources/validationSuite/monolix

This runs 16 test projects covering all Monolix features. The validation matrix can be found here: validationMatrix_2014.pdf.

Results:

• Results are stored in userDirectory\lixoft\monolix\monolix2024R1\tmp for the user who initiated the validation.

• You can specify a different output directory using the -o flag.

• A summary report (validation_suite_summary.txt) is generated. It should contain only "OK" statuses.

• Execution time: approximately 40 minutes on a standard 4-core laptop.

Linux-Specific Notes:

The validation suite depends on the glibc version of the system. Use the following command, replacing <version> with 2.27, 2.28, or 2.29 as required:

[Linux] ./lib/validationSuite --no-gui -s monolix -i ./resources/validationSuite/linux64_glibc-<version>/monolix

Using Absolute Paths:

On Windows, when MonolixSuite is installed in Program Files, use double quotes for paths:

"C:\Program Files\Lixoft\MonolixSuite2024R1\lib\validationSuite.exe" --no-gui -s monolix -i "C:\Program Files\Lixoft\MonolixSuite2024R1\resources\validationSuite\monolix"

Validation of PKanalix

The validation procedure for PKanalix is the same as for Monolix.

Steps:

1. Navigate to the installation folder (same as Monolix).

2. Execute the following command:

   • Windows:
     .\lib\validationSuite.exe --no-gui -s pkanalix -i .\resources\validationSuite\pkanalix

   • Linux & Mac:
     ./lib/validationSuite --no-gui -s pkanalix -i ./resources/validationSuite/pkanalix

This runs 33 test projects covering all PKanalix features.

Results:

• Results are stored in userDirectory\lixoft\pkanalix\pkanalix2024R1\tmp.

• The summary report (validation_suite_summary.txt) should contain only "OK" statuses.

• Execution time: a few minutes on a standard 4-core laptop.

Linux-Specific Notes:

Use the appropriate glibc version:

[Linux] ./lib/validationSuite --no-gui -s pkanalix -i ./resources/validationSuite/linux64_glibc-<version>/pkanalix

Validation of Simulx

The validation procedure for Simulx follows the same steps as Monolix and PKanalix.

Steps:

1. Navigate to the installation folder:

   • Windows: C:/Program Files/Lixoft/MonolixSuite2024R1

   • Mac: /Applications/MonolixSuite2024R1.app/Contents/Resources/monolixSuite

   • Linux: /home/<your username>/Lixoft/MonolixSuite2024R1

2. Execute the following command:

   • Windows:
     .\lib\validationSuite.exe --no-gui -s simulx -i .\resources\validationSuite\simulx

   • Linux & Mac:
     ./lib/validationSuite --no-gui -s simulx -i ./resources/validationSuite/simulx

This runs approximately 60 test projects covering all Simulx features.

Results:

• Results are stored in userDirectory\lixoft\simulx\simulx2024R1\tmp.

• The summary report (validation_suite_summary.txt) should contain only "OK" statuses.

• Execution time: less than 10 minutes on a standard 4-core laptop.

Linux-Specific Notes:

Use the appropriate glibc version:

[Linux] ./lib/validationSuite --no-gui -s simulx -i ./resources/validationSuite/linux64_glibc-<version>/simulx

Validation on Mac devices with Apple Silicon

For Mac devices with Apple Silicon, the procedure remains the same, but reference files must be downloaded separately (link). Use the provided link to download references and specify the extracted directory using the -i flag instead of the default path.

Validation of older versions

The validation procedure applies to older versions of MonolixSuite as well:

• Monolix: Available since 2018R1.

• PKanalix: Available since 2019R1.

• Simulx: Available since 2020R1.