Spaces:
No application file
No application file
Update README.md
Browse filesreadme general structure, need to be edited and add real links
README.md
CHANGED
|
@@ -1,10 +1,58 @@
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
-
emoji:
|
| 4 |
colorFrom: green
|
| 5 |
colorTo: gray
|
| 6 |
sdk: static
|
| 7 |
-
pinned:
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
+
emoji: π¦
|
| 4 |
colorFrom: green
|
| 5 |
colorTo: gray
|
| 6 |
sdk: static
|
| 7 |
+
pinned: true
|
| 8 |
---
|
| 9 |
|
| 10 |
+
# Team 3 Project - Tone Evaluation
|
| 11 |
+
|
| 12 |
+
## Overview
|
| 13 |
+
|
| 14 |
+
Welcome to Team 3's Tone Evaluation project! This repository contains the necessary files and resources for our project, which focuses on data processing, training, testing, and a user interface (UI) demo.
|
| 15 |
+
|
| 16 |
+
## Project Structure
|
| 17 |
+
|
| 18 |
+
- **Data Processing File**: [data_processing.py](/path/to/data_processing.py)
|
| 19 |
+
- This script is responsible for processing the raw data and preparing it for training and testing.
|
| 20 |
+
- It takes input audio in wav format, and transfer audio into mel spectrum form and fundamental frequency form. These will be the two main features for the model to analyze.
|
| 21 |
+
- We convert the pinyin and tone into numerical lables by providing a text file and link each pinyin to a index.
|
| 22 |
+
|
| 23 |
+
- **Train File**: [train.py](/path/to/train.py)
|
| 24 |
+
- This file contains the code for training our tone evaluation model. We use CTC model for this task.
|
| 25 |
+
|
| 26 |
+
- **Test File**: [test.py](/path/to/test.py)
|
| 27 |
+
- Use this script to evaluate the performance of our trained model on test data.
|
| 28 |
+
- Currenty, we set the model to only accepct wav format audio, and after loading the audio, model will predict the tone sequence for the sentence.
|
| 29 |
+
|
| 30 |
+
- **UI Demo**: [ui_demo.py](/path/to/ui_demo.py)
|
| 31 |
+
- Explore the user interface demo to interact with the tone evaluation model.
|
| 32 |
+
- You can upload wav format audio to our UI and see the evaluation result. We also provided some audio files for you to directly use.
|
| 33 |
+
|
| 34 |
+
## Dataset
|
| 35 |
+
|
| 36 |
+
We provide two versions of the dataset:
|
| 37 |
+
|
| 38 |
+
- **Full Size Version**: Download from Kaggle
|
| 39 |
+
- **Small Size Zip Version**: Zip file, Download from [data_mini.txt](/path/to/dara_mini.zip)
|
| 40 |
+
|
| 41 |
+
Additionally, we offer a text file for Pinyin encoding: [pinyin_encoding.txt](/path/to/pinyin_encoding.txt). This file is crucial for understanding the encoding used in our dataset.
|
| 42 |
+
|
| 43 |
+
## Getting Started
|
| 44 |
+
|
| 45 |
+
Follow these steps to get started with our project:
|
| 46 |
+
|
| 47 |
+
1. Clone this repository to your local machine.
|
| 48 |
+
2. Run the data processing script: `python data_processing.py`
|
| 49 |
+
3. Train the model using: `python train.py`
|
| 50 |
+
4. Evaluate the model with: `python test.py`
|
| 51 |
+
5. Explore the UI demo: `python ui_demo.py`
|
| 52 |
+
|
| 53 |
+
## Additional Information
|
| 54 |
+
|
| 55 |
+
|
| 56 |
+
- If you encounter any issues or have questions, feel free to reach out to our team through the [Issues](/path/to/issues) section.
|
| 57 |
+
|
| 58 |
+
We hope you find our project useful and insightful! Happy coding!
|