Add Detailed data description

DATA_DESCRIPTION.md

@@ -0,0 +1,216 @@
+# FRTSearch Data Description
+
+This document describes all model weights and test data files included in this repository.
+
+---
+
+## Model Weights
+
+### `models/hrnet_epoch_36.pth`
+- **Size**: 381.75 MB
+- **Architecture**: HRNet (High-Resolution Network)
+- **Training Epoch**: 36
+- **Purpose**: FRB detection and classification model trained on diverse FRB datasets
+- **Input Dimensions**: 256 (freq) × 8192 (time)
+- **Description**: This model has been trained on a wide range of observation parameters, enabling FRTSearch to handle both drift scan short-term observations and tracking long-term observation data processing.
+
+---
+
+## Test Data Files
+
+### FITS Format (FAST Telescope)
+
+PSRFITS format files from the Five-hundred-meter Aperture Spherical radio Telescope (FAST).
+
+#### 1. `test_sample/FRB20121102_0038.fits`
+- **Size**: 243.77 MB
+- **Telescope**: FAST
+- **Source**: FRB 20121102 (repeating FRB)
+- **Reference**: [Guo et al. (2025)](https://doi.org/10.3847/1538-4365/adf42d)
+- **Sampling Time**: 98.304 μs
+- **Frequency Range**: 1000-1500 MHz
+- **Channels**: 4096
+- **DM**: 565.0 pc cm⁻³
+- **ToA**: 2.39 s
+- **Bits**: 8-bit
+- **Description**: High time-resolution observation of the famous repeating FRB 20121102
+
+#### 2. `test_sample/FRB20180301_0004.fits`
+- **Size**: 487.52 MB
+- **Telescope**: FAST
+- **Source**: FRB 20180301
+- **Reference**: [Guo et al. (2025)](https://doi.org/10.3847/1538-4365/adf42d)
+- **Sampling Time**: 49.152 μs
+- **Frequency Range**: 1000-1500 MHz
+- **Channels**: 4096
+- **DM**: 420.0 pc cm⁻³
+- **ToA**: 2.83 s
+- **Bits**: 8-bit
+- **Description**: Ultra-high time-resolution FAST observation demonstrating FRTSearch's capability with fine temporal sampling
+
+#### 3. `test_sample/FRB20201124_0016.fits`
+- **Size**: 487.52 MB
+- **Telescope**: FAST
+- **Source**: FRB 20201124 (repeating FRB)
+- **Reference**: [Guo et al. (2025)](https://doi.org/10.3847/1538-4365/adf42d)
+- **Sampling Time**: 49.152 μs
+- **Frequency Range**: 1000-1500 MHz
+- **Channels**: 4096
+- **DM**: 525.0 pc cm⁻³
+- **ToA**: 2.44 s
+- **Bits**: 8-bit
+- **Description**: Another repeating FRB with ultra-high time-resolution, ideal for testing detection algorithms
+
+---
+
+### Filterbank Format (.fil)
+
+Standard filterbank format files from Parkes and SKA telescopes.
+
+#### 4. `test_sample/FRB110220_Parkes_190_240.fil`
+- **Size**: 190.74 MB
+- **Telescope**: Parkes
+- **Source**: FRB 110220
+- **Reference**: [Keane et al. (2015)](https://doi.org/10.1093/mnras/stu2650)
+- **Sampling Time**: 122.88 μs
+- **Frequency Range**: 190-240 MHz
+- **Channels**: 512
+- **DM**: 944.0 pc cm⁻³
+- **ToA**: 7.93 s
+- **Bits**: 2-bit
+- **Description**: Low-frequency observation from Parkes telescope, demonstrating FRTSearch's adaptability to different frequency ranges and bit depths
+
+#### 5. `test_sample/FRB20180119_SKA_1660_1710.fil`
+- **Size**: 12.65 MB
+- **Telescope**: SKA (Australian Square Kilometre Array Pathfinder)
+- **Source**: FRB 20180119
+- **Reference**: [Shannon et al. (2018)](https://doi.org/10.1038/s41586-018-0588-y)
+- **Sampling Time**: 1265.625 μs
+- **Frequency Range**: 1660-1710 MHz
+- **Channels**: 336
+- **DM**: 400.0 pc cm⁻³
+- **ToA**: 0.07 s
+- **Bits**: 1-bit
+- **Description**: SKA pathfinder observation with 1-bit quantization, testing FRTSearch on low-bitrate data
+
+#### 6. `test_sample/FRB20180212_SKA_1820_1870.fil`
+- **Size**: 12.65 MB
+- **Telescope**: SKA
+- **Source**: FRB 20180212
+- **Reference**: [Shannon et al. (2018)](https://doi.org/10.1038/s41586-018-0588-y)
+- **Sampling Time**: 1265.625 μs
+- **Frequency Range**: 1820-1870 MHz
+- **Channels**: 336
+- **DM**: 167.7 pc cm⁻³
+- **ToA**: 0.07 s
+- **Bits**: 1-bit
+- **Description**: Another SKA observation demonstrating consistency across different frequency sub-bands
+
+#### 7. `test_sample/FRB20220610A_SKA_1260_1303.fil`
+- **Size**: 47.35 MB
+- **Telescope**: SKA
+- **Source**: FRB 20220610A (host galaxy localized)
+- **Reference**: [Ryder et al. (2022)](https://doi.org/10.1126/science.adf2678)
+- **Sampling Time**: 1265.625 μs
+- **Frequency Range**: 1260-1303 MHz
+- **Channels**: 336
+- **DM**: 1457.6 pc cm⁻³
+- **ToA**: 0.39 s
+- **Bits**: 1-bit
+- **Description**: Observation of FRB 20220610A with precisely localized host galaxy, featuring high DM value
+
+---
+
+## Summary Statistics
+
+| **Category** | **Count** | **Total Size** | **Telescopes** | **Bit Depths** |
+|--------------|-----------|----------------|----------------|----------------|
+| Model Weights | 1 | 381.75 MB | N/A | N/A |
+| FITS Files | 3 | 1.22 GB | FAST | 8-bit |
+| Filterbank Files | 4 | 263.39 MB | Parkes, SKA | 1-bit, 2-bit |
+| **Total Data** | **7** | **~1.86 GB** | **3 telescopes** | **1, 2, 8-bit** |
+
+---
+
+## Telescope Coverage
+
+### FAST (Five-hundred-meter Aperture Spherical radio Telescope)
+- Location: Guizhou, China
+- Frequency Range: 1000-1500 MHz
+- Time Resolution: 49.152 - 98.304 μs
+- Channels: 4096
+- Bit Depth: 8-bit
+
+### Parkes
+- Location: New South Wales, Australia
+- Frequency Range: 190-240 MHz
+- Time Resolution: 122.88 μs
+- Channels: 512
+- Bit Depth: 2-bit
+
+### SKA (Square Kilometre Array Pathfinder / ASKAP)
+- Location: Western Australia
+- Frequency Range: 1260-1870 MHz
+- Time Resolution: 1265.625 μs
+- Channels: 336
+- Bit Depth: 1-bit
+
+---
+
+## Usage
+
+These test samples cover diverse observational parameters:
+- **Time Resolution**: 49.152 μs to 1265.625 μs (26× range)
+- **Frequency Coverage**: 190 MHz to 1870 MHz
+- **DM Range**: 167.7 to 1457.6 pc cm⁻³
+- **Bit Depths**: 1-bit, 2-bit, and 8-bit quantization
+
+This diversity allows comprehensive evaluation of FRTSearch's performance across different telescope specifications and observing modes.
+
+For detailed hyperparameter tuning guidelines for each telescope, see `test_sample/README.md`.
+
+---
+
+## Citations
+
+If you use these test samples, please cite the original publications:
+
+```bibtex
+@article{Guo2025,
+    title={FAST FRB Catalog},
+    author={Guo et al.},
+    journal={ApJS},
+    year={2025},
+    doi={10.3847/1538-4365/adf42d}
+}
+
+@article{Shannon2018,
+    title={The dispersion-brightness relation for fast radio bursts from a wide-field survey},
+    author={Shannon, R. M. and others},
+    journal={Nature},
+    volume={562},
+    pages={386--390},
+    year={2018},
+    doi={10.1038/s41586-018-0588-y}
+}
+
+@article{Keane2015,
+    title={The host galaxy of a fast radio burst},
+    author={Keane, E. F. and others},
+    journal={MNRAS},
+    volume={447},
+    pages={2852--2856},
+    year={2015},
+    doi={10.1093/mnras/stu2650}
+}
+
+@article{Ryder2022,
+    title={A luminous fast radio burst that probes the Universe at redshift 1},
+    author={Ryder, S. D. and others},
+    journal={Science},
+    volume={382},
+    pages={294--299},
+    year={2022},
+    doi={10.1126/science.adf2678}
+}
+```