This module contains procedures and generic interfaces for modeling data and detectors of the BATSE Gamma-Ray detectors onboard the NASA Compton Gamma-Ray Observatory.
More...

Data Types
interface	getCorrectionLogEffPPF
	Generate and return the correction required for converting an input natural-log peak photon flux in 64ms timescale in the BATSE detection energy range to an effective triggering peak photon flux in the same energy range. More...

interface	getLog10PF53
	[LEGACY code] This generic interface is identical to the generic interface getLogPF53 with the only difference that all input and output arguments must be in \(\log_{10}(\cdot)\) instead of natural logarithm. More...

interface	getLogEffPPF
	Generate and return the conversion of an input natural logarithm of peak photon flux in 64ms timescale to an effective triggering peak photon flux both in the BATSE detection energy range \([50, 300]\kev\). More...

interface	getLogPbol
	Generate and return the conversion of an input natural logarithm of photon flux/fluence over a given time in the BATSE detection energy range \([50, 300]\kev\) to a bolometric ( \([0.0001, 20000]\kev\)) energy flux/fluence in units of \(\ergs\) over the same time. More...

interface	getLogPF53
	Generate and return the conversion of an input natural logarithm of a bolometric ( \([0.0001, 20000]\kev\)) energy flux/fluence in units of \(\ergs\) over a given time to the photon flux/fluence over the same time in the BATSE detection energy range \([50, 300]\kev\). More...

type	grb_type
	This is the derived type for generating objects that contain attributes of BATSE catalog GRBs. More...

Variables
character(*, SK), parameter	MODULE_NAME = "@pm_batse"

real(RKB), parameter	LOG_TEN = log(10._RKB)

real(RKB), parameter	MIN_LOG10PH53_4_LOGPBOLZERO = 4.92_RKB

real(RKB), parameter	MAX_LOG10PH53_4_LOGPBOLZERO = 6.318167895318538_RKB

real(RKB), parameter	MAX_LOGPH53_4_LOGPBOLZERO = MAX_LOG10PH53_4_LOGPBOLZERO * LOG_TEN

real(RKB), parameter	MIN_LOGPH53_4_LOGPBOLZERO = MIN_LOG10PH53_4_LOGPBOLZERO * LOG_TEN

real(RKB), parameter	DIF_LOGPH53_4_LOGPBOLZERO = MAX_LOGPH53_4_LOGPBOLZERO - MIN_LOGPH53_4_LOGPBOLZERO

real(RKB), parameter	LOGPF53_MINUS_LOGPBOL = 11.328718657530706_RKB

real(RKB), parameter	LOG10PF53_MINUS_LOG10PBOL = LOGPF53_MINUS_LOGPBOL / LOG_TEN

real(RKB), parameter	THRESH_ERFC_BASE = +0.146314238936889_RKB * LOG_TEN
	The scale of the change in BATSE efficiency for different SGRB durations. More...

real(RKB), parameter	THRESH_ERFC_AMP = +0.282313526464596_RKB * LOG_TEN
	The scale of the change in BATSE efficiency for different GRB durations. More...

real(RKB), parameter	THRESH_ERFC_AVG = -0.483553339256463_RKB * LOG_TEN
	Mean duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms. More...

real(RKB), parameter	THRESH_ERFC_STD = 1.0514698984694800_RKB * LOG_TEN
	Scale of the duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms. More...

real(RKB), parameter	THRESH_ERFC_STD_INV = 1._RKB / THRESH_ERFC_STD
	Inverse scale of the duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms. More...

real(RKB), parameter	THRESH_ERFC_HEIGHT = 2 * THRESH_ERFC_AMP

real(RKB), parameter	THRESH_LOGPBOL64_CORRECTION = DIF_LOGPH53_4_LOGPBOLZERO - MIN_LOGPH53_4_LOGPBOLZERO + THRESH_ERFC_HEIGHT
	Correction that must be added to logPbol64ms to convert it to effective peak flux. More...

Detailed Description

This module contains procedures and generic interfaces for modeling data and detectors of the BATSE Gamma-Ray detectors onboard the NASA Compton Gamma-Ray Observatory.

The Compton Gamma Ray Observatory (CGRO) was a space observatory detecting photons with energies from 20 keV to 30 GeV, in Earth orbit from 1991 to 2000.
The observatory featured four main telescopes in one spacecraft, covering X-rays and gamma rays, including various specialized sub-instruments and detectors.
Following 14 years of effort, the observatory was launched from Space Shuttle Atlantis during STS-37 on April 5, 1991, and operated until its deorbit on June 4, 2000.
It was deployed in low Earth orbit at 450 km (280 mi) to avoid the Van Allen radiation belt.
It was the heaviest astrophysical payload ever flown at that time at 16,300 kilograms (35,900 lb).

Instruments

CGRO carried a complement of four instruments that covered an unprecedented six orders of the electromagnetic spectrum, from 20 keV to 30 GeV.
Only the major instrument of interest to this module is discussed below.

BATSE

The Burst and Transient Source Experiment (BATSE) by the NASA Marshall Space Flight Center searched the sky for gamma-ray bursts (20 to >600 keV) and conducted full-sky surveys for long-lived sources.
It consisted of eight identical detector modules, one at each of the satellite corners.
Each module consisted of both a NaI(Tl) Large Area Detector (LAD) covering the 20 keV to ~2 MeV range, 50.48 cm in dia by 1.27 cm thick, and a 12.7 cm dia by 7.62 cm thick NaI Spectroscopy Detector, which extended the upper energy range to 8 MeV, all surrounded by a plastic scintillator in active anti-coincidence to veto the large background rates due to cosmic rays and trapped radiation.
Sudden increases in the LAD rates triggered a high-speed data storage mode, the details of the burst being read out to telemetry later.
Bursts were typically detected at rates of roughly one per day over the 9-year CGRO mission.
A strong burst could result in the observation of many thousands of gamma-rays within a time interval ranging from ~0.1 s up to about 100 s.

Other instruments

See the references below.

See also: pm_distBand
Kaneko, 2005, Spectral studies of gamma-ray burst prompt emission.
Shahmoradi and Nemiroff, 2015, MNRAS, 451:4645-4662.

Test:: test_pm_batse

Final Remarks ⛓

If you believe this algorithm or its documentation can be improved, we appreciate your contribution and help to edit this page's documentation and source file on GitHub.
For details on the naming abbreviations, see this page.
For details on the naming conventions, see this page.
This software is distributed under the MIT license with additional terms outlined below.

If you use any parts or concepts from this library to any extent, please acknowledge the usage by citing the relevant publications of the ParaMonte library.
If you regenerate any parts/ideas from this library in a programming environment other than those currently supported by this ParaMonte library (i.e., other than C, C++, Fortran, MATLAB, Python, R), please also ask the end users to cite this original ParaMonte library.

This software is available to the public under a highly permissive license.
Help us justify its continued development and maintenance by acknowledging its benefit to society, distributing it, and contributing to it.

Copyright: Computational Data Science Lab

Author:: Fatemeh Bagheri, Tuesday, April 30, 2019, 12:58 PM, SEIR, UTA

Variable Documentation

◆ DIF_LOGPH53_4_LOGPBOLZERO

real(RKB), parameter pm_batse::DIF_LOGPH53_4_LOGPBOLZERO = MAX_LOGPH53_4_LOGPBOLZERO - MIN_LOGPH53_4_LOGPBOLZERO

Definition at line 82 of file pm_batse.F90.

◆ LOG10PF53_MINUS_LOG10PBOL

real(RKB), parameter pm_batse::LOG10PF53_MINUS_LOG10PBOL = LOGPF53_MINUS_LOGPBOL / LOG_TEN

Definition at line 99 of file pm_batse.F90.

◆ LOG_TEN

real(RKB), parameter pm_batse::LOG_TEN = log(10._RKB)

Definition at line 77 of file pm_batse.F90.

◆ LOGPF53_MINUS_LOGPBOL

real(RKB), parameter pm_batse::LOGPF53_MINUS_LOGPBOL = 11.328718657530706_RKB

Definition at line 98 of file pm_batse.F90.

◆ MAX_LOG10PH53_4_LOGPBOLZERO

real(RKB), parameter pm_batse::MAX_LOG10PH53_4_LOGPBOLZERO = 6.318167895318538_RKB

Definition at line 79 of file pm_batse.F90.

◆ MAX_LOGPH53_4_LOGPBOLZERO

real(RKB), parameter pm_batse::MAX_LOGPH53_4_LOGPBOLZERO = MAX_LOG10PH53_4_LOGPBOLZERO * LOG_TEN

Definition at line 80 of file pm_batse.F90.

◆ MIN_LOG10PH53_4_LOGPBOLZERO

real(RKB), parameter pm_batse::MIN_LOG10PH53_4_LOGPBOLZERO = 4.92_RKB

Definition at line 78 of file pm_batse.F90.

◆ MIN_LOGPH53_4_LOGPBOLZERO

real(RKB), parameter pm_batse::MIN_LOGPH53_4_LOGPBOLZERO = MIN_LOG10PH53_4_LOGPBOLZERO * LOG_TEN

Definition at line 81 of file pm_batse.F90.

◆ MODULE_NAME

character(*, SK), parameter pm_batse::MODULE_NAME = "@pm_batse"

Definition at line 75 of file pm_batse.F90.

◆ THRESH_ERFC_AMP

real(RKB), parameter pm_batse::THRESH_ERFC_AMP = +0.282313526464596_RKB * LOG_TEN

The scale of the change in BATSE efficiency for different GRB durations.

Definition at line 105 of file pm_batse.F90.

◆ THRESH_ERFC_AVG

real(RKB), parameter pm_batse::THRESH_ERFC_AVG = -0.483553339256463_RKB * LOG_TEN

Mean duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms.

Definition at line 108 of file pm_batse.F90.

◆ THRESH_ERFC_BASE

real(RKB), parameter pm_batse::THRESH_ERFC_BASE = +0.146314238936889_RKB * LOG_TEN

The scale of the change in BATSE efficiency for different SGRB durations.

Definition at line 102 of file pm_batse.F90.

◆ THRESH_ERFC_HEIGHT

real(RKB), parameter pm_batse::THRESH_ERFC_HEIGHT = 2 * THRESH_ERFC_AMP

Definition at line 117 of file pm_batse.F90.

◆ THRESH_ERFC_STD

real(RKB), parameter pm_batse::THRESH_ERFC_STD = 1.0514698984694800_RKB * LOG_TEN

Scale of the duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms.

Definition at line 111 of file pm_batse.F90.

◆ THRESH_ERFC_STD_INV

real(RKB), parameter pm_batse::THRESH_ERFC_STD_INV = 1._RKB / THRESH_ERFC_STD

Inverse scale of the duration in the Error function used to model the connection between the peak fluxes in 64 and 1024 ms.

Definition at line 114 of file pm_batse.F90.

◆ THRESH_LOGPBOL64_CORRECTION

real(RKB), parameter pm_batse::THRESH_LOGPBOL64_CORRECTION = DIF_LOGPH53_4_LOGPBOLZERO - MIN_LOGPH53_4_LOGPBOLZERO + THRESH_ERFC_HEIGHT

Correction that must be added to logPbol64ms to convert it to effective peak flux.

Definition at line 121 of file pm_batse.F90.

Data Types

Variables