1. 简介
GECAM响应矩阵产生器依据对GECAM全质量模型的蒙卡结果，结合GECAM载荷的在轨响应，生成在轨的GECAM响应矩阵。GECAM响应矩阵产生器的语言为PYTHON3。
2. 下载
3. 安装
用户在任意目录，执行安装脚本：source CALDB_dir/ software/tools/caldbinit.sh，其中CALDB_dir为CALDB的目录路径。安装脚本会写入环境变量CALDB和PYTHONPATH。
4. 通过函数返回值形式，生成响应矩阵
次序 | python命令示例 | 功能描述 | 输入描述 | 输出描述 |
1 | from RSP_Generator import gen_rsp | 取得API函数 | l 无 | l 无 |
2 | ret_value = gen_rsp(detname, theta, phi, event_type='evt', particle='gamma', MET='now', temp=None, hv=None,) | 尝试获得响应矩阵产生器返回值 | l detname: 探头编号，例如’bg01H’ l theta: 目标theta角度[0,180] l phi: 目标phi角度[0,360) l event_type: 事例类型, evt/btime/bspec l particle: 粒子类型 l MET: MET时间，默认为当前日期时间 l hv: 偏压值，浮点，可以不指定 l temp：温度值，浮点，可以不指定 | l ret_value:返回值，程序异常时为None。正常可拆解为一系列数据。 |
3 | final_rsp, mc_energ_lo, mc_energ_hi, oo_e_min, oo_e_max, final_ebounds_infiles, final_rsp_infiles = ret_value | 拆解，得到响应矩阵及相关的结果 | l ret_value：上一步的返回值 | l final_rsp: 响应矩阵，shape为(n_MC_Ein, n_OO_Edep) l mc_energ_lo: MC输入能量bin下阈，shape为(n_MC_Ein,) l mc_energ_hi: MC输入能量bin上阈，shape为(n_MC_Ein,) l oo_e_min: 在轨沉积能量bin下阈，shape为(n_OO_Edep,) l oo_e_max: 在轨沉积能量bin上阈，shape为(n_OO_Edep,) l final_ebounds_infiles: 在轨沉积能量的依赖文件列表，路径的数组 l final_rsp_infiles: 响应矩阵的依赖文件列表，路径的数组 |
5. 通过输出FITS文件的形式，生成响应矩阵
次序 | python命令示例 | 功能描述 | 输入描述 | 输出描述 |
1 | from RSP_Generator import gen_rsp_fits | 取得API函数 | l 无 | l 无 |
2 | gen_rsp_fits(detname, theta, phi, fits_filepath=None,fits_dir=None,is_overwrite=False, event_type='evt', particle='gamma', MET='now', temp=None, hv=None,uid=None, src=None, version=None) | 生成响应矩阵FITS文件 | l detname: 探头编号，例如’bg01H’ l theta: 目标theta角度[0,180] l phi: 目标phi角[0,360) l fits_filepath: 输出FITS文件路径，如果为None，则自动构造 l fits_dir: FITS输出的目录，仅在fits_filepath=None时起作用。 l is_overwrite: 是否覆盖FITS文件（bool类型） l event_type: 事例类型，evt/btime/bspec l particle: 粒子类型 l MET: MET时间，默认为当前日期时间 l hv: 偏压值，浮点，可以不指定 l temp：温度值，浮点，可以不指定 l uid：触发UID(utnYYMMDD_hhmmss_instru)或暴发UID(bnYYMMDD_hhmmss[/B/C..])，字符串格式，可以不指定。用于1Q/2级数据的命名，当fits_filepath=None时起作用。 l src：处理源，譬如BA的代号，软件代号等，字符串格式，可以不指定。用于1Q/2级数据的命名，当fits_filepath=None时起作用。 l version：版本号，整数取值0-99，也可以不指定。用于1Q/2级数据的命名，当fits_filepath=None时起作用。 | l 是否输出FITS成功 |