Ced Tiny

🚀 CED-Tiny Model

CED are simple ViT-Transformer-based models for audio tagging, achieving state-of-the-art performance on Audioset.

📦 Model Information

📊 Model Performance

✨ Features

• Simplification for finetuning: Batchnormalization of Mel-Spectrograms. During finetuning one does not need to first compute mean/variance over the dataset, which is common for AST.
• Support for variable length inputs: Most other models use a static time-frequency position embedding, which hinders the model's generalization to segments shorter than 10s. Many previous transformers simply pad their input to 10s in order to avoid the performance impact, which in turn slows down training/inference drastically.
• Training/Inference speedup: 64-dimensional mel-filterbanks and 16x16 patches without overlap, leading to 248 patches from a 10s spectrogram. In comparison, AST uses 128 mel-filterbanks with 16x16 (10x10 overlap) convolution, leading to 1212 patches during training/inference. CED-Tiny runs on a common CPU as fast as a comparable MobileNetV3.
• Performance: CED with 10M parameters outperforms the majority of previous approaches (~80M).

📚 Model Sources

• Original Repository: https://github.com/RicherMans/CED
• Repository: https://github.com/jimbozhang/hf_transformers_custom_model_ced
• Paper: CED: Consistent ensemble distillation for audio tagging
• Demo: https://huggingface.co/spaces/mispeech/ced-base

📦 Installation

pip install git+https://github.com/jimbozhang/hf_transformers_custom_model_ced.git

💻 Usage Examples

Basic Usage

>>> from ced_model.feature_extraction_ced import CedFeatureExtractor
>>> from ced_model.modeling_ced import CedForAudioClassification

>>> model_name = "mispeech/ced-tiny"
>>> feature_extractor = CedFeatureExtractor.from_pretrained(model_name)
>>> model = CedForAudioClassification.from_pretrained(model_name)

>>> import torchaudio
>>> audio, sampling_rate = torchaudio.load("resources/JeD5V5aaaoI_931_932.wav")
>>> assert sampling_rate == 16000
>>> inputs = feature_extractor(audio, sampling_rate=sampling_rate, return_tensors="pt")

>>> import torch
>>> with torch.no_grad():
...     logits = model(**inputs).logits

>>> predicted_class_id = torch.argmax(logits, dim=-1).item()
>>> model.config.id2label[predicted_class_id]
'Finger snapping'

Advanced Usage

For fine-tuning, please refer to the example notebook: example_finetune_esc50.ipynb demonstrates how to train a linear head on the ESC-50 dataset with the CED encoder frozen.

📄 License

This project is licensed under the Apache-2.0 License.