From 30e0d33d6605e56849824e16758e502dd2ad5b29 Mon Sep 17 00:00:00 2001
From: Dmitry Romanov <romanovda@gmail.com>
Date: Mon, 19 Jul 2021 22:50:58 -0400
Subject: [PATCH] Full simulation updates
---
docs/howto/full_simulation.rst | 61 +++++++++++++++++++++++++
docs/howto/full_simulation_tutorial.rst | 20 --------
docs/howto/run_simulation.rst | 6 +++
docs/howto/s3_file_storage.rst | 2 +-
4 files changed, 68 insertions(+), 21 deletions(-)
create mode 100644 docs/howto/full_simulation.rst
delete mode 100644 docs/howto/full_simulation_tutorial.rst
create mode 100644 docs/howto/run_simulation.rst
diff --git a/docs/howto/full_simulation.rst b/docs/howto/full_simulation.rst
new file mode 100644
index 0000000..71a141a
--- /dev/null
+++ b/docs/howto/full_simulation.rst
@@ -0,0 +1,61 @@
+Full simulation
+===============
+
+Tutorials
+---------
+
+Tutorials are available on a dedicated websites:
+
+Detector simulation
+~~~~~~~~~~~~~~~~~~~
+
+- `Full simulation tutorials <https://eic.phy.anl.gov/tutorials/eic_tutorial/getting-started/quickstart>`_
+- `Quick start guide <https://eic.phy.anl.gov/tutorials/eic_tutorial/getting-started/quickstart>`_
+- `Part I. Simple detecotor <https://eic.phy.anl.gov/tutorials/eic_tutorial/part1/simple_detector>`_
+- `Part II. Part 2: Modifying and Adding Detectors <https://eic.phy.anl.gov/tutorials/eic_tutorial/part2/adding_detectors>`_
+
+
+`Perticipate in feedback! <https://docs.google.com/forms/d/e/1FAIpQLSclPBXv13pVtawt35XeaCDMOcmdo8fhKTapdmjFO_6gPTV-8w/viewform?usp=sf_link>`_
+
+Tracking
+~~~~~~~~
+
+- `(in development) ACTS tracking repo <https://eicweb.phy.anl.gov/EIC/documentation/guide_to_tracking>`_
+
+
+
+Particle gun
+------------
+
+
+There are at least 2 ways of running a particle gun out of the box:
+
+- using npsim command line
+- using geant macro file and invoke gps
+
+
+Using npsim (wrapper around ddsim) command line:
+
+.. code:: bash
+
+ # Assumed to run from the root of Athena detector repo
+ # no spread
+ npsim --compactFile=athena.xml --runType=run -G -N=2 --outputFile=test_gun.root --gun.position "0.0 0.0 1.0*cm" --gun.direction "1.0 0.0 1.0" --gun.energy 100*GeV --part.userParticleHandler=''
+
+ # uniform spread inside an angle:
+ npsim --compactFile=athena.xml --random.seed 1 --enableGun --gun.energy 2*GeV --gun.thetaMin 0*deg --gun.thetaMax 90*deg --gun.distribution uniform --outputFile test.root
+
+
+
+Convert to GDML
+---------------
+
+There is a convert_to_gdml.py script in the detector repository
+(https://eicweb.phy.anl.gov/EIC/detectors/athena/-/blob/master/scripts/convert_to_gdml.py).
+That can be used to export ALL of ATHENA to gdml, but not individual detector systems.
+
+This is actually [done](https://eicweb.phy.anl.gov/EIC/detectors/athena/-/blob/master/.gitlab-ci.yml#L168) on every commit
+and the results are saved as job artifacts.
+
+`The latest athena.gdml from the master branch <https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/athena.gdml?job=report&item=default>`_
+
diff --git a/docs/howto/full_simulation_tutorial.rst b/docs/howto/full_simulation_tutorial.rst
deleted file mode 100644
index bdd7a30..0000000
--- a/docs/howto/full_simulation_tutorial.rst
+++ /dev/null
@@ -1,20 +0,0 @@
-Full simulation tutorial
-========================
-
-Tutorials are available on a dedicated websites
-
-Detector simulation
--------------------
-
-- `Full simulation tutorials <https://eic.phy.anl.gov/tutorials/eic_tutorial/getting-started/quickstart>`_
-- `Quick start guide <https://eic.phy.anl.gov/tutorials/eic_tutorial/getting-started/quickstart>`_
-- `Part I. Simple detecotor <https://eic.phy.anl.gov/tutorials/eic_tutorial/part1/simple_detector>`_
-- `Part II. Part 2: Modifying and Adding Detectors <https://eic.phy.anl.gov/tutorials/eic_tutorial/part2/adding_detectors>`_
-
-
-`Perticipate in feedback! <https://docs.google.com/forms/d/e/1FAIpQLSclPBXv13pVtawt35XeaCDMOcmdo8fhKTapdmjFO_6gPTV-8w/viewform?usp=sf_link>`_
-
-Tracking
---------
-
-- `(in development) ACTS tracking repo <https://eicweb.phy.anl.gov/EIC/documentation/guide_to_tracking>`_
diff --git a/docs/howto/run_simulation.rst b/docs/howto/run_simulation.rst
new file mode 100644
index 0000000..eede9ca
--- /dev/null
+++ b/docs/howto/run_simulation.rst
@@ -0,0 +1,6 @@
+Run simulation
+==============
+
+This page provides information and tips about running the simulation, geometry visualization and
+data processing.
+
diff --git a/docs/howto/s3_file_storage.rst b/docs/howto/s3_file_storage.rst
index a2a2957..1f7860e 100644
--- a/docs/howto/s3_file_storage.rst
+++ b/docs/howto/s3_file_storage.rst
@@ -39,7 +39,7 @@ One can utilize XRootD server to get access to files without credentials using:
TFile* file = TFile::Open("root://sci-xrootd.jlab.org//osgpool/eic/ATHENA/" + fileName);
// ...
-
+(!) Currently (July 2021) only RECO is on xrootd (since we only have a 2.5 TB limit there)
Installation
------------
--
GitLab