当前位置:首页 数据分析 软件信息 数据分析软件安装指南v2.01(中文)

HXMT简介

“慧眼”(英文名Insight)硬X射线调制望远镜(Hard X-ray Modulation Telescope,简称HXMT)卫星是我国第一个空间天文卫星,是既可以实现宽波段、大视场X射线巡天又能够研究黑洞、中子星等高能天体的短时标光变和宽波段能谱的空间X射线天文望远镜,同时也是具有高灵敏度的伽马射线暴全天监视仪。作为我国第一台太空望远镜,HXMT在2005年8月和2007年3月被列入国家《“十一五”空间科学发展规划》和《航天发展“十一五”规划》,2011年正式进入工程研制阶段。2017年6月15日HXMT卫星发射成功,开展科学观测。HXMT的成功发射和运行,将使我国在国际竞争激烈的的高能天体物理观测领域占有重要的一席之地。

IMAGE 第二届“慧眼”卫星用户大会在高能所成功召开
2018年12月17-18日,第二届"慧眼"卫星用户大会在中科院高能所举行,来自全国26家大学及科研院所的110名学者出席了此次会议。中科院粒子天体物理重点实验室宋黎明研究员致欢迎辞并介绍了"慧眼"卫星的概况、联合基金及数据政策等事项,希望科学用户们通过此次大会,掌握最新的数据处理流程及软件使用方法,积极参与"慧眼"卫...
IMAGE 第三届亚太合作天体物理国际研讨会暨慧眼卫星发射一周年学术会议召开
      6月18日至22日,第三届亚太合作天体物理国际研讨会暨慧眼卫星发射一周年学术会议在成都举行,来自全国20多家科研院所及大学的近150余名学者,以及来自美国、日本等8个国家的30余名学者参会。会议由中国科学院高能物理研究所主办。     “亚太合作天体物理国际...
关于举办“第三届亚太合作天体物理国际研讨会--暨慧眼卫星发射一周年学术会议”的会议通知
第三届亚太合作天体物理国际研讨会--暨慧眼卫星发射一周年学术会议 会议通知 第三届亚太合作天体物理国际研讨会--暨慧眼卫星发射一周年学术会议(The 3rd PANDA Symposium on Time Domain Astronomy and first results from Insight-HXMT)定于20...
IMAGE “第二届慧眼-HXMT标定和科学联合研讨会”在高能所成功召开
2018年4月11-13日,“第二届慧眼-HXMT标定和科学联合研讨会”在高能所成功举行,来自德国和意大利的四位学者应邀出席了此次会议,另有多名外国学者通过网络远程参加研讨。高能所粒子天体物理中心主任、慧眼-HXMT首席科学家张双南研究员首先对各位学者表示了热烈欢迎。随后,四位学者与“慧眼-HXMT”卫星团队成员就慧眼...
IMAGE “慧眼”卫星顺利完成在轨交付,正式投入使用
1月30日,我国首颗X射线天文卫星“慧眼”圆满完成了5个多月的在轨测试任务,正式交付用户单位中科院高能物理研究所使用。“慧眼卫星投入使用仪式”上,中国科学院、中国航天科技集团有限公司、航天系统部相关领导签署慧眼卫星投入使用证书;中科院高能物理研究所、国家空间科学中心,中国西安卫星测控中心、中国空间技术研究院相关领导签署...

数据分析软件安装指南v2.01(中文)

Insight-HXMT用户分析软件安装指南[v2.01]  [pdf]

注:以下操作主要针对bash shell用户,如果用户使用其他shell请对命令做相应修改,或者通过网站helpdesk获得技术支持

1. 只安装HXMT用户分析软件(推荐SLC,支持MAC,Ubuntu)

适用于单独安装HXMT用户分析软件,没有安装HEAsoft(Headas)或不与已安装HEAsoft同时使用的用户

(1)下载HXMT分析软件安装包 [download]
(2)解压
          gunzip hxmtsoftv2.01.tar.gz
          tar vxf hxmtsoftv2.01.tar
(3)安装
          cd hxmtsoftv2.01/BUILD_DIR/
          ./configure    (可用--prefix参数指定安装路径,本例中假定安装到/path/to/hxmtsoft/目录下)
          make
          make install

(4)安装本底模块

        详细步骤见第三节

(5)下载和安装CALDB [download]

       下载标定数据库文件并解压

          gunzip CALDB2.01.tar.gz
          tar vxf CALDB2.01.tar

       复制标定数据库到指定目录下(可以自己选择目录,建议复制到hxmtsoft安装后的目录下)

          cp -r  CALDB2.01  /path/to/store/caldb

(6)设置环境变量

      修改~/.bashrc文件,加入以下内容

         export HEADAS=/path/to/hxmtsoft/x86_64-pc-linux-gnu-libc2.12

         export CALDB=/path/to/store/caldb/CALDB2.01

         export CALDBCONFIG=$CALDB/caldb.config

         source $HEADAS/headas-init.sh (Bash shell)

    注意第一行的黑体部分,这段内容会根据不同的操作系统有所变化,修改应该以安装时实际生成的目录为准

 

提醒:这个安装只包括慧眼卫星的分析软件和少量的ftools,不包括Xspec、Xronos等在内的大部分HEAsoft工具。

 

2. 与HEAsoft同时安装

适用于同时安装HEAsoft软件包和HXMT数据分析软件。
(1) 下载HXMT分析软件安装包[download]并解压,解压后可以看到:

      ls -1

  • attitude
  • BUILD_DIR
  • CMakeLists.txt
  • demo
  • ftools
  • heacore
  • heagen
  • HEASOFT-INSTALL.TXT
  • heasptools
  • heatools
  • hxmt
  • Release_Notes_6.26
  • tcltk

(2) 按照正常流程下载HEAsoft安装包并解压,需要选择源码安装包;

      (下例中,解压后的安装包位于~/heasoft-6.26/下

(3) 将hxmt模块(从HXMT分析软件包中)拷贝到HEAsoft中

          cp –r hxmtsoftv2.01/hxmt  ~/heasoft-6.26/

(4) 修改配置文件

          cd ~/heasoft-6.26/BUILD_DIR
    将configure文件中的mpfit_required=no 修改为mpfit_required=yes

(5) 安装

          ./configure --with-components="heacore tcltk external attitude heasptools heatools heagen demo suzaku swift Xspec integral maxi nicer nustar hitomi xmm glast ftools GSSC heasim hxmt"
          make
          make install

注意:此处黑体部分选择的模块应该和下载hEAsoft安装包时选择的Mission一致。可以设定--prefix参数指定安装目录,本例中假定软件安装在/path/to/heasoft/目录下.

(6) 安装hxmt本底模块

         详细步骤见第三节

(7)安装标定数据库

        首先安装其他Mission的标定数据库。安装目录可以由用户指定。本例中假定标定数据库已经安装到/path/to/store/caldb/目录下。这时,该目录下应该包含data和software两个目录

        下载解压hxmt卫星的标定数据库 [download]

          gunzip CALDB2.01.tar.gz
          tar vxf CALDB2.01.tar

      复制标定数据库数据到data下

          cp -r  CALDB2.01/data/hxmt   /path/to/store/caldb/data/

      修改caldb.config文件

          cat CALDB2.01/caldb.config  >>/path/to/store/caldb/software/tools/caldb.config

(8)修改~/.bashrc文件,设置环境变量

          export HEADAS=/path/to/heasoft/x86_64-pc-linux-gnu-libc2.12

          export CALDB=/path/to/store/caldb/

          export CALDBCONFIG=$CALDB/software/tools/caldb.config

          source $HEADAS/headas-init.sh

     注意第一行的黑体部分,这段内容会根据不同的操作系统有所变化,修改应该以安装时实际生成的目录为准

 

注意:

    上述操作建议在全新下载的HEAsoft安装包的基础上进行,如果利用本机已经安装过的HEAsoft软件代码, 在进行操作时可能会出现编译错误. 

 

3,本底软件的安装和配置

    本底软件包括hebkgmap.py、mebkgmap.py、lebkgmap.py三个命令,分别用于HE、ME和LE望远镜的本底处理。本底软件需要单独复制安装。复制内容包括两部分:

  • 软件代码在hxmtsoftv2.01/hxmt/HXMTBKG/soft/ 下
  • 参数文件:hxmtsoftv2.01/hxmt/HXMTBKG/refdata/ 下

    安装时,需要在目标位置(通常选择hxmtsoft安装后的位置,本例中选择在/path/to/heasoft/hxmt/下,也可以自定义其他位置)新建目录,然后复制代码和参数文件到新建目录下。

      mkdir /path/to/heasoft/hxmt/bkgsoft

      cp  hxmtsoftv2.01/hxmt/HXMTBKG/soft/*  /path/to/heasoft/hxmt/bkgsoft

      cp  -r  hxmtsoftv2.01/hxmt/HXMTBKG/refdata  /path/to/heasoft/hxmt/bkgsoft

  修改~/.bashrc文件,加入

      export REFPATH="/path/to/heasoft/hxmt/bkgsoft/refdata/"

    这时本底软件可以通过完整路径调用,例如:

            python /path/to/heasoft/hxmt/bkgsoft/hebkgmap.py lc screen.FITS ehkfile.fits gtifile.fits deadtime.fits lcname 50 200 outname

    为了使用更加方便,也可以在~/.bashrc文件中建立alias链接,之后就可以直接使用无需输入完整路径:
      alias hebkgmap="python /path/to/heasoft/hxmt/bkgsoft/hebkgmap.py"
      alias mebkgmap="python /path/to/heasoft/hxmt/bkgsoft/mebkgmap.py"
      alias lebkgmap="python /path/to/heasoft/hxmt/bkgsoft/lebkgmap.py"

4,安装过程中遇到的问题及解决方法

      软件目前在多个操作系统中可成功安装和运行,包括Scientific Linux 6, Ubuntu 16.04, Ubuntu 18.04, macOS 10.14.x。安装过程中可能出现如下问题:

1) make进行编译过程中报错,报错信息为:
    readline/lib/libreadline.so: undefined reference to 'tputs'
    readline/lib/libreadline.so: undefined reference to 'tgoto'
    readline/lib/libreadline.so: undefined reference to 'tgetflag'
    readline/lib/libreadline.so: undefined reference to 'UP'
    readline/lib/libreadline.so: undefined reference to 'tgetent'
    readline/lib/libreadline.so: undefined reference to 'tgetnum'
    readline/lib/libreadline.so: undefined reference to 'PC'
    readline/lib/libreadline.so: undefined reference to 'tgetstr'

【解决方式】:
    这可能是所依赖的库和软件未预安装导致的,在系统上安装 libreadline6-dev, libncurses5-dev,然后重新运行make进行编译。
如在Ubuntu系统中执行(不同系统命令不同,使用对等的命令即可):
    sudo apt-get –y install libreadline6-dev
    sudo apt-get –y install libncurses5-dev
在SLC系统中则执行:
    sudo yum –y install ncurses-devel
    sudo yum –y install readline-devel

 

2. make进行编译过程中报错,报错信息为:
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atRotVect'
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atQuatToEuler'
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atInterpolateEuler'
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atNormVect'
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atEulerToQuat'
/home/user/heasoft-6.24_hxmtsoft/hxmt/BLD/x86_64-pc-linux-gnu-libc2.23-0/lib/libhxmtlib.so: undefined reference to 'atQuatToRM'

【解决方式】:
这是编译过程中未正确指定所需库导致的错误,在报错的编译指令后加入
–latFunction3.3,手动编译该指令,成功后再重新运行make即可。
如Ubuntu系统下,错误信息显示安装程序在路径/path/hxmt/hxmtscreen/下执行编译命令
    g++ -o hxmtscreen hxmtscreen.o ...... -lhxmtlib -lhxmtHElib -lhxmtMElib -lhxmtLElib -lhxmtHEmodule -lhxmtMEmodule -lhxmtLEmodule -lhxmttoolslib -lmpfit
时报错。所以进入报错路径:
    cd /path/hxmt/hxmtscreen/
加上-laFunction3.3重新编译:
    g++ -o hxmtscreen hxmtscreen.o ...... -lhxmtlib -lhxmtHElib -lhxmtMElib -lhxmtLElib -lhxmtHEmodule -lhxmtMEmodule -lhxmtLEmodule -lhxmttoolslib –lmpfit –laFunction3.3
运行成功(无任何信息,无报错)后,回到最初的安装目录~/heasoft-6.26/BUILD_DIR路径下重新运行make即可。

 

3. Ubuntu安装成功后,安装路径中有两个x86_64-pc-linux-gnu-libc2.23文件夹。一个为x86_64-pc-linux-gnu-libc2.23,一个为x86_64-pc-linux-gnu-libc2.23-0
【解决方式】:
将这两个文件夹合并即可,并删去冗余的文件夹:
$ rsync -av --progress x86_64-pc-linux-gnu-libc2.23-0/* x86_64-pc-linux-gnu-libc2.23/ --ignore-existing
$ rm –rf x86_64-pc-linux-gnu-libc2.23-0

 

4. Mac下动态库报错,"dyld not loaded":
MacOS系统下,成功执行make, make install无任何报错,但是运行hxmtsoft的命令,诸如hegtigen,出现错误信息:
dyld: Library not loaded: libhxmtHEmodule.dylib
Referenced from: /home/user/heasoft_hxmtsoft2/x86_64-apple-darwin17.7.0/bin/hegtigen
Reason: image not found
这是由于安装后程序无法找到HEADAS所需的动态库,可通过手动指定动态库的路径解决。

【解决方式】:
首先查看某一程序的动态库依赖(以hegtigen为例):
otool –LD $HEADAS/bin/hegtigen
显示结果为:
libhxmtHEmodule.dylib (compatibility version 0.0.0, current version 0.0.0)
libhxmtlib.dylib (compatibility version 0.0.0, current version 0.0.0)
libhxmtHElib.dylib (compatibility version 0.0.0, current version 0.0.0)
@rpath/libhdinit_2.7.dylib (compatibility version 0.0.0, current version 0.0.0)
......
其中三个动态库libhxmtHEmodule.dylib, libhxmtlib.dylib, libhxmtHElib.dylib未指定动态路径,故程序无法找到该库。我们指定这三个的路径:
install_name_tool -change libhxmtHEmodule.dylib $HEADAS/lib/libhxmtHEmodule.dylib $HEADAS/bin/hegtigen
install_name_tool -change libhxmtlib.dylib $HEADAS/lib/libhxmtlib.dylib $HEADAS/bin/hegtigen
install_name_tool -change libhxmtHElib.dylib $HEADAS/lib/libhxmtHElib.dylib $HEADAS/bin/hegtigen
并将$HEADAS/lib该路径加入动态路径:
install_name_tool -add_rpath "$HEADAS/lib" $HEADAS/bin/hegtigen