CircosHeatmap-aardio/README_EN.md

78 lines
3.0 KiB
Markdown
Raw Permalink Normal View History

2025-01-13 21:25:56 +08:00
<p align="center">
<img src="./res/result.png" width="200" />
2025-01-13 21:25:56 +08:00
</p>
<h1 align="center">
<img src="./res/app.png" width="30" style="vertical-align: middle;" />
<span style="vertical-align: middle;">CircosHeatmap-aardio</span>
</h1>
<p align="center">
A Circular Heatmap Visualization Tool Based on R Language
</p>
<div align="center">
2025-01-13 21:33:04 +08:00
<a href="https://gitea.iioio.com:3000/BiomedEngX/CircosHeatmap-aardio">中文</a>
2025-01-13 21:25:56 +08:00
</div>
---
## 📃 Project Introduction
CircosHeatmap-aardio is a circular heatmap (Circos Heatmap) visualization tool based on R language. It supports clustering and visualization of matrix data. Through the Aardio graphical interface, users can easily use the tool without writing any code.
---
## ✨ Core Features
- **Circular Heatmap Visualization**: Based on R's `circlize` and `ComplexHeatmap` packages, it supports clustering and visualization of matrix data.
- **Graphical Interface**: Implemented with Aardio, allowing users to select input files, set parameters, and run scripts through the interface.
- **Code Visualization and Debugging**: Built-in R code editor for viewing and modifying the current R script.
- **Log Output**: Provides a log window to display script execution results and error messages.
---
## 🚀 Quick Start
### 1. Download and Extract
2025-01-13 21:33:04 +08:00
Download and extract CircosHeatmap-aardio from [Releases](https://gitea.iioio.com:3000/BiomedEngX/CircosHeatmap-aardio/releases).
2025-01-13 21:25:56 +08:00
### 2. Run the Program
Run `CircosHeatmap-aardio.exe`. The R environment will be automatically installed on the first run.
![demo](./res/demo.jpg)
### 3. Select Data Source
Click **"Data Source"** to select a csv file.
> **Note**: Currently, only csv format is supported. If your data is in other formats (e.g., xls, xlsx), convert it to csv before use.
### 4. Generate PDF
Click **"Generate PDF"** to select the save location.
---
## 🛠️ Program Details
### Interface Layout
- **R Code Editor**: Displays the current R script for viewing and modification.
- **Log Window**: Shows script execution results and error messages in real-time.
- **Data Source Selection**: Select input files via button (supports csv format).
- **Generate PDF**: Run the R script and save the generated circular heatmap as a PDF file.
### Code Logic
- **R Script Loading**: The default R script (`heatmap_script.R`) is loaded on program startup.
- **File Selection**: Click **"Data Source"** to select an input file, and the path is displayed in the input box.
- **Script Execution**: Click **"Generate PDF"** to execute the R script with the input file path and output PDF path.
---
## 📝 TODO
- **UI Improvements**: Enhance user interaction and experience.
- **Support More File Formats**: Extend support for xls, xlsx, etc.
- **Advanced Features**: Add features like custom color gradients and clustering parameter adjustments.
---
## ✨ Contributions
2025-01-13 21:33:04 +08:00
Contributions, suggestions, bug reports, and fixes are welcome! If you have any ideas or questions, please submit an [Issue](https://gitea.iioio.com:3000/BiomedEngX/CircosHeatmap-aardio/issues/new) or Pull Request.