HistoRoot has been separated from G4beamline, and is a separate application available here.
The advantage is that HistoRoot is now compiled, and runs ~100 times faster on large files.
The G4beamline validation document is now available here
.
G4beamline 2.10 is now available here.
The G4beamline User's Guide is available here.
G4beamline now supports the making of movies
Here is a Flash movie of Example1:
Movie. This example is just a gaussian beam expanding in free space (the 4 virtualdetectors are not visible). Muons are blue and a handful of decay electrons and neutrinos are red and gray. This 10 second movie took 12 seconds of CPU time to produce.
The G4beamline Tutorial given at LEMC 2008 was videotaped by Fermilab Visual Media Services. part 1 part 2
Click here for a Flash video giving a screencast of using G4beamline for a simple example.
General
G4beamline is a single-particle tracking program based on the
Geant4 simulation toolkit. It is specifically designed for the simulation of beamlines.
The key aspect of g4beamline is that the input file defining the simulation is not significantly more complicated than the problem being simulated (by contrast, any C++ simulation program will inherently be significantly more complicated than the problem) — G4beamline isolates the user from programming complexities. To make this possible, g4beamline does not give the user all of the power and flexibility of the underlying Geant4 toolkit; it does, however, provide enough flexibility to simulate many different systems that can be considered "beamlines" one way or another. For instance, there is a "cosmic-ray beam", and the notion of "beamline" is rather flexible. In use, one normally just lays out the beamline elements along the beam centerline, using "centerline coordinates" that rotate appropriately whenever needed (e.g. when a bending magnet is placed, or at a target to take a secondary beam off at an angle).
Note that no programming at all is required to simulate systems that use beamline elements already in g4beamline's repertoire. This includes bending magnets, quadrupoles, solenoids, materials of all types in the shape of boxes, cylinders, tubes, spheres, and polycones, pillbox RF cavities, and a few specialized elements for muon cooling. The distribution includes an executable program that runs on Windows Xp, Mac OS X (Intel), or on most modern versions of Linux (it has been tested to run on all RedHat-drived distributions since 7.1, including Fedora Core 1-8). Moreover, the visualization capabilities of Geant4 are available with no further effort, including visualization using OpenInventor, OpenGL, HepRep, DAWN, VRML, and other viewers (as long as your system supports X-windows with the GLX extension). The internal design of the program makes it relatively simple to add new commands and beamline elements to its repertoire (this does, however, require C++ programming).
A major limitation of g4beamline is that at present it does not simulate the performance of real-world detectors. It implements "virtual" detectors which sample the tracks that intersect them with the precision of a float, and measure all tracking variables (X,Y,Z,Px,Py,Pz,t,PDGid). Each virtualdetector generates an NTuple in the output file, which can be histogrammed with the appropriate program. NTuples can be written to Root or ASCII files, and the
historoot program is included to make it easy o generate plots using Root. So g4beamline will tell you where the particles go, but won't give details of real-world detector outputs.
Another limitation of g4beamline is that at present it does not implement parameterized placements of volumes. These are required for a practical implementation of the many segments of modern detectors.
Please join and use our
G4beamline forum. You can self-register using the LOGIN module at the left (valid email required), and immediately start posting to the forum.
Getting Started
G4beamline is distributed as a tarball for Linux/Intel, as standard installers for Windows and for Mac OS/Intel, all available
here. More details are contained in the
G4beamline User's Guide, and in the README-*.txt files in the distributions.
Linux (Intel)
If you intend to install and run G4beamline on your Linux desktop, and it is already running either KDE or Gnome (or a similar X Windows desktop), and the OpenGL and Motif extensions are already installed on your system, then this Quick Start Guide is for you. If you are doing something more complicated (e.g. you have a Windows desktop and use Exceed to connect to a Linux server), then this may help, but you'll probably need to read README-Linux.txt. These instructions assume you are using the bash shell; for other shells modify them accordingly.
The setup script will assist you in adding the G4beamline programs into a directory in your PATH. It will also create icons on your desktop to run G4beamline and Historoot.
This takes 5-10 minutes to run more than 70 tests. the output should end with "All Tests Passed".
- Now move to the examples directory and look at the examples; try the following:
cd $HOME/g4beamline-VERSION/examples
# first visualize the system
g4bl example1.in viewer=best
# (play with the viewer, then ^C)
# then generate NTuples for histogramming
g4bl example1.in
# and histogram the NTuples
historoot g4beamline.root
# (play with HistoRoot, then exit)
... similarly for the other examples ...
Windows XP and Vista
This release for Windows XP and Vista includes a standard Windows installer which puts shortcuts onto your desktop and into the start menu, and puts G4beamlineExamples into you Documents folder. It can also be used with the Cygwin command-line.
After installation you can do the things suggested above under Linux.
Macintosh OS X (Intel)
This release for Mac OS X supports only the recent Intel Processors. Simply download the most recent version and double-click the downloaded installer (a .dmg file). Drag the G4beamline and Historoot applications into your /Applications folder. You can then drag them from /Applications into the Dock.
After installation you can do the things suggested above under Linux.
Documentation
Here is a recent
G4beamline User's Guide. It is updated for each release and included in the execution tarball.
Here is a recent
G4beamline Validation document. It is updated for each release and included in the execution tarball.
New Feature Requests
G4beamline is developed in a
user-driven methodology that encourages rapid release cycles and user contributions. To request a new feature, simply join the G4beamline forum and post a message describing your request in as much detail as possible.
Download
The installer or tarball contains everything required to run the program, except for the prerequisites listed below, and some physics data needed for low energy physics processes (e.g. thermal neutrons — see the Geant4 website).
Please join and use our
G4beamline forum. You can self-register using the LOGIN module at the left (valid email required), and immediately start posting to the forum.
G4beamline release 2.10 is now available (03-JAN-2012).
This release uses Geant4 9.4 patch 03.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 or later), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- G4beamline does not build from source on 64-bit Linux or 64-bit Mac OS X (Lion). The distributions for both are 32-bit, and they do run on 64-bit systems. Whether it can be built on 64-bit Windows is unknown, but it is suspected to fail.
- G4beamline does not tolerate spaces in its install directory on Linux, Mac OS X, or Cygwin; it does tolerate them when installed into Windows (no Cygwin). There is a workaround for Cygwin (ask Tom Roberts).
- g4blmake does not work on Windows.
Major Changes from 2.08
- Materials can filter tracks
- lilens command
- rfdevice command
- reweightprocess command
- Remove MICEPhysicsList and LISAPhysicsList
- ntuple command now has union argument
- --disable-MPI now the default on all OSs
- Using geant4.9.4.p03
NOTE:
HistoRoot is still included in the G4beamline distributions, but this is the
macro version. The compiled version runs ~100 time faster on large files, and is available
here.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.10-Linux-g++.tgz
3. tar -xzf g4beamline-2.10-Linux-g++.tgz
4. rm g4beamline-2.10-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.10-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs built on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.5, 10.6, 10.7 (Intel — Leopard, Snow Leopard, and Lion)
1. download G4beamline-2.10-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into your HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
This (binary) release does not run on Tiger (OS X 10.4), or on any PowerPC system. You can, however, download the source and build it on Tiger; that ought to work on a PowerPC, but has not been tested.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz).
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.10.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, G4beamline itself works, but Historoot does not, even if Root itself works.
Source
The source release is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition. See README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update. See README-MacOSX.txt and BUILD.txt for details.
Linux: install the complete software development suite, including X-Windows, OpenGL, and OpenMotif/Lesstif development. See README-Linux.txt and BUILD.txt for details.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.10-source.tgz
3. tar -xzf g4beamline-2.10-source.tgz
4. rm g4beamline-2.10-source.tgz #(optional clean-up)
5. cd g4beamline-2.10
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.5.8, Leopard
- Red Hat Linux 7.3 (--old-versions)
- Scientific Linux Fermi 5.3
- Windows Xp
G4beamline release 2.08 is now available (13-FEB-2011).
[+]
This release uses Geant4 9.4.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 or later), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- The neutrinos from muon decay do not have the correct distributions; the electrons are correct. This is a Geant4 issue and has been there from the beginning.
- G4beamline does not tolerate spaces in its install directory on Linux, Mac OS X, or Cygwin; it does tolerate them when installed into Windows (no Cygwin). There is a workaround for Cygwin (ask Tom Roberts).
- The probefield command does not work, and truncates its input file to 0 length.
- Tuning of pillbox can be "fuzzy", and give different results for different runs or different computers; differences are usually minor. Fixed in 2.09.
- Historoot does not work on Windows 7. G4beamline and Open Inventor do work on Windows 7.
- g4blmake does not work on Windows.
- The LisaPhysicsList does not work.
Major Changes from 2.06
- Spacecharge and spacechargelw, including FFTW library
- gamma -> mu+ mu- can be added to any physics list
- Improved BLAlarm, added BLSignal; signals close output files gracefully
- --debug added to configure to build a debug version
- Eventcuts now has a skip file to skip particular events
- Transparency in visualization now supported
- OpenInventor now starts with “Visible daughters and visible mothers”
- fieldlines command visualizes E and B field lines
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.08-Linux-g++.tgz
3. tar -xzf g4beamline-2.08-Linux-g++.tgz
4. rm g4beamline-2.08-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.08-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs built on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.5 and 10.6 (Intel — Leopard and Snow Leopard)
1. download G4beamline-2.08-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into your HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
This (binary) release does not run on Tiger (OS X 10.4), on Lion (OS X 10.7.X), or on any PowerPC system. You can, however, download the source and build it on Tiger or Lion; that ought to work on a PowerPC, but has not been tested. The problem with Lion is that Lion does not include MPI; the next release of G4beamline will not have MPI enabled by default, so it will work on Lion.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz).
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.08.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, G4beamline itself works, but Historoot does not, even if Root itself works.
Source
The source release is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition. See README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update. See README-MacOSX.txt and BUILD.txt for details.
Linux: install the complete software development suite, including X-Windows, OpenGL, and OpenMotif/Lesstif development. See README-Linux.txt and BUILD.txt for details.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.08-source.tgz
3. tar -xzf g4beamline-2.08-source.tgz
4. rm g4beamline-2.08-source.tgz #(optional clean-up)
5. cd g4beamline-2.08
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.5.8, Leopard
- Red Hat Linux 7.3 (--old-versions)
- Scientific Linux Fermi 5.3
G4beamline release 2.06 is now available (22-SEPT-2010).
[+]
This release uses Geant4 9.3 patch 01.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.24), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- Historoot does not work on Windows 7. G4beamline and Open Inventor do work on Windows 7.
- OI viewer issues a few error messages, but display is OK.
- g4blmake does not work on Windows.
- The LisaPhysicsList does not work.
- The extrusion command has a bug that applies if the polygon has a side at y=0 and you rotate around x when placing it; a one micron offset avoids the bug. Fixed in Geant4 9.4 (next G4beamline release).
Major Changes from 2.03
- Extended formats provide more information about tracks (virtualdetector, zntuple, timentuple, newparticlentuple, beamlossntuple).
- g4blgui no longer deletes *.root when Run is pushed.
- Historoot variables now work properly wth multiple NTuples.
- Synchrotron radiation can now be added to any physics list.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.06-Linux-g++.tgz
3. tar -xzf g4beamline-2.06-Linux-g++.tgz
4. rm g4beamline-2.06-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.06-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 3.0.9, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs built on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.5 and 10.6 (Intel — Leopard and Snow Leopard)
1. download G4beamline-2.06-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into you HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
This (binary) release does not run on Tiger (OS X 10.4), or on any PowerPC system. You can, however, download the source and build it on Tiger; that ought to work on a PowerPC, but has not been tested.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz).
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.06.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, G4beamline itself works, but Historoot does not, even if Root itself works.
Source
The source release is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition. See README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update. See README-MacOSX.txt and BUILD.txt for details.
Linux: install the complete software development suite, including X-Windows, OpenGL, and OpenMotif/Lesstif development. See README-Linux.txt and BUILD.txt for details.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.06-source.tgz
3. tar -xzf g4beamline-2.06-source.tgz
4. rm g4beamline-2.06-source.tgz #(optional clean-up)
5. cd g4beamline-2.06
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.5.8, Leopard
- Red Hat Linux 7.3 (--old-versions)
- Scientific Linux Fermi 5.3
G4beamline release 2.03 is now available (26-JULY-2010).
[+]
This release uses Geant4 9.3 patch 01.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.24), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- Historoot does not work on Windows 7. G4beamline and Open Inventor do work on Windows 7.
- The User's Guide was not updated from release 2.02. The help in both "g4bl" and "g4blgui" is up-to-date, so to get up-to-date help on any command, you can run "g4bgui", or you can run "g4bl -" and type "help commandname" to its cmd: prompt (omit the quotes). Since 2.02 the following commands have been changed:
| ntuple | added arguments 'perTrack' and 'veto'.
|
| output | new command to redirect stdout and stderr.
|
| fieldntuple | new command to generate an NTuple from B- and E-field values.
|
| reference | new arguments 'noEfield' and 'noEloss' to permit ICOOL-style references. Works for one reference particle, but there is a serious bug if more than 1 reference command is used (fixed in 2.04b).
|
- OI viewer issues a few error messages, but display is OK.
- g4blmake does not work on Windows.
- The LisaPhysicsList does not work.
Major Changes from 2.02
- New command "fieldntuple"; makes it easy to plot E and B fields using HistoRoot or other plotting tools; more flexible than "printfield".
- Added veto argument to the ntuple command.
- New command "output" will redirect stdout and stderr from within the input file. Most useful to name the output from internal parameter values.
- The reference command can now track ICOOL-style reference particles (immune to Eloss and E fields).
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.03-Linux-g++.tgz
3. tar -xzf g4beamline-2.03-Linux-g++.tgz
4. rm g4beamline-2.03-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.03-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 3.0.9, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs built on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.5 and 10.6 (Intel — Leopard and Snow Leopard)
1. download G4beamline-2.03-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into you HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
This (binary) release does not run on Tiger (OS X 10.4), or on any PowerPC system. You can, however, download the source and build it on Tiger; that ought to work on a PowerPC, but has not been tested.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz).
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.03.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, it might work, or you might need to install the source and build it.
Source
The source release is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition. See README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update. See README-MacOSX.txt and BUILD.txt for details.
Linux: install the complete software development suite, including X-Windows, OpenGL, and OpenMotif/Lesstif development. See README-Linux.txt and BUILD.txt for details.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.03-source.tgz
3. tar -xzf g4beamline-2.03-source.tgz
4. rm g4beamline-2.03-source.tgz #(optional clean-up)
5. cd g4beamline-2.03
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.5.8, Leopard
- Red Hat Linux 7.3 (--old-versions)
- Scientific Linux Fermi 5.3
G4beamline release 2.02 is now available (20-APR-2010).
[+]
This release uses Geant4 9.3.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.24), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- HistoRoot has a serious bug when a variable is used with multiple NTuples selected — for NTuples after the first, the variable keeps the value of the last event in the first NTuple — this usually generates an un-physical spike in a histogram. A workaround is to avoid the variable and write out its expression.
- OI viewer issues a few error messages, but display is OK.
- g4blmake does not work on Windows, and might not work on Linux without –disable-visual; workarounds are available.
- The LisaPhysicsList does not work.
Major Changes from 2.0
- Improved build scripts and Makefiles.
- Improved handling of EventIDs in ASCII NTuples.
- New BLCMDntuple design; all NTuples can now be used in the 'ntuple' command.
- New 'particlesource' command to use the General Particle Source.
- New 'totalenergy' command to total the energy deposited in volumes during the entire run.
- Parameters defined from the environment.
- The 'extrusion' command now automatically selects the proper order of traversal of the polygon.
There are also numerous bug fixes and improvements, including the deadlock that sometimes causes the GUI to hang, and the handling of unary minus in expressions..
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.02-Linux-g++.tgz
3. tar -xzf g4beamline-2.02-Linux-g++.tgz
4. rm g4beamline-2.02-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.02-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 3.0.9, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs built on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.5 and 10.6 (Intel — Leopard and Snow Leopard)
1. download G4beamline-2.02-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into you HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
This (binary) release does not run on Tiger (OS X 10.4), or on any PowerPC system. You can, however, download the source and build it on Tiger; that ought to work on a PowerPC, but has not been tested.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz).
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.02.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, it might work, or you might need to install the source and build it.
Source
The source release 2.02 is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition. See README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update. See README-MacOSX.txt and BUILD.txt for details.
Linux: install the complete software development suite, including X-Windows, OpenGL, and OpenMotif/Lesstif development. See README-Linux.txt and BUILD.txt for details.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.02-source.tgz
3. tar -xzf g4beamline-2.02-source.tgz
4. rm g4beamline-2.02-source.tgz #(optional clean-up)
5. cd g4beamline-2.02
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.4, Tiger
- Mac OS X 10.5.8, Leopard
- Mac OS X 10.6.2, Snow Leopard
- Red Hat Linux 7.3 (--old-versions)
- Scientific Linux Fermi 3.0.9 (--old-versions)
- Scientific Linux Fermi 5.3
- Windows Xp
G4beamline release 2.01 is now available for Linux (19-JAN-2010).
[+]
This is essentially the same as release 2.0, except the install tarball has been fixed (the 2.0 tarball has symbolic links that make it impossible to use). For Windows, Mac OS, and source please use 2.0.
G4beamline-2.01-Linux-g++.tgz
G4beamline release 2.0 is now available (10-JAN-2010).
[+]
This release uses Geant4 9.2.p01.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.24), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
Known Bugs:
- The neutron dataset required for all physics lists ending in _HP may not be found correctly — contact Tom Roberts for an update to fix this problem.
- The LISAPhysicsList does not work.
- g4blmake does not work on Windows; a workaround is available.
Major Changes from 1.16
- The build process has been completely changed to make it easier for users to build G4beamline and add their own code.
- The source tarball now includes the source to all non-system libraries. See doc/BUILD.txt for instructions.
- The source tarball now expands into a different directory than the binary releases. Un-tar it in your HOME directory just like the binary release.
There are also numerous bug fixes and improvements.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.0-Linux-g++.tgz
3. tar -xzf g4beamline-2.0-Linux-g++.tgz
4. rm g4beamline-2.0-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-2.0-Linux-g++
6. ./setup
The setup script will create Desktop icons and will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Linux release was built on a Red Hat 7.3 system, which means it should run on any later RedHat-derived distribution, including both Scientific Linux and Fedora. It has been verified to run on: RedHat 7.3, SLF 3.0.9, SLF 4.5, SLF 5.3, Fedora Core 6. It may well run on other reasonably-modern Linux distributions, and should surely do so if built from source. Note you may need to install "compatibility libraries" to support programs build on older versions of Linux; README-Linux.txt provides some suggestions.
Mac OS X 10.4 and 10.5 (Intel)
1. download G4beamline-2.0-Darwin-g++.dmg
2. Double-click the installer, and drag the application icons into /Applications
3a You may want to drag the G4beamlineExamples directory into you HOME.
3b Ditto for the G4beamlineDocumentation directory.
4. Eject the installer disk image and move it to the Trash.
5. As usual you can drag applications from /Applications onto the Dock.
For command-line use, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The installation directory is /Applications/G4beamline.app/Contents/Resources .
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz). This means that to use a viewer you must run
g4bl from an Xterm window, which you get by running the X-Windows application.
This Mac OS X release was built on a system running Leopard (Mac OS X 10.5.8). It should run on any Intel Mac running Leopard or Snow Leopard. For Tiger or a PowerPC Mac, it should be possible to install the source and build it.
Windows
1. download G4beamline-2.0.msi
2. Double-click the installer, and follow the prompts
3. Move the installer to the Trash.
For command-line use in the Cygwin environment, cd to the installation directory and do ./setup — the setup script will guide you through adding the G4beamline programs into a directory in your PATH. The command-line programs will
NOT run in a Windows cmd window.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
This Windows release was built on a system running Windows Xp. It should run on any Windows Xp or Windows Vista system. For Windows 7, it might work, or you might need to install the source and build it.
Source
Unlike earlier releases, the source release 2.0 is independent of the binary release for each platform. It installs into a different directory. On a 4-core Mac Pro the build takes about an hour for the libraries, and 2 minutes for G4beamline itself. Windows and Linux tools are slower, and your hardware may be slower.
Prerequisites:
Windows: Install the Cygwin environment and Microsoft VC++ 2008 Express Edition; see README-Windows.txt and BUILD.txt for details.
Mac OS X: Install the XCode application (from your install DVD), and then do Software Update.
Linux: install the complete software development suite, including X-Windws development.
1. cd to your HOME directory (or other directory into which you want to install)
2. download G4beamline-2.0-source.tgz
3. tar -xzf g4beamline-2.0-source.tgz
4. rm g4beamline-2.0-source.tgz #(optional clean-up)
5. cd g4beamline-2.0
6. ./configure --help # read the help and determine the options you need
7. ./configure [--options]
8. make
9. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
This source distribution has been tested to build on the following systems. Note that very old compilers require the --old-versions option to configure:
- Mac OS X 10.5.8, Leopard
- Mac OS X 10.6.2, Snow Leopard
- Red Hat Linux 7.3 (./configure --old-versions)
- Scientific Linux Fermi 3.0.9 (./configure --old-versions)
- Scientific Linux Fermi 4.5
- Scientific Linux Fermi 5.3
- Windows Xp
G4beamline release 1.16 is now available (2-APR-2009).
[+]
This release uses Geant4 9.2.p01.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.22), required to use HistoRoot or G4blmovie; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
- Motif, OpenMotif, or LessTif on Linux and Mac
Known Bugs:
- Mac OS X update 10.5.7 breaks the Open Inventor Viewer. A workaround is to download the old library libGL.1.dylib and move it into --InstallDirectory--/lib/Darwin-g++. This will be fixed in the next release.
- When reading an input beam file containing secondary particles (parent != 0), G4beamline will sometimes abort. This bug was introduced in release 1.16. See Tom Roberts for a fix.
- In BLFieldMap with a time dependence, if the E-factor is omitted then 1.0 is used rather than the B-factor as documented. So don't omit the 3rd column in the time series. This affects all releases, and will be fixed in the next release.
- The LISAPhysicsList does not work.
- In movies, the longitudinal variables z and Pz do not have the Reference values subtracted, making them essentially useless.
Major Changes from 1.15.3
- The G4beamline User's Guide has been considerably enhanced. Experienced users should look at section 3 (Important Values that affect the Validity and Accuracy of Simulation), and section 7 (Tips and Techniques).
- G4beamline can now generate movies, in which the camera sits on the reference particle, watching the beam particles dancing around nearby; see this Movie for an example.
- in viewer mode, no output NTuple files (root, ASCII, FOR009.DAT, HistoScope) are written (they used to be truncated).
- TrackID and EventID are now properly preserved from input beam files.
- The tracker command can now fit tracks that don't hit every trackerplane.
- Additional visualization techniques are now documented (different x-, y-, and z-scales, background color, drawing axes, cut-away planes, etc.) in section 2.8.1.
- Comma-separated lists of floats can now use expressions
There are also numerous bug fixes and improvements.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.16-Linux-g++.tgz
3. tar -xzf g4beamline-1.16-Linux-g++.tgz
4. rm g4beamline-1.16-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-1.16-Linux-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Mac OS X 10.4 and 10.5 (Intel)
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.16-Darwin-g++.tgz
3. tar -xzf g4beamline-1.16-Darwin-g++.tgz
4. rm g4beamline-1.16-Darwin-g++.tgz (optional clean-up)
5. cd g4beamline-1.16-Darwin-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
- g4blmovie — generates a movie
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz). This means that to use a viewer you must run
g4bl from an Xterm window, which you get by running the X-Windows application.
Windows
G4beamline-1.16.msi This is an installer — just download and double-click it and it will install itself in the usual way, including putting shortcuts onto your desktop and into the Start menu. If you have installed Cygwin, you can also use the command-line programs in the same way as on Linux and Mac OS. Note you cannot run the tests without Cygwin (at present they are command-line only).
Source
First download the release for your platform and install it as above, then un-tar this tarball
g4beamline-1.16-source.tgz into the top g4beamline-1.16-* directory. See BUILD.txt for a detailed description of how I build G4beamline on all 3 platforms.
G4beamline release 1.15.3 is now available (8-JAN-2009).
[+]
This release uses Geant4 9.1.p02.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.20), required to use HistoRoot; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
- Motif, OpenMotif, or LessTif on Linux and Mac
Known Bugs:
- The LISAPhysicsList does not work.
- Collective mode still has some minor bugs (reference, trace).
- physics QBBC fails because it cannot find the G4NDL dataset, even if you have downloaded it correctly (G4NEUTRONHPDATA); contact Tom Roberts for a fix. May also affect other physics lists.
- Reference coordinates z and Pz do not have the Reference-particle's values subtracted.
- HistoRoot fails if MaxEv is set; contact Tom Roberts for a fix.
Major Changes from 1.15
- The B field in pillbox has been corrected (it has been a factor of 1E9 too small since release 1.0, due to an error in legacy code).
- HistoRoot has been significantly enhanced (see its help for details):
- limits can be set in expressions
- variables can be defined in terms of NTuple fields and used like fields in expressions
- the set of plots for a given NTuple can be saved to a file and then restored; includes current slider values
- new command: torus
- improved collective-mode tracking (significantly better)
- improved exception handling
- fix in fieldexpr: timeOffset is no longer ignored
- fix in BLCoil: better handling of changes to avoid re-computing disk file
- The cause of crashes on Windows has been fixed, and reported to the Geant4 collaboration as bug 1018.
- G4beamline now installs and runs on Windows Vista, as well as Windows Xp.
- The installer now copies the examples to "My Documents\G4beamline Examples" on Windows Xp, and to "Documents\G4beamline Examples" on Windows Vista; a shortcut to G4beamlineUsersGuide.pdf is also placed there.
There are also numerous bug fixes and improvements.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.15.3-Linux-g++.tgz
3. tar -xzf g4beamline-1.15.3-Linux-g++.tgz
4. rm g4beamline-1.15.3-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-1.15.3-Linux-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
Note: you may need to install openmotif from your Linux distribution (libXm.so.3).
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
Mac OS X 10.4 (Intel)
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.15.3-Darwin-g++.tgz
3. tar -xzf g4beamline-1.15.3-Darwin-g++.tgz
4. rm g4beamline-1.15.3-Darwin-g++.tgz (optional clean-up)
5. cd g4beamline-1.15.3-Darwin-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
Note: you may need to use Fink Commander to install lesstif (libXm.2.0.1.dylib).
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz). This means that to use a viewer you must run
g4bl from an Xterm window, which you get by running the X-Windows application.
Windows
G4beamline-1.15.3.msi This is an installer — just download and double-click it and it will install itself in the usual way, including putting shortcuts onto your desktop and into the Start menu. If you have installed Cygwin, you can also use the command-line programs in the same way as on Linux and Mac OS. Note you cannot run the tests without Cygwin (at present they are command-line only).
Source
First download the release for your platform and install it as above, then un-tar this tarball
g4beamline-1.15.3-source.tgz into the top g4beamline-1.15.3-* directory. See BUILD.txt for a detailed description of how I build G4beamline on all 3 platforms.
G4beamline release 1.15.1 is now available (14-Aug-2008).
[+]
This release uses Geant4 9.1.p02. WINDOWS ONLY.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.20), required to use HistoRoot; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
- Motif, OpenMotif, or LessTif on Linux and Mac
Known Bugs:
- The LISAPhysicsList does not work.
- This release does not include collective computations.
Major Changes from 1.15
- The cause of crashes on Windows has been fixed, and reported to the Geant4 collaboration as bug 1018.
- G4beamline now installs and runs on Windows Vista, as well as Windows Xp.
- The installer now copies the examples to "My Documents\G4beamline Examples" on Windows Xp, and to "Documents\G4beamline Examples" on Windows Vista; a shortcut to G4beamlineUsersGuide.pdf is also placed there.
There are also numerous bug fixes and improvements.
Linux
Please use release 1.15.
Mac OS X 10.4 (Intel)
Please use release 1.15.
Windows
G4beamline-1.15.1.msi This is an installer — just download and double-click it and it will install itself in the usual way, including putting shortcuts onto your desktop and into the Start menu. If you have installed Cygwin, you can also use the command-line programs in the same way as on Linux and Mac OS. Note you cannot run the tests without Cygwin (at present they are command-line only).
Source
Please use release 1.15.
G4beamline release 1.15 is now available (2-Aug-2008).
[+]
This release uses Geant4 9.1.p02.
Prerequisites:
- Java (1.5 or later), required for the GUI; g4beamline itself does not use Java
- Root (5.12 thru 5.20), required to use HistoRoot; g4beamline itself does not need Root installed (it includes the Root libraries it needs)
- tcl (any version), required for the tests; g4beamline itself does not use tcl
- Motif, OpenMotif, or LessTif on Linux and Mac
Known Bugs:
- This release is not yet ready for Windows.
- The LISAPhysicsList does not work.
- This release does not include collective computations.
Major Changes from 1.14.3
- The terrible slowdown in tracking for certain commands has been fixed; now zntuple is every bit as efficient as virtualdetector. The commands that used to slow it down are: printf, profile, reference (using momentum tuning), tracker, tune, zntuple (these are the commands that specify a Z position rather than a volume boundary).
- More complete testing and verification.
- Documentation has been updated.
There are also numerous bug fixes and improvements.
Linux
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.15-Linux-g++.tgz
3. tar -xzf g4beamline-1.15-Linux-g++.tgz
4. rm g4beamline-1.15-Linux-g++.tgz (optional clean-up)
5. cd g4beamline-1.15-Linux-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
Note: you may need to install openmotif from your Linux distribution (libXm.so.3).
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
Mac OS X 10.4 (Intel)
1. cd to your HOME directory (or other directory into which you want to install)
2. download g4beamline-1.15-Darwin-g++.tgz
3. tar -xzf g4beamline-1.15-Darwin-g++.tgz
4. rm g4beamline-1.15-Darwin-g++.tgz (optional clean-up)
5. cd g4beamline-1.15-Darwin-g++
6. ./setup
The setup script will guide you through adding the G4beamline programs into a directory in your PATH.
Note: you may need to use Fink Commander to install lesstif (libXm.2.0.1.dylib).
The programs are:
- g4bl — runs g4beamline
- g4blgui — runs the same GUI used by default on Windows
- historoot — provides a GUI to the Root histogramming capabilities
Note the G4beamline viewers all use X-windows, but the GUIs (g4blgui, historoot) run native Mac OS (i.e. quartz). This means that to use a viewer you must run
g4bl from an Xterm window, which you get by running the X-Windows application.
Windows
Please use release 1.15.1.
Source
First download the release for your platform and install it as above, then un-tar this tarball
g4beamline-1.15-source.tgz into the top g4beamline-1.15-* directory. See BUILD.txt for a detailed description of how I build G4beamline on all 3 platforms.
G4beamline release 1.14.3 is now available (21-JULY-2008)
[+]
This is
just like 1.14b except that the tracker command has been fixed to handle timing correctly, and to output fit tracks in FOR009.DAT format. This is an
incremental release, and the User's guide has not been updated, so use the online help (either in the GUI or via the help command).
Linux:
g4beamline-1.14.3-Linux-g++.tgz
Mac OS X:
g4beamline-1.14.3-Darwin-g++.tgz
Windows: (not available yet)
G4beamline release 1.14b is now available (20-JUNE-2008).
[+]
This release uses Geant4 9.1.p01. It is
just like release 1.14 except that several bugs have been fixed and a few new features have been implemented. It is an
incremental release, and the User's guide has not been updated, so use the online help (either in the GUI or via the help command).
Major Changes:
- Objects can be placed inside a genericbend (new argument openAperture)
- Extended-precision is available in steppingFormat (see help)
- Bugs in sphere are fixed
- Bugs in beam command after a corner are fixed
- Eventcuts interface to historoot is completed.
- historoot now works with root 1.18 (including Mac OS 10.5, leopard).
- multiple runs in the GUI use different events.
- the major changes for 1.14 also apply
Known Bugs:
- The Windows version does not run on Windows Vista.
- The Windows version will crash in physics-list QGSP for ha
