yanjia0 commited on
Commit
62d1ae7
Β·
1 Parent(s): 9316650

Update README.md

Browse files

readme general structure, need to be edited and add real links

Files changed (1) hide show
  1. README.md +51 -3
README.md CHANGED
@@ -1,10 +1,58 @@
1
  ---
2
  title: README
3
- emoji: πŸƒ
4
  colorFrom: green
5
  colorTo: gray
6
  sdk: static
7
- pinned: false
8
  ---
9
 
10
- Edit this `README.md` markdown file to author your organization card.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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!