Skip to content

Commit 9f5007c

Browse files
Regenerate the CAD simulation tutorial from AliceO2
1 parent 9050f8f commit 9f5007c

2 files changed

Lines changed: 28 additions & 0 deletions

File tree

‎docs/cadtutorial/limits.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ rediscover in a result.
1414
| One `geom.C` per hooked thing | The macro exports a single builder hook, and that hook is what the JSON refers to. | Run the converter once per subsystem, into its own folder. They coexist happily in one JSON. |
1515
| Media, cuts and field default to zero | A CAD file carries a material, never a medium, and the emitter uses a three-argument `TGeoMedium` which zeroes every parameter. | Pass `--in-field`. Accept transport defaults for step control, and treat production cuts as unset until you write a real detector. |
1616
| The anchor volume must already exist | Placement is expressed inside the frame of an existing O2 volume. | Use `barrel` unless you have a reason not to, and remember it sits at cave `(0, -30, 0)`. |
17+
| A custom detector list does not extend an official one | `--detectorList NAME:file.json` takes the modules from that file alone, and `-m` can only select from it. | Copy the built-in entries you want into the same list as your CAD module, see [Add passive geometry](passive.md#combine-it-with-the-built-in-detectors). |
1718
| Free-form surfaces stay tessellated | Genuine B-spline *surfaces* are not supported by the exact tier at all. | Check the surface report. Recognition already recovers quadrics written as NURBS, which is the large majority of them. |
1819
| Illegal overlaps in the CAD model | Engineering assemblies are not drawn as legal transport worlds, and parts routinely interpenetrate. | Read `CheckOverlaps`, then fix in CAD or clip the offending region. |
1920
| Degenerate facets at coarse precision | `O2Tessellated` drops triangles that collapse to a line. | Treat it as a mesh-quality signal: lower `--mesh-prec`, or move the part onto an exact tier. |

‎docs/cadtutorial/passive.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,3 +61,30 @@ Setting special cuts for passive module EXCV
6161

6262
Those three lines mean your CAD geometry is in the simulation and particles are being transported
6363
through it. You can list as many modules in the same array as you like.
64+
65+
## Combine it with the built-in detectors
66+
67+
A custom `--detectorList` replaces the official list, it does not extend it. `o2-sim` takes the
68+
module set from the one list you name, and `-m` may only select from that set. To simulate your CAD
69+
module together with, say, the ALICE 3 detectors, put all of them in the same list:
70+
71+
`detectorlist.json`
72+
73+
```json
74+
{ "EXTCAD": ["A3IP", "TRK", "FT3", "TF3", "EOS"] }
75+
```
76+
77+
```bash
78+
o2-sim-serial-run5 -n 1 -g boxgen \
79+
--detectorList EXTCAD:detectorlist.json \
80+
--extGeomFile externalGeometry.json
81+
```
82+
83+
Here `EOS` is the `name` of the module in `externalGeometry.json`. Leave `-m` out, so that every
84+
module in the list is active. If you pass `-m A3IP TRK` together with a list that does not contain
85+
them, you get `Modules specified that are not present in detector list`.
86+
87+
- Copy the entries of the official list you want from `$O2_ROOT/share/config/o2simdefaultdetectorlist.json`.
88+
- Use `o2-sim-serial-run5` (or `o2-sim-run5`) for ALICE 3 modules, and `o2-sim-serial` for Run 3 ones.
89+
- Switch a module off by removing it from the list, or with `--skipModules`.
90+
- The cave is always built, so `barrel` stays a valid anchor.

0 commit comments

Comments
 (0)