# CEvNS

**Repository Path**: kong_l_q/cevns_ucas

## Basic Information

- **Project Name**: CEvNS
- **Description**: 中国科学院大学CEvNS项目组模拟框架
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-03-01
- **Last Updated**: 2025-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CEvNS-UCAS Simulation Framwork

## 介绍
UCAS CEvNS 项目 Simulation 软件框架

## 软件架构

Base on ROOT v6.24/06 and Geant4 v11.0.0

## 使用说明
安装
```bash
git clone https://gitee.com/kong_l_q/cevns_ucas.git
cd cevns_ucas
mkdir build
cd build
cmake ..
make
```


### Simulation:
1.  如何开始模拟：  
    ```bash
    cd build/source/1-Simulation
    ./nuHunter -[v] [Simucard.card]
    ```
    `-[v]`选择将开启可视化界面，`[Simucard.card]`将使用用户指定的.card文件作为模拟的输入。
2.  Simucard文件设置(示例请见Simucard.card):  
    `Simucard.card`文件指定软件将以何种形式模拟何种信号

    #### GDML文件设置：  
        DetectorGDML: DetectorConstruction.xml

    #### 输出文件设置：
        OutputFile: xxx.root
        OutputLevel: 1

    #### 模拟方式设置：   
        1. 使用内置能谱模拟：
        GenEvents: 产生指定事例数  
        
        2. 使用SimpleGun模拟，PGNonePointSource控制是否为点源入射：
        GunType:Simple  
        PGNonePointSource:false
        PGName: e+/e-/gamma/p+/n
        PGEnergy:(MeV)
        PGPos:x,y,z
        PGPol:s1,s2,s3
        PGMomDir:px,py,pz
        
        3. 使用mac文件模拟：
        GPSMacFile:xxx.mac

        3. 使用CDEX 的ExGPS mac文件模拟：
        ExGPSMacFile:xxx.mac

    #### 模拟信号选择：  
        PGType:信号名称
        PGParameters:信号参数，以`,`隔开  
        
        PGN:中子本底抽样

    #### ROOTInputParticle Mode:

    ### --> ROOT文件粒子抽样
    #PGType: ROOT
    #PGParameters: -t,MCData,-d,1000,/path/to/ROOTFile/test.root
    #GenEvents: 5

    PGType是粒子枪类型，打开就可以用，PGParameters包括两个参数，-t是root文件需要输入的tree名称，-d是矩形抽样粒子xy坐标的边长，
    最后一个是输入root文件路径
    默认读入数据包括粒子类型“PassID”，粒子能量“PassEng”，粒子动量方向“PassPX，PassPY，PassPZ”，粒子坐标“PassX，PassY”，粒子
    初始时间“TargetTime”和粒子坐标"PassZ"如果存在也会读入