waterfall109 commited on
Commit
c142db7
·
verified ·
1 Parent(s): 2c40c41

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +34 -56
README.md CHANGED
@@ -1,59 +1,46 @@
1
  ---
2
  license: gpl-2.0
3
- tags:
4
- - Radio Astronomy
5
- - Mask-RCNN
6
- - Pulsar
7
- - RRAT
8
- - FRB
9
- - Signal Processing
10
  library_name: pytorch
11
- pipeline_tag: image-segmentation
12
- datasets:
13
- - CRAFTS-FRT
14
- metrics:
15
- - recall
16
- - FPR
 
 
17
  ---
18
 
19
  # FRTSearch: Fast Radio Transient Search
20
 
21
- [![Paper](https://img.shields.io/badge/Paper-AASTeX-blue.svg)](https://doi.org/10.57760/sciencedb.Fastro.00038) [![Dataset](https://img.shields.io/badge/Dataset-CRAFTS--FRT-yellow.svg)](https://doi.org/10.57760/sciencedb.Fastro.00038) [![GitHub](https://img.shields.io/badge/GitHub-FRTSearch-black.svg)](https://github.com/BinZhang109/FRTSearch)
22
-
23
- **FRTSearch** is an end-to-end deep learning framework for detecting and characterizing Fast Radio Transients (FRTs), including: **Pulsars**, **Rotating Radio Transients (RRATs)** and **Fast Radio Bursts (FRBs)**.
24
 
25
- ## Model Info
26
 
27
- | Item | Value |
28
- |------|-------|
29
- | Backbone | HRNet-W32 |
30
- | Input | 256 × 8192 (freq × time) |
31
- | Size | 381.75 MB |
32
- | Formats | `.fits` (PSRFITS), `.fil` (Filterbank) |
33
- | Bit Depth | 1/2/4/8/32-bit |
34
 
35
- ## Quick Start
36
 
37
  ```python
38
- from huggingface_hub import hf_hub_download
 
39
 
40
- model_path = hf_hub_download(
41
- repo_id="waterfall109/FRTSearch",
42
- filename="models/hrnet_epoch_36.pth"
43
- )
44
  ```
45
 
46
- Or download directly from [Files and versions](https://huggingface.co/waterfall109/FRTSearch/tree/main).
47
-
48
-
49
- ## Test Samples
50
-
51
- This repository includes 5 test samples from 2 different telescopes to demonstrate cross-facility performance:
52
 
53
- | Telescope | FRB | DM (pc cm⁻³) |
54
- |-----------|-----|--------------|
55
- | FAST | 20121102, 20180301, 20201124 | 565, 420, 525 |
56
- | ASKAP | 20180119, 20180212 | 400, 168|
 
57
 
58
  ## Citation
59
 
@@ -61,25 +48,16 @@ This repository includes 5 test samples from 2 different telescopes to demonstra
61
  @article{zhang2026frtsearch,
62
  title={FRTSearch: Unified Detection and Parameter Inference of Fast Radio Transients using Instance Segmentation},
63
  author={Zhang, Bin and Wang, Yabiao and Xie, Xiaoyao et al.},
64
- year={2026}
65
  }
66
  ```
67
 
68
- ### Test Sample References
69
 
70
- When using the test samples, please also cite the original observations:
 
 
71
 
72
- - **FAST samples**: [Guo et al. (2025)](https://doi.org/10.3847/1538-4365/adf42d)
73
- - **SKA samples**: [Shannon et al. (2018)](https://doi.org/10.1038/s41586-018-0588-y)
74
-
75
- ## License & Acknowledgments
76
-
77
- GPL-2.0 | Based on [MMDetection](https://github.com/open-mmlab/mmdetection) & [PRESTO](https://github.com/scottransom/presto)
78
-
79
- ---
80
- <div align="center">
81
- <sub>🌌 Questions? <a href="https://github.com/BinZhang109/FRTSearch/issues">GitHub Issues</a></sub>
82
- </div>
83
- ```
84
 
85
- ---
 
1
  ---
2
  license: gpl-2.0
 
 
 
 
 
 
 
3
  library_name: pytorch
4
+ tags:
5
+ - pytorch
6
+ - mask-rcnn
7
+ - astronomy
8
+ - object-detection
9
+ - frb
10
+ - pulsar
11
+ pipeline_tag: object-detection
12
  ---
13
 
14
  # FRTSearch: Fast Radio Transient Search
15
 
16
+ **FRTSearch** is a deep learning model for detecting **Pulsars**, **RRATs**, and **Fast Radio Bursts (FRBs)** in radio astronomical observation data.
 
 
17
 
18
+ ## Model Details
19
 
20
+ - **Architecture**: Mask R-CNN with HRNet backbone
21
+ - **Framework**: PyTorch
22
+ - **Task**: Instance Segmentation / Object Detection
23
+ - **License**: GPL-2.0
 
 
 
24
 
25
+ ## Usage
26
 
27
  ```python
28
+ import torch
29
+ from mmdet.apis import init_detector
30
 
31
+ # Load model
32
+ config_file = 'configs/detector_FAST.py'
33
+ checkpoint_file = 'models/hrnet_epoch_36.pth'
34
+ model = init_detector(config_file, checkpoint_file, device='cuda:0')
35
  ```
36
 
37
+ ## Files
 
 
 
 
 
38
 
39
+ | File | Description |
40
+ |------|-------------|
41
+ | `models/hrnet_epoch_36.pth` | Model weights (Mask R-CNN with HRNet backbone) |
42
+ | `configs/detector_FAST.py` | Configuration for FAST telescope data |
43
+ | `configs/detector_SKA.py` | Configuration for SKA telescope data |
44
 
45
  ## Citation
46
 
 
48
  @article{zhang2026frtsearch,
49
  title={FRTSearch: Unified Detection and Parameter Inference of Fast Radio Transients using Instance Segmentation},
50
  author={Zhang, Bin and Wang, Yabiao and Xie, Xiaoyao et al.},
51
+ year={2026},
52
  }
53
  ```
54
 
55
+ ## Links
56
 
57
+ - **GitHub**: https://github.com/BinZhang109/FRTSearch
58
+ - **Paper**: https://doi.org/10.57760/sciencedb.Fastro.00038
59
+ - **Dataset**: [CRAFTS-FRT](https://doi.org/10.57760/sciencedb.Fastro.00038)
60
 
61
+ ## License
 
 
 
 
 
 
 
 
 
 
 
62
 
63
+ This model is licensed under GPL-2.0. See [LICENSE](LICENSE) for details.