Low Energy Electromagnetic Physics

 

 

User Requirements Document

 

 

 

 

 

 

 

 

 

 

 

 

Status: in CVS repository

 

 

Version: 2.5

Project: Geant4-LowE

Created: 22 June 1999

Last modified: 12 October 2002

Prepared by: Maria Grazia Pia (INFN)


Introduction

Purpose of the document

This document collects the specific requirements concerning Geant4 Low Energy Electromagnetic Physics expressed by users. Please refer to Geant4 User Requirement Document for the general context.

Scope of the software

Low Energy Electromagnetic Physics provides software for the simulation of electromagnetic interactions of electrons, positrons, photons, hadrons and ions, extended down to low energies.

Product perspective

The software is meant to be part of the Geant4 Toolkit. 

General capabilities

The user shall be able to simulate the electromagnetic interactions of electrons, positrons, photons, hadrons and ions down to low energies.

The user shall be able to simulate atomic relaxation.

The user shall be able to simulate polarisation.

General constraints

Geant4 Low Energy Electromagnetic Physics will be compatible for usage with the Geant4 Toolkit.

The user will be able to customize services in a suitable way for his/her specific applications.

User characteristics

User communities especially interested in Low Energy Electromagnetic Physics are astrophysics and astroparticle experiments, space science experts, medical physics groups.

The experiments and associated groups contributing to this document include:

Operational environment

The software will be for use in a Unix environment with an ISO compliant C++ compiler, subject to the same environment as the Geant4 Toolkit.

Assumptions and dependencies

This document relies on the assumption that Geant4 Low Energy Electromagnetic Physics project will be supported and adequately funded.


Specific Requirements

Capability requirements

Electrons, positrons and photons

UR 1.1       The user shall be able to simulate interactions of electrons and photons down to 250 eV.

Need: Essential

Priority: Implemented

Stability: Stable

Source: ESA

Clarity: Clear

Verifiability: To be verified

UR 1.2       The user shall be able to simulate interactions of electrons and photons down to the order of the eV.

Need: Potentially useful

Priority: To be evaluated

Stability: Under evaluation

Source: ESA

Clarity: Under evaluation

Verifiability: To be verified  

UR 1.3       The user shall be able to simulate the interactions of positrons of energy between 0 and 20 MeV.

Need: Essential

Priority: To be evaluated

Stability: Stable

Source: CERN experiment IS370

Clarity: Clear

Verifiability: To be verified

UR 1.4       The user shall be able to simulate electron binding effects and Doppler broadening.

Need: Essential

Priority: To be evaluated

Stability: Stable

Source: Yale medical physics group

Clarity: Clear

Verifiability: To be verified

UR 1.5       The user shall be able to simulate interactions of positrons down to the same lower energy limit as electrons.

Need: Essential

Priority: To be evaluated

Stability: Stable

Source: Univ. of Valencia, study of beta decays

Clarity: Clear

Verifiability: To be verified

Hadrons and ions

UR 2.1       The user shall be able to simulate interactions of positive charged hadrons down to < 1 KeV.

Need: Essential

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groupspan>

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups, PIXE et al.

Clarity: Clear

Verifiability: To be verified    

UR 2.3       The user shall be able to simulate the energy loss and production of secondaries for antiprotons down to < 1 KeV in metallic materials and in materials transparent to light.

Need: Essential

Priority: T. b. d.

Stability: Stable

Source: ATHENA experiment

Clarity: Clear

Verifiability: To be verified

UR 2.4       The user shall be able to simulate the electromagnetic interactions of heavy ions with negative charge down to 1 keV.

Need: Essential

Priority: T. b. d.

Stability: T. b. d.

Source: Milano Weak Interactions Group

Clarity: Clear

Verifiability: To be verified

UR 2.4              

UR 2.5       The user shall be able to simulate straggling.

Need: Essential

Priority: Needed in 2000

Stability: Stable

Source: INFN

Clarity: Clear

Verifiability: To be verified

UR 2.6       The user shall be able to simulate the low angle elastic surface scattering of protons of energy up to a few MeV.

Need: Essential

Priority: Needed in 2001

Stability: Stable

Source: ESA

Clarity: Clear

Verifiability: To be verified

Atomic relaxation

UR 3.1       The user shall be able to simulate the atomic excitation and relaxation induced by electrons and photons.

Need: Essential

Priority: Needed by June 2001

Stability: Stable

Source: ESA Space Department (Bepi Colombo mission)

Clarity: Clear

Verifiability: To be verified

UR 3.2       The user shall be able to simulate the atomic excitation and relaxation induced by hadrons.

Need: Essential

Priority: Needed by June 2001

Stability: Stable

Source: ESA Space Department (Bepi Colombo mission), INFN PIXE

Clarity: Clear

Verifiability: To be verified

UR 3.3       The user shall be able to simulate the atomic excitation and relaxation induced by ions.

Need: Essential

Priority: Needed by October 2001

Stability: Stable

Source: INFN PIXE

Clarity: Clear

Verifiability: To be verified

Polarisation

UR 4.1       The user shall be able to simulate polarised Compton scattering.

Need: Essential

Priority: Needed by end 2001

Stability: Stable

Source: INFN-Argentinian telescope, UNH

Clarity: Clear

Verifiability: To be verified

UR 4.2       The user shall be able to simulate polarised Rayleigh scattering.

Need: Essential

Priority: Needed by end 2001

Stability: Stable

Source: UNH

Clarity: Clear

Verifiability: To be verified

UR 4.5       The user shall be able to simulate polarised g conversion.

Need: Essential

Priority: Needed by end 2001

Stability: Stable

Source: AGILE

Clarity: Clear

Verifiability: To be verified

UR 4.5       The user shall be able to simulate polarised photoelectric effect.

Need: Essential

Priority: To be evaluated

Stability: Stable

Source: G. Depaola, F. Longo

Clarity: Clear

Verifiability: To be verified

General

UR 5.1       The user shall be able to mix different physical models for a same physics process across an energy range.

Need: Unclear

Priority: T.b.d.

Stability: Stable

Source: P. Gumplinger

Clarity: Clear

Verifiability: To be verified

UR 5.2       The user shall be able to activate different physical models for a same physics process in different components of the experimental set-up, according to the different features required.

Need: Unclear

Priority: T.b.d.

Stability: Stable

Source: Atlas, Medical physics groups, Bepi Colombo

Clarity: Clear

Verifiability: To be verified

Constraint requirements

Electrons and photons

UR A.1       The energy range of energies of incident electrons and photons to be handled by medical applications should be between 1 keV and 20 MeV.

Need: Essential

Priority: T.B.D

Stability: Stable

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified  

UR A.2       The user shall be able to simulate the 3-dimensional distribution of the absorbed dose released in human body by electrons and photons with precision of the order of 1 mm. 

Need: Essential for treatment planning in radiotherapy

Priority: T. b. d.

Stability: Stable

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR A.3       The user shall be able to simulate the 3-dimensional energy deposit in human body with precision of the order of 1 mm, resulting from incident electrons and photons.

Need: Essential for microdosimetry

Priority: T. b. d.

Stability: Stable

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR A.4       The user shall be able to simulate the 3-dimensional distribution of the energy deposit in human body along and around the track with precision of the order of 1 nm, resulting from incident electrons and photons.

Need: Essential for radiobiology

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR A.5       The user shall be able to simulate accurate angular distribution of Bremsstrahlung, with models comparable or better as in EGSnrc PIRS-701.

Need: Essential

Priority: To be evaluated

Stability: Stable

Source: LIP medical physics group

Clarity: Unclear, reference to physics paper required

Verifiability: To be verified

UR A.6       The user shall be able to simulate accurate angular distribution of photoelectric effect, with models comparable to, or better than, the one in W. Heitler, The Quantum Theory of Radiation, 1984, Dover, New York

Need: Essial;mso-bidi-font-family:"Times New Roman"'>Priority: To be evaluated

Stability: Stable

Source: LIP medical physics group

Cdent>Need: Essential

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.2       The energy range of energies of incident ions to be handled by medical applications should be up to 500 MeV/u.

Need: Essential

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified 

UR B.3       The energy range of energies of incident antiprotons to be handled should be between < 1 KeV up to a few MeV.

Need: Essential

Priority: T. b. d.

Stability: Stable

Source: ATHENA experiment

Clarity: Clear

Verifiability: To be verified 

UR B.4       The energy range of energies of incident negative ions to be handled should be between 1 keV and a few hundred keV

Need: Essential

Priority: T. b. d.

Stability: Stable

Source: Milano Weak Interactions Group

Clarity: Clear

Verifiability: To be verified

UR B.5       The user shall be able to simulate the 3-dimensional distribution of the absorbed dose in human body with precision of the order of 1 mm, resulting from incident protons.

Need: Essential for treatment planning in radiotherapy

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.6       The user shall be able to simulate the 3-dimensional distribution of the absorbed dose released in human body by ions with precision of the order of 1 mm.

Need: Essential for treatment planning in radiotherapy

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.7       The user shall be able to simulate the 3-dimensional energy deposit in human body with precision of the order of 1 micron, resulting from incident protons.

Need: Essential for microdosimetry

Priority: T. b. d.

Stability: Stable

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.8       The user shall be able to simulate the 3-dimensional energy deposit in human body with precision of the order of 1 micron, resulting from incident ions.

Need: Essential for microdosimetry

Priority: T. b. d.

Stability: Stable

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.9       The user shall be able to simulate the 3-dimensional distribution of the energy deposit in human body along and around the track with precision of the order of 1 nm, resulting from incident protons.

Need: Essential for radiobiology

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.10     The user shall be able to simulate the 3-dimensional distribution of the energy deposit in human body along and around the track with precision of the order of 1 nm, resulting from ions.

Need: Essential for radiobiology

Priority: T. b. d.

Stability: T. b. d.

Source: Medical physics groups

Clarity: Clear

Verifiability: To be verified

UR B.11     The user shall be able to simulate the electromagnetic interactions of heavy ions with negative charge and energy between 1 keV and a few hundred keV.

Need: Essential

Priority: T. b. d.

Stability: Stable

Source: Milano Weak Interactions Group

Clarity: Clear

Verifiability: To be verified

 

Atomic relaxation

UR C.1       The user shall be able to simulate the fluorescence corresponding to K, L, M lines.

Need: Essential

Priority: Needed by June 2001

Stability: Stable

Source: INFN PIXE

Clarity: Clear

Verifiability: To be verified

Polarisation

UR D.1       The user shall be able to simulate the effects of incident polarisation in a more complete way than only in the first scatter.

Need: Essential

Priority: Needed by June 2001

Stability: T. b. d.

Source: UNH

Clarity: T. b. d.

Verifiability: To be verified

General

UR E.1       The user should have access to examples of real-life applications involving low energy electromagnetic physics.

Need: Essential

Priority: T. b. d.

Stability: Stable

Source: INFN

Clarity: Clear

Verifiability: To be verified


Document Status

 

Document Title:

Geant4-LowE URD

Issue:

Revision:

Date:

Reason for change:

0

0

22 June 1999

Created

0

1

29 June 1999

Updates received from users

0

2

2 July 1999

Updates received from users

0

3

3 July 1999

Updates received from medical physics groups

0

4

5 July 1999

Minor editorial modifications

1

Updates received from IST, MI-Weak interactions group, LUNA

2

0

25 December 2000

Reformatted into MS Word

Removed limitation to INFN experiments

Added requirement from users at Univ. Montreal

2

1

22 January 2001

Added requirements on polarisation

2

2

22 February 2001

Added requirements on positrons, Doppler broadening

2

3

20 March 2001

Reformatted and cleaned up

2

4

26 March 2001

Petteri modified low angle scattering

2

5

12 October 2002

Added requirements on angular distributions, positrons, models