WCSim is a very flexible GEANT4 based program for developing and simulating large water Cherenkov detectors.
As of August 2014 WCSim has been moved to GitHub. It can be found at:
Tutorials and information about the branches and WCSim development model can be found on the wiki:
https://github.com/WCSim/WCSim/wiki
WCSim has very few external dependencies. It relies on only ROOT and Geant4.
There is a mailing list which will send you GitHub push/checkin notifications here:
https://lists.phy.duke.edu/mailman/listinfo/wcsim-git
You can follow issues/requests etc by watching the GitHub respository.
https://wcsim.github.io/Validation/
Build Instructions:
You should have a recent and working version of ROOT and GEANT4. (Known to work with GEANT 4.10.1p03 and ROOT v5.28.00) You also need all of the G4 data files including hadron xsecs etc. Those are the only requirements. The code should work with gcc 4.4.7. For v1.6.0 and earlier, use GEANT 4.9.4.p01.
To compile:
If you want to use these libraries with an external program then also do:
More detailed information about the simulation is available in doc/DetectorDocumentation.pdf.
Build Instructions using CMake:
CMake is cross-platform software for managing the build process in a compiler-independent way (cmake.org). It is recommended to build ROOT and GEANT4 also through CMake. The latter is very CMake friendly since GEANT 4.9.6, while it started introducing builds through CMake from 4.9.4 onwards (http://geant4.web.cern.ch/geant4/support/ReleaseNotes4.9.4.html#10.). Using cmake, builds and source code need to well separated and make it easier to build many versions of the same software.
A recommended way to set up the directory structure in your own preferred WCSIM_HOME:
To compile you need to have CMakeLists.txt in the WCSim source dir.
To recompile:
Useful cmake commands:
Using WCSim without building using Docker:
Docker allows you to use WCSim without compiling in an OS independant way. The Docker images are hosted on DockerHub and can be used by following the steps below.
1) Install Doocker cross platform instructions can be found at https://www.docker.com/ 2) Pull the WCSim image from docker hub by using "docker pull wcsim/wcsim:tag" where tag is the tagged version or use the tag "latest" to get the current develop branch 3) Run the docker image and create a container "docker run --name=WCSim -i -t wcsim/wcsim:tag" this will give you a shell in the container's OS with WCSim already built. To save data from inside your docker image mount a local folder in the docker image at runtime and then anything placed in that directory will be available in that folder after exit. To do that run the following "docker run -v local_folder_path:docker_mount_path -i -t wcsim/wcsim:tag" 4) Once you have run the docker image navigate to "cd /root/HyperK/WCSim" and source the enviroment variables using "source /root/HyperK/env-WCSim.sh" and then run WCSim as normal form this directory 5) To exit the docker image "exit"
(Note: You only need to use the "docker run" command once to create the container. Once created you changes are saved in that container instance and you can start and stop the contianer at any time with "docker start WCSim" and "docker stop WCSim");
Extra docker commands: 1) See all images "docker images" 2) Delete an image "docker rmi imageID" 3) See all containers "docker ps -a" 4) Delete a container "docker rm ContainerID"
WCSim development is supported by the United States National Science Foundation.