Warning, /epic/scripts/material_map/readme.md is written in an unsupported language. File is not indexed.
0001 # Material Map for ACTS
0002 The material map needs to be updated from the default version in calibration/ when __ANY__ geometry or material thickness is changed within the tracking volume, even the change happens on a non-sensitive structure.
0003
0004 ## Generate a new map with auto script
0005 Steps:
0006 * geantino scan to record material from dd4hep simulation
0007 * map materials on to selected sets of ACTS surfaces and boundaries. Default: use all entrance and exit surfaces of tracking layers with grid size set in xml file ("layer_material"...)
0008 * result validation and plots.
0009
0010 pre-requiests:
0011 1. more than 10 GB disk space, and two hours of time.
0012 2. set up your ```$DETECTOR_PATH``` and install epic.
0013
0014 to run:
0015 ```./run_material_map_validation.sh --nevents 1000 --nparticles 5000 ```
0016 See comments for details.
0017
0018 This takes about two hours, and >10GB disk space.
0019
0020 ## Use a local material map with EICrecon
0021 ```eicrecon -Pacts:MaterialMap=/your_path/material-maps.cbor```
0022
0023 ## Update the official material map
0024 1. You can either generate the map locally as described above, or download the artifact ```material_map``` from a PR CI.
0025 2. Check the generated comparison plots for any outstanding issues. Then upload the cbor file and relevant plots to [gitlab](https://eicweb.phy.anl.gov/EIC/detectors/athena/-/issues/153).
0026 3. Copy the url of your uploaded cbor file, and update the [path](https://github.com/eic/epic/blob/540a9e1e255e276548993449be09bd275cb3ef05/compact/tracking/definitions_craterlake.xml#L203) at the bottom epic/compact/tracking/definitions_craterlake.xml with a PR.
0027
0028
0029
0030 References:
0031 * [ACTS how_to](https://acts.readthedocs.io/en/latest/examples/howto/material_mapping.html)
0032 * [Presentation at Tracking meeting](https://indico.bnl.gov/event/22490/contributions/87822/attachments/52848/90391/Auto%20Script%20for%20ACTS%20Material%20Map%20V30.pdf)
