{ "contributor-id" "360c0aed-48ce-45f6-ba13-337f12a531e8" "description" "This verification check examines whether a model called in parallel by multiple threads gives the same results as when called sequentially. A number `num_configs` (preset in the code) of configurations is generated, each containing a different number of atoms based on a randomly distorted, periodic, face-centered cubic (fcc) structure containing a random distribution of all atoms supported by the model. Configurations used for testing are provided as auxiliary files. The energy and forces for each configuration are computed in sequence. Then the calculations are repeated using Python multithreading with `num_configs` threads and the Global Interpreter Lock (GIL) released to ensure true parallelism. Each thread possesses its own copy of memory related to the calculation. The threaded calculations are repeated `num_cycles` times (preset in the code) with the configurations randomly distributed to the threads to create many varying opportunities for collisions. To pass the test, the total energy and the forces on all atoms for a given configuration obtained in all cycles must be be identical to those obtained in the sequential calculation. Failure of this verification check implies that the model is inappropriately storing information in persistent (static) memory during or between calls. Passing this verification check provides some assurance the the model is thread-safe, but it is NOT a guarantee due to the inherent randomness of race conditions in unsafe code. To be certain, the model code would need to be studied and analyzed carefully.\n\n\nHISTORY:\n\nChanges in version 005:\n* Update for compatibility with kimpy 2.0.0\n\nChanges in version 004:\n* Update syntax for latest ASE calculator to release GIL\n* Use context manager for ASE calculator in single-threaded stage to ensure model destroy is called (in case the model has global variables managed by its create/destroy functions that could impact thread safety)\n* Minor reformatting" "developer" [ "360c0aed-48ce-45f6-ba13-337f12a531e8" "4d62befd-21c4-42b8-a472-86132e6591f3" ] "doi" "10.25950/cdeef2b5" "domain" "openkim.org" "executables" [ "runner" ] "extended-id" "ThreadSafety__VC_881176209980_005" "kim-api-version" "2.0" "maintainer-id" "360c0aed-48ce-45f6-ba13-337f12a531e8" "matching-models" [ "standard-models" ] "properties" [ "tag:tadmor@noreply.openkim.org,2017-02-01:property/verification-check" ] "publication-year" "2021" "simulator-name" "ase" "title" "Verification check of thread safety v005" }