Testing

This guide describes how to verify your MuscleX installation and use its testing framework to ensure consistent and reproducible results across devices and versions. For most users, it is not necessary to continue beyond the Testing Methodology for Developers section.

Testing a MuscleX Installation

GUI Testing

Launch the MuscleX GUI
Click Run Tests in the launcher window
Click Run Global Tests to run all module tests
For GPU-specific testing, click Run GPU Test
- This verifies if pyopencl is installed and GPU access is available

Command Line Testing

Run the following commands in a terminal:

Run all module tests:
```
musclex test_global
```
Run detailed implementation tests:
```
musclex test_impl
```
Run GPU test only:
```
musclex test_gpu
```
Run environment test:
```
musclex test_env
```

test_env compares your current Python and dependency versions against a reference set saved in musclex/environment_tester.sh. Failing this test does not necessarily mean MuscleX won’t work.

For further help, open an issue on GitHub.