GEMC Options Reference

This page is generated from gemc -h. Click each item for help.

Switches

Name	Description
`gui`	run with the graphical user interface (Qt window)
`i`	drop into the interactive Geant4 terminal session (non-GUI mode)
`printSystemsMaterials`	print the materials used in this simulation
`print_summary`	print a timing summary at the end of the simulation (total wall-clock time, total time since beamOn, and the average event rate). On by default; disable with -print_summary=false.
`recordZeroEdep`	Record particle even if they do not deposit energy in the sensitive volumes
`save_all_ancestors`	save initial information for hit-producing tracks and all their ancestors
`save_original_track`	save the original Geant4 track ID in each true-information hit
`showPhysics`	Log Geant4 Physics Available Modules that can be used with the “phys_list” option and exit
`showPredefinedMaterials`	log GEMC Predefined Materials
`useDawn`	Take a dawn screenshot

Options

Name	Shape	Description
`nthreads`	`<value>`	sets number of threads.
`randomEngine`	`<value>`	randomEngine
`seed`	`<value>`	seed
`plugin_path`	`<value>`	colon-separated list of directories to search for .gplugin files
`gsystem`	`<sequence>`	defines the group of volumes in a system
`gmodifier`	`<sequence>`	modify volume existence or placement
`root`	`<value>`	root volume definition
`sql`	`<value>`	sql host or sqlite file
`ascii_db`	`<value>`	ascii factory search path
`experiment`	`<value>`	experiment selection
`runno`	`<value>`	geometry/conditions run number
`useBackupMaterial`	`<value>`	Backup material
`check_overlaps`	`<value>`	check overlaps
`applyThresholds`	`<value>`	systems that reject hits below threshold
`gmultipoles`	`<sequence>`	define the e.m. gmultipoles
`gfields`	`<sequence>`	define a generic plugin-backed e.m. field
`global_field`	`<value>`	associate a field with the ROOT world volume
`no_field`	`<value>`	reset the field of one or more volumes
`max_field_step`	`<value>`	maximum accepted field step
`fieldAt`	`<value>`	query all configured fields at x y z
`fieldMapPoints`	`<value>`	ASCII file of x y z points for field queries
`ebuffer`	`<value>`	number of events kept in memory before flushing them to the filestream
`gstreamer`	`<sequence>`	define a gstreamer output
`splash_time`	`<value>`	splash display time in seconds
`splash_scale`	`<value>`	splash image scale factor
`phys_list`	`<value>`	Select Physics List
`log_every`	`<value>`	log module: print event progress and average rate every N events per thread
`gparticle`	`<sequence>`	define the generator particle(s)
`gparticlefile`	`<sequence>`	define generator particles from file(s)
`n`	`<value>`	number of events to process
`run`	`<value>`	event run number
`run_weights`	`<value>`	File with run number and weights
`g4view`	`<sequence>`	Defines the geant4 viewer properties
`g4camera`	`<sequence>`	Defines the geant4 camera view point
`g4light`	`<sequence>`	Defines the geant4 light source direction
`dawn`	`<sequence>`	Defines the dawn view point
`g4decoration`	`<sequence>`	Adds optional Geant4 scene decorations
`show_field_lines`	`<value>`	number of field-line points to display
`g4text`	`<sequence>`	Insert texts in the current scene
`conf_yaml`	`<value>`	infix for the YAML file that records the resolved options
`tt`	`<value>`	GUI test timeout (ms)
`verbosity`	`<sequence>`	Sets the log verbosity for various classes
`debug`	`<sequence>`	Sets the debug level for various classes