diff --git a/Herta-Svc/G_10000.pth b/Herta-Svc/G_10000.pth new file mode 100644 index 0000000000000000000000000000000000000000..bf0c5948afb2e739c33f7d9c5e208705c3649065 --- /dev/null +++ b/Herta-Svc/G_10000.pth @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:74541f2e9edd79d9b0513e62c6b02ff11b30b3e990c60c60d2771f7bfa88dc2d +size 542789469 diff --git a/Herta-Svc/config.json b/Herta-Svc/config.json new file mode 100644 index 0000000000000000000000000000000000000000..8022adbf1007af8e0234dffa5825779843394c05 --- /dev/null +++ b/Herta-Svc/config.json @@ -0,0 +1,98 @@ +{ + "train": { + "log_interval": 200, + "eval_interval": 800, + "seed": 1234, + "epochs": 10000, + "learning_rate": 0.0001, + "betas": [ + 0.8, + 0.99 + ], + "eps": 1e-09, + "batch_size": 16, + "fp16_run": false, + "bf16_run": false, + "lr_decay": 0.999875, + "segment_size": 10240, + "init_lr_ratio": 1, + "warmup_epochs": 0, + "c_mel": 45, + "c_kl": 1.0, + "use_sr": true, + "max_speclen": 512, + "port": "8001", + "keep_ckpts": 3, + "num_workers": 4, + "log_version": 0, + "ckpt_name_by_step": false, + "accumulate_grad_batches": 1 + }, + "data": { + "training_files": "filelists/44k/train.txt", + "validation_files": "filelists/44k/val.txt", + "max_wav_value": 32768.0, + "sampling_rate": 44100, + "filter_length": 2048, + "hop_length": 512, + "win_length": 2048, + "n_mel_channels": 80, + "mel_fmin": 0.0, + "mel_fmax": 22050 + }, + "model": { + "inter_channels": 192, + "hidden_channels": 192, + "filter_channels": 768, + "n_heads": 2, + "n_layers": 6, + "kernel_size": 3, + "p_dropout": 0.1, + "resblock": "1", + "resblock_kernel_sizes": [ + 3, + 7, + 11 + ], + "resblock_dilation_sizes": [ + [ + 1, + 3, + 5 + ], + [ + 1, + 3, + 5 + ], + [ + 1, + 3, + 5 + ] + ], + "upsample_rates": [ + 8, + 8, + 2, + 2, + 2 + ], + "upsample_initial_channel": 512, + "upsample_kernel_sizes": [ + 16, + 16, + 4, + 4, + 4 + ], + "n_layers_q": 3, + "use_spectral_norm": false, + "gin_channels": 256, + "ssl_dim": 256, + "n_speakers": 200 + }, + "spk": { + "speaker0": 0 + } +} \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000000000000000000000000000000000..28bac26685278dcadb12f316bf4664395345c4f8 --- /dev/null +++ b/LICENSE @@ -0,0 +1,28 @@ +BSD 3-Clause License + +Copyright (c) 2023, SVC Develop Team + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/app.py b/app.py new file mode 100644 index 0000000000000000000000000000000000000000..3a59678269d6b802273291cffba3215f001951bb --- /dev/null +++ b/app.py @@ -0,0 +1,53 @@ +import streamlit as st +import edge_tts +import asyncio +import librosa +import soundfile +import io + + +from inference.infer_tool import Svc + +audio_bytes = None + +def get_or_create_eventloop(): + try: + return asyncio.get_event_loop() + except RuntimeError as ex: + if "There is no current event loop in thread" in str(ex): + loop = asyncio.new_event_loop() + asyncio.set_event_loop(loop) + return asyncio.get_event_loop() + +def tts_get_voices_list(): + voices = [] + tts_voice_list = asyncio.get_event_loop().run_until_complete(edge_tts.list_voices()) + for item in tts_voice_list: + voices.append(item['ShortName']) + + return voices + +loop = asyncio.new_event_loop() +asyncio.set_event_loop(loop) + +with st.form(key = 'tts', clear_on_submit=False): + txt = st.text_input('your text message (your text message should be < 100 characters)', max_chars = 100) + voice = str(st.selectbox('voices', tts_get_voices_list())) + summitted = st.form_submit_button('Summit') + + if summitted: + tts = asyncio.run(edge_tts.Communicate(txt, voice).save('temp\\test.mp3')) + audio, sr = librosa.load('temp\\test.mp3', sr=16000, mono=True) + raw_path = io.BytesIO() + soundfile.write(raw_path, audio, 16000, format="wav") + raw_path.seek(0) + model = Svc(fr"Herta-Svc/G_10000.pth", f"Herta-Svc/config.json", device = 'cpu') + out_audio, out_sr = model.infer('speaker0', 0, raw_path, auto_predict_f0 = True,) + soundfile.write('temp\\xxx.wav', out_audio.cpu().numpy(), 44100) + audio_file = open('temp\\xxx.wav', 'rb') + audio_bytes = audio_file.read() + st.audio(audio_bytes, format = 'audio/wav') + + + + diff --git a/cluster/__init__.py b/cluster/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..f1b9bde04e73e9218a5d534227caa4c25332f424 --- /dev/null +++ b/cluster/__init__.py @@ -0,0 +1,29 @@ +import numpy as np +import torch +from sklearn.cluster import KMeans + +def get_cluster_model(ckpt_path): + checkpoint = torch.load(ckpt_path) + kmeans_dict = {} + for spk, ckpt in checkpoint.items(): + km = KMeans(ckpt["n_features_in_"]) + km.__dict__["n_features_in_"] = ckpt["n_features_in_"] + km.__dict__["_n_threads"] = ckpt["_n_threads"] + km.__dict__["cluster_centers_"] = ckpt["cluster_centers_"] + kmeans_dict[spk] = km + return kmeans_dict + +def get_cluster_result(model, x, speaker): + """ + x: np.array [t, 256] + return cluster class result + """ + return model[speaker].predict(x) + +def get_cluster_center_result(model, x,speaker): + """x: np.array [t, 256]""" + predict = model[speaker].predict(x) + return model[speaker].cluster_centers_[predict] + +def get_center(model, x,speaker): + return model[speaker].cluster_centers_[x] diff --git a/cluster/train_cluster.py b/cluster/train_cluster.py new file mode 100644 index 0000000000000000000000000000000000000000..4ac025d400414226e66849407f477ae786c3d5d3 --- /dev/null +++ b/cluster/train_cluster.py @@ -0,0 +1,89 @@ +import os +from glob import glob +from pathlib import Path +import torch +import logging +import argparse +import torch +import numpy as np +from sklearn.cluster import KMeans, MiniBatchKMeans +import tqdm +logging.basicConfig(level=logging.INFO) +logger = logging.getLogger(__name__) +import time +import random + +def train_cluster(in_dir, n_clusters, use_minibatch=True, verbose=False): + + logger.info(f"Loading features from {in_dir}") + features = [] + nums = 0 + for path in tqdm.tqdm(in_dir.glob("*.soft.pt")): + features.append(torch.load(path).squeeze(0).numpy().T) + # print(features[-1].shape) + features = np.concatenate(features, axis=0) + print(nums, features.nbytes/ 1024**2, "MB , shape:",features.shape, features.dtype) + features = features.astype(np.float32) + logger.info(f"Clustering features of shape: {features.shape}") + t = time.time() + if use_minibatch: + kmeans = MiniBatchKMeans(n_clusters=n_clusters,verbose=verbose, batch_size=4096, max_iter=80).fit(features) + else: + kmeans = KMeans(n_clusters=n_clusters,verbose=verbose).fit(features) + print(time.time()-t, "s") + + x = { + "n_features_in_": kmeans.n_features_in_, + "_n_threads": kmeans._n_threads, + "cluster_centers_": kmeans.cluster_centers_, + } + print("end") + + return x + + +if __name__ == "__main__": + + parser = argparse.ArgumentParser() + parser.add_argument('--dataset', type=Path, default="./dataset/44k", + help='path of training data directory') + parser.add_argument('--output', type=Path, default="logs/44k", + help='path of model output directory') + + args = parser.parse_args() + + checkpoint_dir = args.output + dataset = args.dataset + n_clusters = 10000 + + ckpt = {} + for spk in os.listdir(dataset): + if os.path.isdir(dataset/spk): + print(f"train kmeans for {spk}...") + in_dir = dataset/spk + x = train_cluster(in_dir, n_clusters, verbose=False) + ckpt[spk] = x + + checkpoint_path = checkpoint_dir / f"kmeans_{n_clusters}.pt" + checkpoint_path.parent.mkdir(exist_ok=True, parents=True) + torch.save( + ckpt, + checkpoint_path, + ) + + + # import cluster + # for spk in tqdm.tqdm(os.listdir("dataset")): + # if os.path.isdir(f"dataset/{spk}"): + # print(f"start kmeans inference for {spk}...") + # for feature_path in tqdm.tqdm(glob(f"dataset/{spk}/*.discrete.npy", recursive=True)): + # mel_path = feature_path.replace(".discrete.npy",".mel.npy") + # mel_spectrogram = np.load(mel_path) + # feature_len = mel_spectrogram.shape[-1] + # c = np.load(feature_path) + # c = utils.tools.repeat_expand_2d(torch.FloatTensor(c), feature_len).numpy() + # feature = c.T + # feature_class = cluster.get_cluster_result(feature, spk) + # np.save(feature_path.replace(".discrete.npy", ".discrete_class.npy"), feature_class) + + diff --git a/configs_template/config_template.json b/configs_template/config_template.json new file mode 100644 index 0000000000000000000000000000000000000000..a6555caef49bcb5159ec615adaff41120c93594d --- /dev/null +++ b/configs_template/config_template.json @@ -0,0 +1,66 @@ +{ + "train": { + "log_interval": 200, + "eval_interval": 800, + "seed": 1234, + "epochs": 10000, + "learning_rate": 0.0001, + "betas": [ + 0.8, + 0.99 + ], + "eps": 1e-09, + "batch_size": 6, + "fp16_run": false, + "lr_decay": 0.999875, + "segment_size": 10240, + "init_lr_ratio": 1, + "warmup_epochs": 0, + "c_mel": 45, + "c_kl": 1.0, + "use_sr": true, + "max_speclen": 512, + "port": "8001", + "keep_ckpts": 3, + "all_in_mem": false + }, + "data": { + "training_files": "filelists/train.txt", + "validation_files": "filelists/val.txt", + "max_wav_value": 32768.0, + "sampling_rate": 44100, + "filter_length": 2048, + "hop_length": 512, + "win_length": 2048, + "n_mel_channels": 80, + "mel_fmin": 0.0, + "mel_fmax": 22050 + }, + "model": { + "inter_channels": 192, + "hidden_channels": 192, + "filter_channels": 768, + "n_heads": 2, + "n_layers": 6, + "kernel_size": 3, + "p_dropout": 0.1, + "resblock": "1", + "resblock_kernel_sizes": [3,7,11], + "resblock_dilation_sizes": [[1,3,5], [1,3,5], [1,3,5]], + "upsample_rates": [ 8, 8, 2, 2, 2], + "upsample_initial_channel": 512, + "upsample_kernel_sizes": [16,16, 4, 4, 4], + "n_layers_q": 3, + "use_spectral_norm": false, + "gin_channels": 256, + "ssl_dim": 256, + "n_speakers": 200 + }, + "spk": { + "nyaru": 0, + "huiyu": 1, + "nen": 2, + "paimon": 3, + "yunhao": 4 + } +} \ No newline at end of file diff --git a/data_utils.py b/data_utils.py new file mode 100644 index 0000000000000000000000000000000000000000..7c76fd1c3a45b8304d916161718c7763874f3e35 --- /dev/null +++ b/data_utils.py @@ -0,0 +1,155 @@ +import time +import os +import random +import numpy as np +import torch +import torch.utils.data + +import modules.commons as commons +import utils +from modules.mel_processing import spectrogram_torch, spec_to_mel_torch +from utils import load_wav_to_torch, load_filepaths_and_text + +# import h5py + + +"""Multi speaker version""" + + +class TextAudioSpeakerLoader(torch.utils.data.Dataset): + """ + 1) loads audio, speaker_id, text pairs + 2) normalizes text and converts them to sequences of integers + 3) computes spectrograms from audio files. + """ + + def __init__(self, audiopaths, hparams, all_in_mem: bool = False): + self.audiopaths = load_filepaths_and_text(audiopaths) + self.max_wav_value = hparams.data.max_wav_value + self.sampling_rate = hparams.data.sampling_rate + self.filter_length = hparams.data.filter_length + self.hop_length = hparams.data.hop_length + self.win_length = hparams.data.win_length + self.sampling_rate = hparams.data.sampling_rate + self.use_sr = hparams.train.use_sr + self.spec_len = hparams.train.max_speclen + self.spk_map = hparams.spk + + random.seed(1234) + random.shuffle(self.audiopaths) + + self.all_in_mem = all_in_mem + if self.all_in_mem: + self.cache = [self.get_audio(p[0]) for p in self.audiopaths] + + def get_audio(self, filename): + filename = filename.replace("\\", "/") + audio, sampling_rate = load_wav_to_torch(filename) + if sampling_rate != self.sampling_rate: + raise ValueError("{} SR doesn't match target {} SR".format( + sampling_rate, self.sampling_rate)) + audio_norm = audio / self.max_wav_value + audio_norm = audio_norm.unsqueeze(0) + spec_filename = filename.replace(".wav", ".spec.pt") + + # Ideally, all data generated after Mar 25 should have .spec.pt + if os.path.exists(spec_filename): + spec = torch.load(spec_filename) + else: + spec = spectrogram_torch(audio_norm, self.filter_length, + self.sampling_rate, self.hop_length, self.win_length, + center=False) + spec = torch.squeeze(spec, 0) + torch.save(spec, spec_filename) + + spk = filename.split("/")[-2] + spk = torch.LongTensor([self.spk_map[spk]]) + + f0 = np.load(filename + ".f0.npy") + f0, uv = utils.interpolate_f0(f0) + f0 = torch.FloatTensor(f0) + uv = torch.FloatTensor(uv) + + c = torch.load(filename+ ".soft.pt") + c = utils.repeat_expand_2d(c.squeeze(0), f0.shape[0]) + + + lmin = min(c.size(-1), spec.size(-1)) + assert abs(c.size(-1) - spec.size(-1)) < 3, (c.size(-1), spec.size(-1), f0.shape, filename) + assert abs(audio_norm.shape[1]-lmin * self.hop_length) < 3 * self.hop_length + spec, c, f0, uv = spec[:, :lmin], c[:, :lmin], f0[:lmin], uv[:lmin] + audio_norm = audio_norm[:, :lmin * self.hop_length] + + return c, f0, spec, audio_norm, spk, uv + + def random_slice(self, c, f0, spec, audio_norm, spk, uv): + # if spec.shape[1] < 30: + # print("skip too short audio:", filename) + # return None + if spec.shape[1] > 800: + start = random.randint(0, spec.shape[1]-800) + end = start + 790 + spec, c, f0, uv = spec[:, start:end], c[:, start:end], f0[start:end], uv[start:end] + audio_norm = audio_norm[:, start * self.hop_length : end * self.hop_length] + + return c, f0, spec, audio_norm, spk, uv + + def __getitem__(self, index): + if self.all_in_mem: + return self.random_slice(*self.cache[index]) + else: + return self.random_slice(*self.get_audio(self.audiopaths[index][0])) + + def __len__(self): + return len(self.audiopaths) + + +class TextAudioCollate: + + def __call__(self, batch): + batch = [b for b in batch if b is not None] + + input_lengths, ids_sorted_decreasing = torch.sort( + torch.LongTensor([x[0].shape[1] for x in batch]), + dim=0, descending=True) + + max_c_len = max([x[0].size(1) for x in batch]) + max_wav_len = max([x[3].size(1) for x in batch]) + + lengths = torch.LongTensor(len(batch)) + + c_padded = torch.FloatTensor(len(batch), batch[0][0].shape[0], max_c_len) + f0_padded = torch.FloatTensor(len(batch), max_c_len) + spec_padded = torch.FloatTensor(len(batch), batch[0][2].shape[0], max_c_len) + wav_padded = torch.FloatTensor(len(batch), 1, max_wav_len) + spkids = torch.LongTensor(len(batch), 1) + uv_padded = torch.FloatTensor(len(batch), max_c_len) + + c_padded.zero_() + spec_padded.zero_() + f0_padded.zero_() + wav_padded.zero_() + uv_padded.zero_() + + for i in range(len(ids_sorted_decreasing)): + row = batch[ids_sorted_decreasing[i]] + + c = row[0] + c_padded[i, :, :c.size(1)] = c + lengths[i] = c.size(1) + + f0 = row[1] + f0_padded[i, :f0.size(0)] = f0 + + spec = row[2] + spec_padded[i, :, :spec.size(1)] = spec + + wav = row[3] + wav_padded[i, :, :wav.size(1)] = wav + + spkids[i, 0] = row[4] + + uv = row[5] + uv_padded[i, :uv.size(0)] = uv + + return c_padded, f0_padded, spec_padded, wav_padded, spkids, lengths, uv_padded diff --git a/demo.py b/demo.py new file mode 100644 index 0000000000000000000000000000000000000000..617eadac96c56c4517ddd69bb1b71d44c9629148 --- /dev/null +++ b/demo.py @@ -0,0 +1,30 @@ +import edge_tts +import asyncio +import librosa +import soundfile +import io + +from inference.infer_tool import Svc + +TEXT = "私はヘルタ。今は忙しいから、リモート人形のオート返答機能に任せる。こんにちは、こんにちは、ごきげんよう、良い日になりますように。それじゃ" +VOICE = "ja-JP-NanamiNeural" +OUTPUT_FILE = "test.mp3" + +asyncio.run(edge_tts.Communicate(TEXT, VOICE).save(OUTPUT_FILE)) +audio, sr = librosa.load(OUTPUT_FILE, sr=16000, mono=True) +raw_path = io.BytesIO() +soundfile.write(raw_path, audio, 16000, format="wav") +raw_path.seek(0) +print('checkpoint 1') + +model = Svc(fr"Herta-Svc/G_10000.pth", f"Herta-Svc/config.json", device = 'cpu') +print('checkpoint 2') + +out_audio, out_sr = model.infer('speaker0', 0, raw_path, + auto_predict_f0 = True, + ) +print('checkpoint 3') + +soundfile.write('out_audio.wav', out_audio.cpu().numpy(), 44100) + +print("done") \ No newline at end of file diff --git a/flask_api.py b/flask_api.py new file mode 100644 index 0000000000000000000000000000000000000000..dff87134620d6ec00e6c8950ccf6313946216af8 --- /dev/null +++ b/flask_api.py @@ -0,0 +1,62 @@ +import io +import logging + +import soundfile +import torch +import torchaudio +from flask import Flask, request, send_file +from flask_cors import CORS + +from inference.infer_tool import Svc, RealTimeVC + +app = Flask(__name__) + +CORS(app) + +logging.getLogger('numba').setLevel(logging.WARNING) + + +@app.route("/voiceChangeModel", methods=["POST"]) +def voice_change_model(): + request_form = request.form + wave_file = request.files.get("sample", None) + # pitch changing information + f_pitch_change = float(request_form.get("fPitchChange", 0)) + # DAW required sampling rate + daw_sample = int(float(request_form.get("sampleRate", 0))) + speaker_id = int(float(request_form.get("sSpeakId", 0))) + # get wav from http and convert + input_wav_path = io.BytesIO(wave_file.read()) + + # inference + if raw_infer: + # out_audio, out_sr = svc_model.infer(speaker_id, f_pitch_change, input_wav_path) + out_audio, out_sr = svc_model.infer(speaker_id, f_pitch_change, input_wav_path, cluster_infer_ratio=0, + auto_predict_f0=False, noice_scale=0.4, f0_filter=False) + tar_audio = torchaudio.functional.resample(out_audio, svc_model.target_sample, daw_sample) + else: + out_audio = svc.process(svc_model, speaker_id, f_pitch_change, input_wav_path, cluster_infer_ratio=0, + auto_predict_f0=False, noice_scale=0.4, f0_filter=False) + tar_audio = torchaudio.functional.resample(torch.from_numpy(out_audio), svc_model.target_sample, daw_sample) + # return + out_wav_path = io.BytesIO() + soundfile.write(out_wav_path, tar_audio.cpu().numpy(), daw_sample, format="wav") + out_wav_path.seek(0) + return send_file(out_wav_path, download_name="temp.wav", as_attachment=True) + + +if __name__ == '__main__': + # True means splice directly. There may be explosive sounds at the splice. + # False means use cross fade. There may be slight overlapping sounds at the splice. + # Using 0.3-0.5s in VST plugin can reduce latency. + # You can adjust the maximum slicing time of VST plugin to 1 second and set it to ture here to get a stable sound quality and a relatively large delay。 + # Choose an acceptable method on your own. + raw_infer = True + # each model and config are corresponding + model_name = "logs/32k/G_174000-Copy1.pth" + config_name = "configs/config.json" + cluster_model_path = "logs/44k/kmeans_10000.pt" + svc_model = Svc(model_name, config_name, cluster_model_path=cluster_model_path) + svc = RealTimeVC() + # corresponding to the vst plugin here + app.run(port=6842, host="0.0.0.0", debug=False, threaded=False) diff --git a/flask_api_full_song.py b/flask_api_full_song.py new file mode 100644 index 0000000000000000000000000000000000000000..901cdd064acc5c18a6e353c7ce390c0d39e850ac --- /dev/null +++ b/flask_api_full_song.py @@ -0,0 +1,55 @@ +import io +import numpy as np +import soundfile +from flask import Flask, request, send_file + +from inference import infer_tool +from inference import slicer + +app = Flask(__name__) + + +@app.route("/wav2wav", methods=["POST"]) +def wav2wav(): + request_form = request.form + audio_path = request_form.get("audio_path", None) # wav path + tran = int(float(request_form.get("tran", 0))) # tone + spk = request_form.get("spk", 0) # speaker(id or name) + wav_format = request_form.get("wav_format", 'wav') + infer_tool.format_wav(audio_path) + chunks = slicer.cut(audio_path, db_thresh=-40) + audio_data, audio_sr = slicer.chunks2audio(audio_path, chunks) + + audio = [] + for (slice_tag, data) in audio_data: + print(f'#=====segment start, {round(len(data) / audio_sr, 3)}s======') + + length = int(np.ceil(len(data) / audio_sr * svc_model.target_sample)) + if slice_tag: + print('jump empty segment') + _audio = np.zeros(length) + else: + # padd + pad_len = int(audio_sr * 0.5) + data = np.concatenate([np.zeros([pad_len]), data, np.zeros([pad_len])]) + raw_path = io.BytesIO() + soundfile.write(raw_path, data, audio_sr, format="wav") + raw_path.seek(0) + out_audio, out_sr = svc_model.infer(spk, tran, raw_path) + svc_model.clear_empty() + _audio = out_audio.cpu().numpy() + pad_len = int(svc_model.target_sample * 0.5) + _audio = _audio[pad_len:-pad_len] + + audio.extend(list(infer_tool.pad_array(_audio, length))) + out_wav_path = io.BytesIO() + soundfile.write(out_wav_path, audio, svc_model.target_sample, format=wav_format) + out_wav_path.seek(0) + return send_file(out_wav_path, download_name=f"temp.{wav_format}", as_attachment=True) + + +if __name__ == '__main__': + model_name = "logs/44k/G_60000.pth" + config_name = "configs/config.json" + svc_model = infer_tool.Svc(model_name, config_name) + app.run(port=1145, host="0.0.0.0", debug=False, threaded=False) diff --git a/hubert/__init__.py b/hubert/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/hubert/hubert_model.py b/hubert/hubert_model.py new file mode 100644 index 0000000000000000000000000000000000000000..7fb642d89b07ca60792debab18e3454f52d8f357 --- /dev/null +++ b/hubert/hubert_model.py @@ -0,0 +1,222 @@ +import copy +import random +from typing import Optional, Tuple + +import torch +import torch.nn as nn +import torch.nn.functional as t_func +from torch.nn.modules.utils import consume_prefix_in_state_dict_if_present + + +class Hubert(nn.Module): + def __init__(self, num_label_embeddings: int = 100, mask: bool = True): + super().__init__() + self._mask = mask + self.feature_extractor = FeatureExtractor() + self.feature_projection = FeatureProjection() + self.positional_embedding = PositionalConvEmbedding() + self.norm = nn.LayerNorm(768) + self.dropout = nn.Dropout(0.1) + self.encoder = TransformerEncoder( + nn.TransformerEncoderLayer( + 768, 12, 3072, activation="gelu", batch_first=True + ), + 12, + ) + self.proj = nn.Linear(768, 256) + + self.masked_spec_embed = nn.Parameter(torch.FloatTensor(768).uniform_()) + self.label_embedding = nn.Embedding(num_label_embeddings, 256) + + def mask(self, x: torch.Tensor) -> Tuple[torch.Tensor, torch.Tensor]: + mask = None + if self.training and self._mask: + mask = _compute_mask((x.size(0), x.size(1)), 0.8, 10, x.device, 2) + x[mask] = self.masked_spec_embed.to(x.dtype) + return x, mask + + def encode( + self, x: torch.Tensor, layer: Optional[int] = None + ) -> Tuple[torch.Tensor, torch.Tensor]: + x = self.feature_extractor(x) + x = self.feature_projection(x.transpose(1, 2)) + x, mask = self.mask(x) + x = x + self.positional_embedding(x) + x = self.dropout(self.norm(x)) + x = self.encoder(x, output_layer=layer) + return x, mask + + def logits(self, x: torch.Tensor) -> torch.Tensor: + logits = torch.cosine_similarity( + x.unsqueeze(2), + self.label_embedding.weight.unsqueeze(0).unsqueeze(0), + dim=-1, + ) + return logits / 0.1 + + def forward(self, x: torch.Tensor) -> Tuple[torch.Tensor, torch.Tensor]: + x, mask = self.encode(x) + x = self.proj(x) + logits = self.logits(x) + return logits, mask + + +class HubertSoft(Hubert): + def __init__(self): + super().__init__() + + @torch.inference_mode() + def units(self, wav: torch.Tensor) -> torch.Tensor: + wav = t_func.pad(wav, ((400 - 320) // 2, (400 - 320) // 2)) + x, _ = self.encode(wav) + return self.proj(x) + + +class FeatureExtractor(nn.Module): + def __init__(self): + super().__init__() + self.conv0 = nn.Conv1d(1, 512, 10, 5, bias=False) + self.norm0 = nn.GroupNorm(512, 512) + self.conv1 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv2 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv3 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv4 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv5 = nn.Conv1d(512, 512, 2, 2, bias=False) + self.conv6 = nn.Conv1d(512, 512, 2, 2, bias=False) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = t_func.gelu(self.norm0(self.conv0(x))) + x = t_func.gelu(self.conv1(x)) + x = t_func.gelu(self.conv2(x)) + x = t_func.gelu(self.conv3(x)) + x = t_func.gelu(self.conv4(x)) + x = t_func.gelu(self.conv5(x)) + x = t_func.gelu(self.conv6(x)) + return x + + +class FeatureProjection(nn.Module): + def __init__(self): + super().__init__() + self.norm = nn.LayerNorm(512) + self.projection = nn.Linear(512, 768) + self.dropout = nn.Dropout(0.1) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = self.norm(x) + x = self.projection(x) + x = self.dropout(x) + return x + + +class PositionalConvEmbedding(nn.Module): + def __init__(self): + super().__init__() + self.conv = nn.Conv1d( + 768, + 768, + kernel_size=128, + padding=128 // 2, + groups=16, + ) + self.conv = nn.utils.weight_norm(self.conv, name="weight", dim=2) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = self.conv(x.transpose(1, 2)) + x = t_func.gelu(x[:, :, :-1]) + return x.transpose(1, 2) + + +class TransformerEncoder(nn.Module): + def __init__( + self, encoder_layer: nn.TransformerEncoderLayer, num_layers: int + ) -> None: + super(TransformerEncoder, self).__init__() + self.layers = nn.ModuleList( + [copy.deepcopy(encoder_layer) for _ in range(num_layers)] + ) + self.num_layers = num_layers + + def forward( + self, + src: torch.Tensor, + mask: torch.Tensor = None, + src_key_padding_mask: torch.Tensor = None, + output_layer: Optional[int] = None, + ) -> torch.Tensor: + output = src + for layer in self.layers[:output_layer]: + output = layer( + output, src_mask=mask, src_key_padding_mask=src_key_padding_mask + ) + return output + + +def _compute_mask( + shape: Tuple[int, int], + mask_prob: float, + mask_length: int, + device: torch.device, + min_masks: int = 0, +) -> torch.Tensor: + batch_size, sequence_length = shape + + if mask_length < 1: + raise ValueError("`mask_length` has to be bigger than 0.") + + if mask_length > sequence_length: + raise ValueError( + f"`mask_length` has to be smaller than `sequence_length`, but got `mask_length`: {mask_length} and `sequence_length`: {sequence_length}`" + ) + + # compute number of masked spans in batch + num_masked_spans = int(mask_prob * sequence_length / mask_length + random.random()) + num_masked_spans = max(num_masked_spans, min_masks) + + # make sure num masked indices <= sequence_length + if num_masked_spans * mask_length > sequence_length: + num_masked_spans = sequence_length // mask_length + + # SpecAugment mask to fill + mask = torch.zeros((batch_size, sequence_length), device=device, dtype=torch.bool) + + # uniform distribution to sample from, make sure that offset samples are < sequence_length + uniform_dist = torch.ones( + (batch_size, sequence_length - (mask_length - 1)), device=device + ) + + # get random indices to mask + mask_indices = torch.multinomial(uniform_dist, num_masked_spans) + + # expand masked indices to masked spans + mask_indices = ( + mask_indices.unsqueeze(dim=-1) + .expand((batch_size, num_masked_spans, mask_length)) + .reshape(batch_size, num_masked_spans * mask_length) + ) + offsets = ( + torch.arange(mask_length, device=device)[None, None, :] + .expand((batch_size, num_masked_spans, mask_length)) + .reshape(batch_size, num_masked_spans * mask_length) + ) + mask_idxs = mask_indices + offsets + + # scatter indices to mask + mask = mask.scatter(1, mask_idxs, True) + + return mask + + +def hubert_soft( + path: str, +) -> HubertSoft: + r"""HuBERT-Soft from `"A Comparison of Discrete and Soft Speech Units for Improved Voice Conversion"`. + Args: + path (str): path of a pretrained model + """ + hubert = HubertSoft() + checkpoint = torch.load(path) + consume_prefix_in_state_dict_if_present(checkpoint, "module.") + hubert.load_state_dict(checkpoint) + hubert.eval() + return hubert diff --git a/hubert/hubert_model_onnx.py b/hubert/hubert_model_onnx.py new file mode 100644 index 0000000000000000000000000000000000000000..d18f3c2a0fc29592a573a9780308d38f059640b9 --- /dev/null +++ b/hubert/hubert_model_onnx.py @@ -0,0 +1,217 @@ +import copy +import random +from typing import Optional, Tuple + +import torch +import torch.nn as nn +import torch.nn.functional as t_func +from torch.nn.modules.utils import consume_prefix_in_state_dict_if_present + + +class Hubert(nn.Module): + def __init__(self, num_label_embeddings: int = 100, mask: bool = True): + super().__init__() + self._mask = mask + self.feature_extractor = FeatureExtractor() + self.feature_projection = FeatureProjection() + self.positional_embedding = PositionalConvEmbedding() + self.norm = nn.LayerNorm(768) + self.dropout = nn.Dropout(0.1) + self.encoder = TransformerEncoder( + nn.TransformerEncoderLayer( + 768, 12, 3072, activation="gelu", batch_first=True + ), + 12, + ) + self.proj = nn.Linear(768, 256) + + self.masked_spec_embed = nn.Parameter(torch.FloatTensor(768).uniform_()) + self.label_embedding = nn.Embedding(num_label_embeddings, 256) + + def mask(self, x: torch.Tensor) -> Tuple[torch.Tensor, torch.Tensor]: + mask = None + if self.training and self._mask: + mask = _compute_mask((x.size(0), x.size(1)), 0.8, 10, x.device, 2) + x[mask] = self.masked_spec_embed.to(x.dtype) + return x, mask + + def encode( + self, x: torch.Tensor, layer: Optional[int] = None + ) -> Tuple[torch.Tensor, torch.Tensor]: + x = self.feature_extractor(x) + x = self.feature_projection(x.transpose(1, 2)) + x, mask = self.mask(x) + x = x + self.positional_embedding(x) + x = self.dropout(self.norm(x)) + x = self.encoder(x, output_layer=layer) + return x, mask + + def logits(self, x: torch.Tensor) -> torch.Tensor: + logits = torch.cosine_similarity( + x.unsqueeze(2), + self.label_embedding.weight.unsqueeze(0).unsqueeze(0), + dim=-1, + ) + return logits / 0.1 + + +class HubertSoft(Hubert): + def __init__(self): + super().__init__() + + def units(self, wav: torch.Tensor) -> torch.Tensor: + wav = t_func.pad(wav, ((400 - 320) // 2, (400 - 320) // 2)) + x, _ = self.encode(wav) + return self.proj(x) + + def forward(self, x): + return self.units(x) + +class FeatureExtractor(nn.Module): + def __init__(self): + super().__init__() + self.conv0 = nn.Conv1d(1, 512, 10, 5, bias=False) + self.norm0 = nn.GroupNorm(512, 512) + self.conv1 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv2 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv3 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv4 = nn.Conv1d(512, 512, 3, 2, bias=False) + self.conv5 = nn.Conv1d(512, 512, 2, 2, bias=False) + self.conv6 = nn.Conv1d(512, 512, 2, 2, bias=False) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = t_func.gelu(self.norm0(self.conv0(x))) + x = t_func.gelu(self.conv1(x)) + x = t_func.gelu(self.conv2(x)) + x = t_func.gelu(self.conv3(x)) + x = t_func.gelu(self.conv4(x)) + x = t_func.gelu(self.conv5(x)) + x = t_func.gelu(self.conv6(x)) + return x + + +class FeatureProjection(nn.Module): + def __init__(self): + super().__init__() + self.norm = nn.LayerNorm(512) + self.projection = nn.Linear(512, 768) + self.dropout = nn.Dropout(0.1) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = self.norm(x) + x = self.projection(x) + x = self.dropout(x) + return x + + +class PositionalConvEmbedding(nn.Module): + def __init__(self): + super().__init__() + self.conv = nn.Conv1d( + 768, + 768, + kernel_size=128, + padding=128 // 2, + groups=16, + ) + self.conv = nn.utils.weight_norm(self.conv, name="weight", dim=2) + + def forward(self, x: torch.Tensor) -> torch.Tensor: + x = self.conv(x.transpose(1, 2)) + x = t_func.gelu(x[:, :, :-1]) + return x.transpose(1, 2) + + +class TransformerEncoder(nn.Module): + def __init__( + self, encoder_layer: nn.TransformerEncoderLayer, num_layers: int + ) -> None: + super(TransformerEncoder, self).__init__() + self.layers = nn.ModuleList( + [copy.deepcopy(encoder_layer) for _ in range(num_layers)] + ) + self.num_layers = num_layers + + def forward( + self, + src: torch.Tensor, + mask: torch.Tensor = None, + src_key_padding_mask: torch.Tensor = None, + output_layer: Optional[int] = None, + ) -> torch.Tensor: + output = src + for layer in self.layers[:output_layer]: + output = layer( + output, src_mask=mask, src_key_padding_mask=src_key_padding_mask + ) + return output + + +def _compute_mask( + shape: Tuple[int, int], + mask_prob: float, + mask_length: int, + device: torch.device, + min_masks: int = 0, +) -> torch.Tensor: + batch_size, sequence_length = shape + + if mask_length < 1: + raise ValueError("`mask_length` has to be bigger than 0.") + + if mask_length > sequence_length: + raise ValueError( + f"`mask_length` has to be smaller than `sequence_length`, but got `mask_length`: {mask_length} and `sequence_length`: {sequence_length}`" + ) + + # compute number of masked spans in batch + num_masked_spans = int(mask_prob * sequence_length / mask_length + random.random()) + num_masked_spans = max(num_masked_spans, min_masks) + + # make sure num masked indices <= sequence_length + if num_masked_spans * mask_length > sequence_length: + num_masked_spans = sequence_length // mask_length + + # SpecAugment mask to fill + mask = torch.zeros((batch_size, sequence_length), device=device, dtype=torch.bool) + + # uniform distribution to sample from, make sure that offset samples are < sequence_length + uniform_dist = torch.ones( + (batch_size, sequence_length - (mask_length - 1)), device=device + ) + + # get random indices to mask + mask_indices = torch.multinomial(uniform_dist, num_masked_spans) + + # expand masked indices to masked spans + mask_indices = ( + mask_indices.unsqueeze(dim=-1) + .expand((batch_size, num_masked_spans, mask_length)) + .reshape(batch_size, num_masked_spans * mask_length) + ) + offsets = ( + torch.arange(mask_length, device=device)[None, None, :] + .expand((batch_size, num_masked_spans, mask_length)) + .reshape(batch_size, num_masked_spans * mask_length) + ) + mask_idxs = mask_indices + offsets + + # scatter indices to mask + mask = mask.scatter(1, mask_idxs, True) + + return mask + + +def hubert_soft( + path: str, +) -> HubertSoft: + r"""HuBERT-Soft from `"A Comparison of Discrete and Soft Speech Units for Improved Voice Conversion"`. + Args: + path (str): path of a pretrained model + """ + hubert = HubertSoft() + checkpoint = torch.load(path) + consume_prefix_in_state_dict_if_present(checkpoint, "module.") + hubert.load_state_dict(checkpoint) + hubert.eval() + return hubert diff --git a/hubert/put_hubert_ckpt_here b/hubert/put_hubert_ckpt_here new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/inference/__init__.py b/inference/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/inference/infer_tool.py b/inference/infer_tool.py new file mode 100644 index 0000000000000000000000000000000000000000..91561cfbfc61f3bf7334b10e8e7242574c5ed061 --- /dev/null +++ b/inference/infer_tool.py @@ -0,0 +1,354 @@ +import hashlib +import io +import json +import logging +import os +import time +from pathlib import Path +from inference import slicer +import gc + +import librosa +import numpy as np +# import onnxruntime +import parselmouth +import soundfile +import torch +import torchaudio + +import cluster +from hubert import hubert_model +import utils +from models import SynthesizerTrn + +logging.getLogger('matplotlib').setLevel(logging.WARNING) + + +def read_temp(file_name): + if not os.path.exists(file_name): + with open(file_name, "w") as f: + f.write(json.dumps({"info": "temp_dict"})) + return {} + else: + try: + with open(file_name, "r") as f: + data = f.read() + data_dict = json.loads(data) + if os.path.getsize(file_name) > 50 * 1024 * 1024: + f_name = file_name.replace("\\", "/").split("/")[-1] + print(f"clean {f_name}") + for wav_hash in list(data_dict.keys()): + if int(time.time()) - int(data_dict[wav_hash]["time"]) > 14 * 24 * 3600: + del data_dict[wav_hash] + except Exception as e: + print(e) + print(f"{file_name} error,auto rebuild file") + data_dict = {"info": "temp_dict"} + return data_dict + + +def write_temp(file_name, data): + with open(file_name, "w") as f: + f.write(json.dumps(data)) + + +def timeit(func): + def run(*args, **kwargs): + t = time.time() + res = func(*args, **kwargs) + print('executing \'%s\' costed %.3fs' % (func.__name__, time.time() - t)) + return res + + return run + + +def format_wav(audio_path): + if Path(audio_path).suffix == '.wav': + return + raw_audio, raw_sample_rate = librosa.load(audio_path, mono=True, sr=None) + soundfile.write(Path(audio_path).with_suffix(".wav"), raw_audio, raw_sample_rate) + + +def get_end_file(dir_path, end): + file_lists = [] + for root, dirs, files in os.walk(dir_path): + files = [f for f in files if f[0] != '.'] + dirs[:] = [d for d in dirs if d[0] != '.'] + for f_file in files: + if f_file.endswith(end): + file_lists.append(os.path.join(root, f_file).replace("\\", "/")) + return file_lists + + +def get_md5(content): + return hashlib.new("md5", content).hexdigest() + +def fill_a_to_b(a, b): + if len(a) < len(b): + for _ in range(0, len(b) - len(a)): + a.append(a[0]) + +def mkdir(paths: list): + for path in paths: + if not os.path.exists(path): + os.mkdir(path) + +def pad_array(arr, target_length): + current_length = arr.shape[0] + if current_length >= target_length: + return arr + else: + pad_width = target_length - current_length + pad_left = pad_width // 2 + pad_right = pad_width - pad_left + padded_arr = np.pad(arr, (pad_left, pad_right), 'constant', constant_values=(0, 0)) + return padded_arr + +def split_list_by_n(list_collection, n, pre=0): + for i in range(0, len(list_collection), n): + yield list_collection[i-pre if i-pre>=0 else i: i + n] + + +class F0FilterException(Exception): + pass + +class Svc(object): + def __init__(self, net_g_path, config_path, + device=None, + cluster_model_path="logs/44k/kmeans_10000.pt", + nsf_hifigan_enhance = False + ): + self.net_g_path = net_g_path + if device is None: + self.dev = torch.device("cuda" if torch.cuda.is_available() else "cpu") + else: + self.dev = torch.device(device) + self.net_g_ms = None + self.hps_ms = utils.get_hparams_from_file(config_path) + self.target_sample = self.hps_ms.data.sampling_rate + self.hop_size = self.hps_ms.data.hop_length + self.spk2id = self.hps_ms.spk + self.nsf_hifigan_enhance = nsf_hifigan_enhance + # load hubert + self.hubert_model = utils.get_hubert_model().to(self.dev) + self.load_model() + if os.path.exists(cluster_model_path): + self.cluster_model = cluster.get_cluster_model(cluster_model_path) + if self.nsf_hifigan_enhance: + from modules.enhancer import Enhancer + self.enhancer = Enhancer('nsf-hifigan', 'pretrain/nsf_hifigan/model',device=self.dev) + + def load_model(self): + # get model configuration + self.net_g_ms = SynthesizerTrn( + self.hps_ms.data.filter_length // 2 + 1, + self.hps_ms.train.segment_size // self.hps_ms.data.hop_length, + **self.hps_ms.model) + _ = utils.load_checkpoint(self.net_g_path, self.net_g_ms, None) + if "half" in self.net_g_path and torch.cuda.is_available(): + _ = self.net_g_ms.half().eval().to(self.dev) + else: + _ = self.net_g_ms.eval().to(self.dev) + + + + def get_unit_f0(self, in_path, tran, cluster_infer_ratio, speaker, f0_filter ,F0_mean_pooling,cr_threshold=0.05): + + wav, sr = librosa.load(in_path, sr=self.target_sample) + + if F0_mean_pooling == True: + f0, uv = utils.compute_f0_uv_torchcrepe(torch.FloatTensor(wav), sampling_rate=self.target_sample, hop_length=self.hop_size,device=self.dev,cr_threshold = cr_threshold) + if f0_filter and sum(f0) == 0: + raise F0FilterException("No voice detected") + f0 = torch.FloatTensor(list(f0)) + uv = torch.FloatTensor(list(uv)) + if F0_mean_pooling == False: + f0 = utils.compute_f0_parselmouth(wav, sampling_rate=self.target_sample, hop_length=self.hop_size) + if f0_filter and sum(f0) == 0: + raise F0FilterException("No voice detected") + f0, uv = utils.interpolate_f0(f0) + f0 = torch.FloatTensor(f0) + uv = torch.FloatTensor(uv) + + f0 = f0 * 2 ** (tran / 12) + f0 = f0.unsqueeze(0).to(self.dev) + uv = uv.unsqueeze(0).to(self.dev) + + wav16k = librosa.resample(wav, orig_sr=self.target_sample, target_sr=16000) + wav16k = torch.from_numpy(wav16k).to(self.dev) + c = utils.get_hubert_content(self.hubert_model, wav_16k_tensor=wav16k) + c = utils.repeat_expand_2d(c.squeeze(0), f0.shape[1]) + + if cluster_infer_ratio !=0: + cluster_c = cluster.get_cluster_center_result(self.cluster_model, c.cpu().numpy().T, speaker).T + cluster_c = torch.FloatTensor(cluster_c).to(self.dev) + c = cluster_infer_ratio * cluster_c + (1 - cluster_infer_ratio) * c + + c = c.unsqueeze(0) + return c, f0, uv + + def infer(self, speaker, tran, raw_path, + cluster_infer_ratio=0, + auto_predict_f0=False, + noice_scale=0.4, + f0_filter=False, + F0_mean_pooling=False, + enhancer_adaptive_key = 0, + cr_threshold = 0.05 + ): + + speaker_id = self.spk2id.__dict__.get(speaker) + if not speaker_id and type(speaker) is int: + if len(self.spk2id.__dict__) >= speaker: + speaker_id = speaker + sid = torch.LongTensor([int(speaker_id)]).to(self.dev).unsqueeze(0) + c, f0, uv = self.get_unit_f0(raw_path, tran, cluster_infer_ratio, speaker, f0_filter,F0_mean_pooling,cr_threshold=cr_threshold) + if "half" in self.net_g_path and torch.cuda.is_available(): + c = c.half() + with torch.no_grad(): + start = time.time() + audio = self.net_g_ms.infer(c, f0=f0, g=sid, uv=uv, predict_f0=auto_predict_f0, noice_scale=noice_scale)[0,0].data.float() + if self.nsf_hifigan_enhance: + audio, _ = self.enhancer.enhance( + audio[None,:], + self.target_sample, + f0[:,:,None], + self.hps_ms.data.hop_length, + adaptive_key = enhancer_adaptive_key) + use_time = time.time() - start + print("vits use time:{}".format(use_time)) + return audio, audio.shape[-1] + + def clear_empty(self): + # clean up vram + torch.cuda.empty_cache() + + def unload_model(self): + # unload model + self.net_g_ms = self.net_g_ms.to("cpu") + del self.net_g_ms + if hasattr(self,"enhancer"): + self.enhancer.enhancer = self.enhancer.enhancer.to("cpu") + del self.enhancer.enhancer + del self.enhancer + gc.collect() + + def slice_inference(self, + raw_audio_path, + spk, + tran, + slice_db, + cluster_infer_ratio, + auto_predict_f0, + noice_scale, + pad_seconds=0.5, + clip_seconds=0, + lg_num=0, + lgr_num =0.75, + F0_mean_pooling = False, + enhancer_adaptive_key = 0, + cr_threshold = 0.05 + ): + wav_path = raw_audio_path + chunks = slicer.cut(wav_path, db_thresh=slice_db) + audio_data, audio_sr = slicer.chunks2audio(wav_path, chunks) + per_size = int(clip_seconds*audio_sr) + lg_size = int(lg_num*audio_sr) + lg_size_r = int(lg_size*lgr_num) + lg_size_c_l = (lg_size-lg_size_r)//2 + lg_size_c_r = lg_size-lg_size_r-lg_size_c_l + lg = np.linspace(0,1,lg_size_r) if lg_size!=0 else 0 + + audio = [] + for (slice_tag, data) in audio_data: + print(f'#=====segment start, {round(len(data) / audio_sr, 3)}s======') + # padd + length = int(np.ceil(len(data) / audio_sr * self.target_sample)) + if slice_tag: + print('jump empty segment') + _audio = np.zeros(length) + audio.extend(list(pad_array(_audio, length))) + continue + if per_size != 0: + datas = split_list_by_n(data, per_size,lg_size) + else: + datas = [data] + for k,dat in enumerate(datas): + per_length = int(np.ceil(len(dat) / audio_sr * self.target_sample)) if clip_seconds!=0 else length + if clip_seconds!=0: print(f'###=====segment clip start, {round(len(dat) / audio_sr, 3)}s======') + # padd + pad_len = int(audio_sr * pad_seconds) + dat = np.concatenate([np.zeros([pad_len]), dat, np.zeros([pad_len])]) + raw_path = io.BytesIO() + soundfile.write(raw_path, dat, audio_sr, format="wav") + raw_path.seek(0) + out_audio, out_sr = self.infer(spk, tran, raw_path, + cluster_infer_ratio=cluster_infer_ratio, + auto_predict_f0=auto_predict_f0, + noice_scale=noice_scale, + F0_mean_pooling = F0_mean_pooling, + enhancer_adaptive_key = enhancer_adaptive_key, + cr_threshold = cr_threshold + ) + _audio = out_audio.cpu().numpy() + pad_len = int(self.target_sample * pad_seconds) + _audio = _audio[pad_len:-pad_len] + _audio = pad_array(_audio, per_length) + if lg_size!=0 and k!=0: + lg1 = audio[-(lg_size_r+lg_size_c_r):-lg_size_c_r] if lgr_num != 1 else audio[-lg_size:] + lg2 = _audio[lg_size_c_l:lg_size_c_l+lg_size_r] if lgr_num != 1 else _audio[0:lg_size] + lg_pre = lg1*(1-lg)+lg2*lg + audio = audio[0:-(lg_size_r+lg_size_c_r)] if lgr_num != 1 else audio[0:-lg_size] + audio.extend(lg_pre) + _audio = _audio[lg_size_c_l+lg_size_r:] if lgr_num != 1 else _audio[lg_size:] + audio.extend(list(_audio)) + return np.array(audio) + +class RealTimeVC: + def __init__(self): + self.last_chunk = None + self.last_o = None + self.chunk_len = 16000 # chunk length + self.pre_len = 3840 # cross fade length, multiples of 640 + + # Input and output are 1-dimensional numpy waveform arrays + + def process(self, svc_model, speaker_id, f_pitch_change, input_wav_path, + cluster_infer_ratio=0, + auto_predict_f0=False, + noice_scale=0.4, + f0_filter=False): + + import maad + audio, sr = torchaudio.load(input_wav_path) + audio = audio.cpu().numpy()[0] + temp_wav = io.BytesIO() + if self.last_chunk is None: + input_wav_path.seek(0) + + audio, sr = svc_model.infer(speaker_id, f_pitch_change, input_wav_path, + cluster_infer_ratio=cluster_infer_ratio, + auto_predict_f0=auto_predict_f0, + noice_scale=noice_scale, + f0_filter=f0_filter) + + audio = audio.cpu().numpy() + self.last_chunk = audio[-self.pre_len:] + self.last_o = audio + return audio[-self.chunk_len:] + else: + audio = np.concatenate([self.last_chunk, audio]) + soundfile.write(temp_wav, audio, sr, format="wav") + temp_wav.seek(0) + + audio, sr = svc_model.infer(speaker_id, f_pitch_change, temp_wav, + cluster_infer_ratio=cluster_infer_ratio, + auto_predict_f0=auto_predict_f0, + noice_scale=noice_scale, + f0_filter=f0_filter) + + audio = audio.cpu().numpy() + ret = maad.util.crossfade(self.last_o, audio, self.pre_len) + self.last_chunk = audio[-self.pre_len:] + self.last_o = audio + return ret[self.chunk_len:2 * self.chunk_len] diff --git a/inference/infer_tool_grad.py b/inference/infer_tool_grad.py new file mode 100644 index 0000000000000000000000000000000000000000..b75af49c08e2e724839828bc419792ed580809bb --- /dev/null +++ b/inference/infer_tool_grad.py @@ -0,0 +1,160 @@ +import hashlib +import json +import logging +import os +import time +from pathlib import Path +import io +import librosa +import maad +import numpy as np +from inference import slicer +import parselmouth +import soundfile +import torch +import torchaudio + +from hubert import hubert_model +import utils +from models import SynthesizerTrn +logging.getLogger('numba').setLevel(logging.WARNING) +logging.getLogger('matplotlib').setLevel(logging.WARNING) + +def resize2d_f0(x, target_len): + source = np.array(x) + source[source < 0.001] = np.nan + target = np.interp(np.arange(0, len(source) * target_len, len(source)) / target_len, np.arange(0, len(source)), + source) + res = np.nan_to_num(target) + return res + +def get_f0(x, p_len,f0_up_key=0): + + time_step = 160 / 16000 * 1000 + f0_min = 50 + f0_max = 1100 + f0_mel_min = 1127 * np.log(1 + f0_min / 700) + f0_mel_max = 1127 * np.log(1 + f0_max / 700) + + f0 = parselmouth.Sound(x, 16000).to_pitch_ac( + time_step=time_step / 1000, voicing_threshold=0.6, + pitch_floor=f0_min, pitch_ceiling=f0_max).selected_array['frequency'] + + pad_size=(p_len - len(f0) + 1) // 2 + if(pad_size>0 or p_len - len(f0) - pad_size>0): + f0 = np.pad(f0,[[pad_size,p_len - len(f0) - pad_size]], mode='constant') + + f0 *= pow(2, f0_up_key / 12) + f0_mel = 1127 * np.log(1 + f0 / 700) + f0_mel[f0_mel > 0] = (f0_mel[f0_mel > 0] - f0_mel_min) * 254 / (f0_mel_max - f0_mel_min) + 1 + f0_mel[f0_mel <= 1] = 1 + f0_mel[f0_mel > 255] = 255 + f0_coarse = np.rint(f0_mel).astype(np.int) + return f0_coarse, f0 + +def clean_pitch(input_pitch): + num_nan = np.sum(input_pitch == 1) + if num_nan / len(input_pitch) > 0.9: + input_pitch[input_pitch != 1] = 1 + return input_pitch + + +def plt_pitch(input_pitch): + input_pitch = input_pitch.astype(float) + input_pitch[input_pitch == 1] = np.nan + return input_pitch + + +def f0_to_pitch(ff): + f0_pitch = 69 + 12 * np.log2(ff / 440) + return f0_pitch + + +def fill_a_to_b(a, b): + if len(a) < len(b): + for _ in range(0, len(b) - len(a)): + a.append(a[0]) + + +def mkdir(paths: list): + for path in paths: + if not os.path.exists(path): + os.mkdir(path) + + +class VitsSvc(object): + def __init__(self): + self.device = torch.device("cuda" if torch.cuda.is_available() else "cpu") + self.SVCVITS = None + self.hps = None + self.speakers = None + self.hubert_soft = utils.get_hubert_model() + + def set_device(self, device): + self.device = torch.device(device) + self.hubert_soft.to(self.device) + if self.SVCVITS != None: + self.SVCVITS.to(self.device) + + def loadCheckpoint(self, path): + self.hps = utils.get_hparams_from_file(f"checkpoints/{path}/config.json") + self.SVCVITS = SynthesizerTrn( + self.hps.data.filter_length // 2 + 1, + self.hps.train.segment_size // self.hps.data.hop_length, + **self.hps.model) + _ = utils.load_checkpoint(f"checkpoints/{path}/model.pth", self.SVCVITS, None) + _ = self.SVCVITS.eval().to(self.device) + self.speakers = self.hps.spk + + def get_units(self, source, sr): + source = source.unsqueeze(0).to(self.device) + with torch.inference_mode(): + units = self.hubert_soft.units(source) + return units + + + def get_unit_pitch(self, in_path, tran): + source, sr = torchaudio.load(in_path) + source = torchaudio.functional.resample(source, sr, 16000) + if len(source.shape) == 2 and source.shape[1] >= 2: + source = torch.mean(source, dim=0).unsqueeze(0) + soft = self.get_units(source, sr).squeeze(0).cpu().numpy() + f0_coarse, f0 = get_f0(source.cpu().numpy()[0], soft.shape[0]*2, tran) + return soft, f0 + + def infer(self, speaker_id, tran, raw_path): + speaker_id = self.speakers[speaker_id] + sid = torch.LongTensor([int(speaker_id)]).to(self.device).unsqueeze(0) + soft, pitch = self.get_unit_pitch(raw_path, tran) + f0 = torch.FloatTensor(clean_pitch(pitch)).unsqueeze(0).to(self.device) + stn_tst = torch.FloatTensor(soft) + with torch.no_grad(): + x_tst = stn_tst.unsqueeze(0).to(self.device) + x_tst = torch.repeat_interleave(x_tst, repeats=2, dim=1).transpose(1, 2) + audio = self.SVCVITS.infer(x_tst, f0=f0, g=sid)[0,0].data.float() + return audio, audio.shape[-1] + + def inference(self,srcaudio,chara,tran,slice_db): + sampling_rate, audio = srcaudio + audio = (audio / np.iinfo(audio.dtype).max).astype(np.float32) + if len(audio.shape) > 1: + audio = librosa.to_mono(audio.transpose(1, 0)) + if sampling_rate != 16000: + audio = librosa.resample(audio, orig_sr=sampling_rate, target_sr=16000) + soundfile.write("tmpwav.wav", audio, 16000, format="wav") + chunks = slicer.cut("tmpwav.wav", db_thresh=slice_db) + audio_data, audio_sr = slicer.chunks2audio("tmpwav.wav", chunks) + audio = [] + for (slice_tag, data) in audio_data: + length = int(np.ceil(len(data) / audio_sr * self.hps.data.sampling_rate)) + raw_path = io.BytesIO() + soundfile.write(raw_path, data, audio_sr, format="wav") + raw_path.seek(0) + if slice_tag: + _audio = np.zeros(length) + else: + out_audio, out_sr = self.infer(chara, tran, raw_path) + _audio = out_audio.cpu().numpy() + audio.extend(list(_audio)) + audio = (np.array(audio) * 32768.0).astype('int16') + return (self.hps.data.sampling_rate,audio) diff --git a/inference/slicer.py b/inference/slicer.py new file mode 100644 index 0000000000000000000000000000000000000000..afb31b7af1cdf8310ea42968d1857af6f15d73e4 --- /dev/null +++ b/inference/slicer.py @@ -0,0 +1,142 @@ +import librosa +import torch +import torchaudio + + +class Slicer: + def __init__(self, + sr: int, + threshold: float = -40., + min_length: int = 5000, + min_interval: int = 300, + hop_size: int = 20, + max_sil_kept: int = 5000): + if not min_length >= min_interval >= hop_size: + raise ValueError('The following condition must be satisfied: min_length >= min_interval >= hop_size') + if not max_sil_kept >= hop_size: + raise ValueError('The following condition must be satisfied: max_sil_kept >= hop_size') + min_interval = sr * min_interval / 1000 + self.threshold = 10 ** (threshold / 20.) + self.hop_size = round(sr * hop_size / 1000) + self.win_size = min(round(min_interval), 4 * self.hop_size) + self.min_length = round(sr * min_length / 1000 / self.hop_size) + self.min_interval = round(min_interval / self.hop_size) + self.max_sil_kept = round(sr * max_sil_kept / 1000 / self.hop_size) + + def _apply_slice(self, waveform, begin, end): + if len(waveform.shape) > 1: + return waveform[:, begin * self.hop_size: min(waveform.shape[1], end * self.hop_size)] + else: + return waveform[begin * self.hop_size: min(waveform.shape[0], end * self.hop_size)] + + # @timeit + def slice(self, waveform): + if len(waveform.shape) > 1: + samples = librosa.to_mono(waveform) + else: + samples = waveform + if samples.shape[0] <= self.min_length: + return {"0": {"slice": False, "split_time": f"0,{len(waveform)}"}} + rms_list = librosa.feature.rms(y=samples, frame_length=self.win_size, hop_length=self.hop_size).squeeze(0) + sil_tags = [] + silence_start = None + clip_start = 0 + for i, rms in enumerate(rms_list): + # Keep looping while frame is silent. + if rms < self.threshold: + # Record start of silent frames. + if silence_start is None: + silence_start = i + continue + # Keep looping while frame is not silent and silence start has not been recorded. + if silence_start is None: + continue + # Clear recorded silence start if interval is not enough or clip is too short + is_leading_silence = silence_start == 0 and i > self.max_sil_kept + need_slice_middle = i - silence_start >= self.min_interval and i - clip_start >= self.min_length + if not is_leading_silence and not need_slice_middle: + silence_start = None + continue + # Need slicing. Record the range of silent frames to be removed. + if i - silence_start <= self.max_sil_kept: + pos = rms_list[silence_start: i + 1].argmin() + silence_start + if silence_start == 0: + sil_tags.append((0, pos)) + else: + sil_tags.append((pos, pos)) + clip_start = pos + elif i - silence_start <= self.max_sil_kept * 2: + pos = rms_list[i - self.max_sil_kept: silence_start + self.max_sil_kept + 1].argmin() + pos += i - self.max_sil_kept + pos_l = rms_list[silence_start: silence_start + self.max_sil_kept + 1].argmin() + silence_start + pos_r = rms_list[i - self.max_sil_kept: i + 1].argmin() + i - self.max_sil_kept + if silence_start == 0: + sil_tags.append((0, pos_r)) + clip_start = pos_r + else: + sil_tags.append((min(pos_l, pos), max(pos_r, pos))) + clip_start = max(pos_r, pos) + else: + pos_l = rms_list[silence_start: silence_start + self.max_sil_kept + 1].argmin() + silence_start + pos_r = rms_list[i - self.max_sil_kept: i + 1].argmin() + i - self.max_sil_kept + if silence_start == 0: + sil_tags.append((0, pos_r)) + else: + sil_tags.append((pos_l, pos_r)) + clip_start = pos_r + silence_start = None + # Deal with trailing silence. + total_frames = rms_list.shape[0] + if silence_start is not None and total_frames - silence_start >= self.min_interval: + silence_end = min(total_frames, silence_start + self.max_sil_kept) + pos = rms_list[silence_start: silence_end + 1].argmin() + silence_start + sil_tags.append((pos, total_frames + 1)) + # Apply and return slices. + if len(sil_tags) == 0: + return {"0": {"slice": False, "split_time": f"0,{len(waveform)}"}} + else: + chunks = [] + # The first segment is not the beginning of the audio. + if sil_tags[0][0]: + chunks.append( + {"slice": False, "split_time": f"0,{min(waveform.shape[0], sil_tags[0][0] * self.hop_size)}"}) + for i in range(0, len(sil_tags)): + # Mark audio segment. Skip the first segment. + if i: + chunks.append({"slice": False, + "split_time": f"{sil_tags[i - 1][1] * self.hop_size},{min(waveform.shape[0], sil_tags[i][0] * self.hop_size)}"}) + # Mark all mute segments + chunks.append({"slice": True, + "split_time": f"{sil_tags[i][0] * self.hop_size},{min(waveform.shape[0], sil_tags[i][1] * self.hop_size)}"}) + # The last segment is not the end. + if sil_tags[-1][1] * self.hop_size < len(waveform): + chunks.append({"slice": False, "split_time": f"{sil_tags[-1][1] * self.hop_size},{len(waveform)}"}) + chunk_dict = {} + for i in range(len(chunks)): + chunk_dict[str(i)] = chunks[i] + return chunk_dict + + +def cut(audio_path, db_thresh=-30, min_len=5000): + audio, sr = librosa.load(audio_path, sr=None) + slicer = Slicer( + sr=sr, + threshold=db_thresh, + min_length=min_len + ) + chunks = slicer.slice(audio) + return chunks + + +def chunks2audio(audio_path, chunks): + chunks = dict(chunks) + audio, sr = torchaudio.load(audio_path) + if len(audio.shape) == 2 and audio.shape[1] >= 2: + audio = torch.mean(audio, dim=0).unsqueeze(0) + audio = audio.cpu().numpy()[0] + result = [] + for k, v in chunks.items(): + tag = v["split_time"].split(",") + if tag[0] != tag[1]: + result.append((v["slice"], audio[int(tag[0]):int(tag[1])])) + return result, sr diff --git a/inference_main.py b/inference_main.py new file mode 100644 index 0000000000000000000000000000000000000000..edc627c34a6947c5a5048e874ede9517f3af635a --- /dev/null +++ b/inference_main.py @@ -0,0 +1,161 @@ +import io +import logging +import time +from pathlib import Path + +import librosa +import matplotlib.pyplot as plt +import numpy as np +import soundfile + +from inference import infer_tool +from inference import slicer +from inference.infer_tool import Svc + +logging.getLogger('numba').setLevel(logging.WARNING) +chunks_dict = infer_tool.read_temp("inference/chunks_temp.json") + + + +def main(): + import argparse + + parser = argparse.ArgumentParser(description='sovits4 inference') + + # Required + parser.add_argument('-m', '--model_path', type=str, default="logs/44k/G_0.pth", + help='Path to the model.') + parser.add_argument('-c', '--config_path', type=str, default="configs/config.json", + help='Path to the configuration file.') + parser.add_argument('-s', '--spk_list', type=str, nargs='+', default=['nen'], + help='Target speaker name for conversion.') + parser.add_argument('-n', '--clean_names', type=str, nargs='+', default=["君の知らない物語-src.wav"], + help='A list of wav file names located in the raw folder.') + parser.add_argument('-t', '--trans', type=int, nargs='+', default=[0], + help='Pitch adjustment, supports positive and negative (semitone) values.') + + # Optional + parser.add_argument('-a', '--auto_predict_f0', action='store_true', default=False, + help='Automatic pitch prediction for voice conversion. Do not enable this when converting songs as it can cause serious pitch issues.') + parser.add_argument('-cl', '--clip', type=float, default=0, + help='Voice forced slicing. Set to 0 to turn off(default), duration in seconds.') + parser.add_argument('-lg', '--linear_gradient', type=float, default=0, + help='The cross fade length of two audio slices in seconds. If there is a discontinuous voice after forced slicing, you can adjust this value. Otherwise, it is recommended to use. Default 0.') + parser.add_argument('-cm', '--cluster_model_path', type=str, default="logs/44k/kmeans_10000.pt", + help='Path to the clustering model. Fill in any value if clustering is not trained.') + parser.add_argument('-cr', '--cluster_infer_ratio', type=float, default=0, + help='Proportion of the clustering solution, range 0-1. Fill in 0 if the clustering model is not trained.') + parser.add_argument('-fmp', '--f0_mean_pooling', action='store_true', default=False, + help='Apply mean filter (pooling) to f0, which may improve some hoarse sounds. Enabling this option will reduce inference speed.') + parser.add_argument('-eh', '--enhance', action='store_true', default=False, + help='Whether to use NSF_HIFIGAN enhancer. This option has certain effect on sound quality enhancement for some models with few training sets, but has negative effect on well-trained models, so it is turned off by default.') + + # generally keep default + parser.add_argument('-sd', '--slice_db', type=int, default=-40, + help='Loudness for automatic slicing. For noisy audio it can be set to -30') + parser.add_argument('-d', '--device', type=str, default=None, + help='Device used for inference. None means auto selecting.') + parser.add_argument('-ns', '--noice_scale', type=float, default=0.4, + help='Affect pronunciation and sound quality.') + parser.add_argument('-p', '--pad_seconds', type=float, default=0.5, + help='Due to unknown reasons, there may be abnormal noise at the beginning and end. It will disappear after padding a short silent segment.') + parser.add_argument('-wf', '--wav_format', type=str, default='flac', + help='output format') + parser.add_argument('-lgr', '--linear_gradient_retain', type=float, default=0.75, + help='Proportion of cross length retention, range (0-1]. After forced slicing, the beginning and end of each segment need to be discarded.') + parser.add_argument('-eak', '--enhancer_adaptive_key', type=int, default=0, + help='Adapt the enhancer to a higher range of sound. The unit is the semitones, default 0.') + parser.add_argument('-ft', '--f0_filter_threshold', type=float, default=0.05, + help='F0 Filtering threshold: This parameter is valid only when f0_mean_pooling is enabled. Values range from 0 to 1. Reducing this value reduces the probability of being out of tune, but increases matte.') + + + args = parser.parse_args() + + clean_names = args.clean_names + trans = args.trans + spk_list = args.spk_list + slice_db = args.slice_db + wav_format = args.wav_format + auto_predict_f0 = args.auto_predict_f0 + cluster_infer_ratio = args.cluster_infer_ratio + noice_scale = args.noice_scale + pad_seconds = args.pad_seconds + clip = args.clip + lg = args.linear_gradient + lgr = args.linear_gradient_retain + F0_mean_pooling = args.f0_mean_pooling + enhance = args.enhance + enhancer_adaptive_key = args.enhancer_adaptive_key + cr_threshold = args.f0_filter_threshold + + svc_model = Svc(args.model_path, args.config_path, args.device, args.cluster_model_path,enhance) + infer_tool.mkdir(["raw", "results"]) + + infer_tool.fill_a_to_b(trans, clean_names) + for clean_name, tran in zip(clean_names, trans): + raw_audio_path = f"raw/{clean_name}" + if "." not in raw_audio_path: + raw_audio_path += ".wav" + infer_tool.format_wav(raw_audio_path) + wav_path = Path(raw_audio_path).with_suffix('.wav') + chunks = slicer.cut(wav_path, db_thresh=slice_db) + audio_data, audio_sr = slicer.chunks2audio(wav_path, chunks) + per_size = int(clip*audio_sr) + lg_size = int(lg*audio_sr) + lg_size_r = int(lg_size*lgr) + lg_size_c_l = (lg_size-lg_size_r)//2 + lg_size_c_r = lg_size-lg_size_r-lg_size_c_l + lg_2 = np.linspace(0,1,lg_size_r) if lg_size!=0 else 0 + + for spk in spk_list: + audio = [] + for (slice_tag, data) in audio_data: + print(f'#=====segment start, {round(len(data) / audio_sr, 3)}s======') + + length = int(np.ceil(len(data) / audio_sr * svc_model.target_sample)) + if slice_tag: + print('jump empty segment') + _audio = np.zeros(length) + audio.extend(list(infer_tool.pad_array(_audio, length))) + continue + if per_size != 0: + datas = infer_tool.split_list_by_n(data, per_size,lg_size) + else: + datas = [data] + for k,dat in enumerate(datas): + per_length = int(np.ceil(len(dat) / audio_sr * svc_model.target_sample)) if clip!=0 else length + if clip!=0: print(f'###=====segment clip start, {round(len(dat) / audio_sr, 3)}s======') + # padd + pad_len = int(audio_sr * pad_seconds) + dat = np.concatenate([np.zeros([pad_len]), dat, np.zeros([pad_len])]) + raw_path = io.BytesIO() + soundfile.write(raw_path, dat, audio_sr, format="wav") + raw_path.seek(0) + out_audio, out_sr = svc_model.infer(spk, tran, raw_path, + cluster_infer_ratio=cluster_infer_ratio, + auto_predict_f0=auto_predict_f0, + noice_scale=noice_scale, + F0_mean_pooling = F0_mean_pooling, + enhancer_adaptive_key = enhancer_adaptive_key, + cr_threshold = cr_threshold + ) + _audio = out_audio.cpu().numpy() + pad_len = int(svc_model.target_sample * pad_seconds) + _audio = _audio[pad_len:-pad_len] + _audio = infer_tool.pad_array(_audio, per_length) + if lg_size!=0 and k!=0: + lg1 = audio[-(lg_size_r+lg_size_c_r):-lg_size_c_r] if lgr != 1 else audio[-lg_size:] + lg2 = _audio[lg_size_c_l:lg_size_c_l+lg_size_r] if lgr != 1 else _audio[0:lg_size] + lg_pre = lg1*(1-lg_2)+lg2*lg_2 + audio = audio[0:-(lg_size_r+lg_size_c_r)] if lgr != 1 else audio[0:-lg_size] + audio.extend(lg_pre) + _audio = _audio[lg_size_c_l+lg_size_r:] if lgr != 1 else _audio[lg_size:] + audio.extend(list(_audio)) + key = "auto" if auto_predict_f0 else f"{tran}key" + cluster_name = "" if cluster_infer_ratio == 0 else f"_{cluster_infer_ratio}" + res_path = f'./results/{clean_name}_{key}_{spk}{cluster_name}.{wav_format}' + soundfile.write(res_path, audio, svc_model.target_sample, format=wav_format) + svc_model.clear_empty() + +if __name__ == '__main__': + main() diff --git a/models.py b/models.py new file mode 100644 index 0000000000000000000000000000000000000000..13278d680493970f5a670cf3fc955a6e9b7ab1d5 --- /dev/null +++ b/models.py @@ -0,0 +1,420 @@ +import copy +import math +import torch +from torch import nn +from torch.nn import functional as F + +import modules.attentions as attentions +import modules.commons as commons +import modules.modules as modules + +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm, spectral_norm + +import utils +from modules.commons import init_weights, get_padding +from vdecoder.hifigan.models import Generator +from utils import f0_to_coarse + +class ResidualCouplingBlock(nn.Module): + def __init__(self, + channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + n_flows=4, + gin_channels=0): + super().__init__() + self.channels = channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.n_flows = n_flows + self.gin_channels = gin_channels + + self.flows = nn.ModuleList() + for i in range(n_flows): + self.flows.append(modules.ResidualCouplingLayer(channels, hidden_channels, kernel_size, dilation_rate, n_layers, gin_channels=gin_channels, mean_only=True)) + self.flows.append(modules.Flip()) + + def forward(self, x, x_mask, g=None, reverse=False): + if not reverse: + for flow in self.flows: + x, _ = flow(x, x_mask, g=g, reverse=reverse) + else: + for flow in reversed(self.flows): + x = flow(x, x_mask, g=g, reverse=reverse) + return x + + +class Encoder(nn.Module): + def __init__(self, + in_channels, + out_channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + gin_channels=0): + super().__init__() + self.in_channels = in_channels + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.gin_channels = gin_channels + + self.pre = nn.Conv1d(in_channels, hidden_channels, 1) + self.enc = modules.WN(hidden_channels, kernel_size, dilation_rate, n_layers, gin_channels=gin_channels) + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + + def forward(self, x, x_lengths, g=None): + # print(x.shape,x_lengths.shape) + x_mask = torch.unsqueeze(commons.sequence_mask(x_lengths, x.size(2)), 1).to(x.dtype) + x = self.pre(x) * x_mask + x = self.enc(x, x_mask, g=g) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + torch.randn_like(m) * torch.exp(logs)) * x_mask + return z, m, logs, x_mask + + +class TextEncoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + kernel_size, + n_layers, + gin_channels=0, + filter_channels=None, + n_heads=None, + p_dropout=None): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.n_layers = n_layers + self.gin_channels = gin_channels + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + self.f0_emb = nn.Embedding(256, hidden_channels) + + self.enc_ = attentions.Encoder( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + + def forward(self, x, x_mask, f0=None, noice_scale=1): + x = x + self.f0_emb(f0).transpose(1,2) + x = self.enc_(x * x_mask, x_mask) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + torch.randn_like(m) * torch.exp(logs) * noice_scale) * x_mask + + return z, m, logs, x_mask + + + +class DiscriminatorP(torch.nn.Module): + def __init__(self, period, kernel_size=5, stride=3, use_spectral_norm=False): + super(DiscriminatorP, self).__init__() + self.period = period + self.use_spectral_norm = use_spectral_norm + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv2d(1, 32, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(32, 128, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(128, 512, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(512, 1024, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(1024, 1024, (kernel_size, 1), 1, padding=(get_padding(kernel_size, 1), 0))), + ]) + self.conv_post = norm_f(Conv2d(1024, 1, (3, 1), 1, padding=(1, 0))) + + def forward(self, x): + fmap = [] + + # 1d to 2d + b, c, t = x.shape + if t % self.period != 0: # pad first + n_pad = self.period - (t % self.period) + x = F.pad(x, (0, n_pad), "reflect") + t = t + n_pad + x = x.view(b, c, t // self.period, self.period) + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class DiscriminatorS(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(DiscriminatorS, self).__init__() + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv1d(1, 16, 15, 1, padding=7)), + norm_f(Conv1d(16, 64, 41, 4, groups=4, padding=20)), + norm_f(Conv1d(64, 256, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(256, 1024, 41, 4, groups=64, padding=20)), + norm_f(Conv1d(1024, 1024, 41, 4, groups=256, padding=20)), + norm_f(Conv1d(1024, 1024, 5, 1, padding=2)), + ]) + self.conv_post = norm_f(Conv1d(1024, 1, 3, 1, padding=1)) + + def forward(self, x): + fmap = [] + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class MultiPeriodDiscriminator(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(MultiPeriodDiscriminator, self).__init__() + periods = [2,3,5,7,11] + + discs = [DiscriminatorS(use_spectral_norm=use_spectral_norm)] + discs = discs + [DiscriminatorP(i, use_spectral_norm=use_spectral_norm) for i in periods] + self.discriminators = nn.ModuleList(discs) + + def forward(self, y, y_hat): + y_d_rs = [] + y_d_gs = [] + fmap_rs = [] + fmap_gs = [] + for i, d in enumerate(self.discriminators): + y_d_r, fmap_r = d(y) + y_d_g, fmap_g = d(y_hat) + y_d_rs.append(y_d_r) + y_d_gs.append(y_d_g) + fmap_rs.append(fmap_r) + fmap_gs.append(fmap_g) + + return y_d_rs, y_d_gs, fmap_rs, fmap_gs + + +class SpeakerEncoder(torch.nn.Module): + def __init__(self, mel_n_channels=80, model_num_layers=3, model_hidden_size=256, model_embedding_size=256): + super(SpeakerEncoder, self).__init__() + self.lstm = nn.LSTM(mel_n_channels, model_hidden_size, model_num_layers, batch_first=True) + self.linear = nn.Linear(model_hidden_size, model_embedding_size) + self.relu = nn.ReLU() + + def forward(self, mels): + self.lstm.flatten_parameters() + _, (hidden, _) = self.lstm(mels) + embeds_raw = self.relu(self.linear(hidden[-1])) + return embeds_raw / torch.norm(embeds_raw, dim=1, keepdim=True) + + def compute_partial_slices(self, total_frames, partial_frames, partial_hop): + mel_slices = [] + for i in range(0, total_frames-partial_frames, partial_hop): + mel_range = torch.arange(i, i+partial_frames) + mel_slices.append(mel_range) + + return mel_slices + + def embed_utterance(self, mel, partial_frames=128, partial_hop=64): + mel_len = mel.size(1) + last_mel = mel[:,-partial_frames:] + + if mel_len > partial_frames: + mel_slices = self.compute_partial_slices(mel_len, partial_frames, partial_hop) + mels = list(mel[:,s] for s in mel_slices) + mels.append(last_mel) + mels = torch.stack(tuple(mels), 0).squeeze(1) + + with torch.no_grad(): + partial_embeds = self(mels) + embed = torch.mean(partial_embeds, axis=0).unsqueeze(0) + #embed = embed / torch.linalg.norm(embed, 2) + else: + with torch.no_grad(): + embed = self(last_mel) + + return embed + +class F0Decoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=0): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.spk_channels = spk_channels + + self.prenet = nn.Conv1d(hidden_channels, hidden_channels, 3, padding=1) + self.decoder = attentions.FFT( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + self.proj = nn.Conv1d(hidden_channels, out_channels, 1) + self.f0_prenet = nn.Conv1d(1, hidden_channels , 3, padding=1) + self.cond = nn.Conv1d(spk_channels, hidden_channels, 1) + + def forward(self, x, norm_f0, x_mask, spk_emb=None): + x = torch.detach(x) + if (spk_emb is not None): + x = x + self.cond(spk_emb) + x += self.f0_prenet(norm_f0) + x = self.prenet(x) * x_mask + x = self.decoder(x * x_mask, x_mask) + x = self.proj(x) * x_mask + return x + + +class SynthesizerTrn(nn.Module): + """ + Synthesizer for Training + """ + + def __init__(self, + spec_channels, + segment_size, + inter_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + resblock, + resblock_kernel_sizes, + resblock_dilation_sizes, + upsample_rates, + upsample_initial_channel, + upsample_kernel_sizes, + gin_channels, + ssl_dim, + n_speakers, + sampling_rate=44100, + **kwargs): + + super().__init__() + self.spec_channels = spec_channels + self.inter_channels = inter_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.resblock = resblock + self.resblock_kernel_sizes = resblock_kernel_sizes + self.resblock_dilation_sizes = resblock_dilation_sizes + self.upsample_rates = upsample_rates + self.upsample_initial_channel = upsample_initial_channel + self.upsample_kernel_sizes = upsample_kernel_sizes + self.segment_size = segment_size + self.gin_channels = gin_channels + self.ssl_dim = ssl_dim + self.emb_g = nn.Embedding(n_speakers, gin_channels) + + self.pre = nn.Conv1d(ssl_dim, hidden_channels, kernel_size=5, padding=2) + + self.enc_p = TextEncoder( + inter_channels, + hidden_channels, + filter_channels=filter_channels, + n_heads=n_heads, + n_layers=n_layers, + kernel_size=kernel_size, + p_dropout=p_dropout + ) + hps = { + "sampling_rate": sampling_rate, + "inter_channels": inter_channels, + "resblock": resblock, + "resblock_kernel_sizes": resblock_kernel_sizes, + "resblock_dilation_sizes": resblock_dilation_sizes, + "upsample_rates": upsample_rates, + "upsample_initial_channel": upsample_initial_channel, + "upsample_kernel_sizes": upsample_kernel_sizes, + "gin_channels": gin_channels, + } + self.dec = Generator(h=hps) + self.enc_q = Encoder(spec_channels, inter_channels, hidden_channels, 5, 1, 16, gin_channels=gin_channels) + self.flow = ResidualCouplingBlock(inter_channels, hidden_channels, 5, 1, 4, gin_channels=gin_channels) + self.f0_decoder = F0Decoder( + 1, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=gin_channels + ) + self.emb_uv = nn.Embedding(2, hidden_channels) + + def forward(self, c, f0, uv, spec, g=None, c_lengths=None, spec_lengths=None): + g = self.emb_g(g).transpose(1,2) + # ssl prenet + x_mask = torch.unsqueeze(commons.sequence_mask(c_lengths, c.size(2)), 1).to(c.dtype) + x = self.pre(c) * x_mask + self.emb_uv(uv.long()).transpose(1,2) + + # f0 predict + lf0 = 2595. * torch.log10(1. + f0.unsqueeze(1) / 700.) / 500 + norm_lf0 = utils.normalize_f0(lf0, x_mask, uv) + pred_lf0 = self.f0_decoder(x, norm_lf0, x_mask, spk_emb=g) + + # encoder + z_ptemp, m_p, logs_p, _ = self.enc_p(x, x_mask, f0=f0_to_coarse(f0)) + z, m_q, logs_q, spec_mask = self.enc_q(spec, spec_lengths, g=g) + + # flow + z_p = self.flow(z, spec_mask, g=g) + z_slice, pitch_slice, ids_slice = commons.rand_slice_segments_with_pitch(z, f0, spec_lengths, self.segment_size) + + # nsf decoder + o = self.dec(z_slice, g=g, f0=pitch_slice) + + return o, ids_slice, spec_mask, (z, z_p, m_p, logs_p, m_q, logs_q), pred_lf0, norm_lf0, lf0 + + def infer(self, c, f0, uv, g=None, noice_scale=0.35, predict_f0=False): + c_lengths = (torch.ones(c.size(0)) * c.size(-1)).to(c.device) + g = self.emb_g(g).transpose(1,2) + x_mask = torch.unsqueeze(commons.sequence_mask(c_lengths, c.size(2)), 1).to(c.dtype) + x = self.pre(c) * x_mask + self.emb_uv(uv.long()).transpose(1,2) + + if predict_f0: + lf0 = 2595. * torch.log10(1. + f0.unsqueeze(1) / 700.) / 500 + norm_lf0 = utils.normalize_f0(lf0, x_mask, uv, random_scale=False) + pred_lf0 = self.f0_decoder(x, norm_lf0, x_mask, spk_emb=g) + f0 = (700 * (torch.pow(10, pred_lf0 * 500 / 2595) - 1)).squeeze(1) + + z_p, m_p, logs_p, c_mask = self.enc_p(x, x_mask, f0=f0_to_coarse(f0), noice_scale=noice_scale) + z = self.flow(z_p, c_mask, g=g, reverse=True) + o = self.dec(z * c_mask, g=g, f0=f0) + return o diff --git a/modules/__init__.py b/modules/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/modules/attentions.py b/modules/attentions.py new file mode 100644 index 0000000000000000000000000000000000000000..f9c11ca4a3acb86bf1abc04d9dcfa82a4ed4061f --- /dev/null +++ b/modules/attentions.py @@ -0,0 +1,349 @@ +import copy +import math +import numpy as np +import torch +from torch import nn +from torch.nn import functional as F + +import modules.commons as commons +import modules.modules as modules +from modules.modules import LayerNorm + + +class FFT(nn.Module): + def __init__(self, hidden_channels, filter_channels, n_heads, n_layers=1, kernel_size=1, p_dropout=0., + proximal_bias=False, proximal_init=True, **kwargs): + super().__init__() + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.proximal_bias = proximal_bias + self.proximal_init = proximal_init + + self.drop = nn.Dropout(p_dropout) + self.self_attn_layers = nn.ModuleList() + self.norm_layers_0 = nn.ModuleList() + self.ffn_layers = nn.ModuleList() + self.norm_layers_1 = nn.ModuleList() + for i in range(self.n_layers): + self.self_attn_layers.append( + MultiHeadAttention(hidden_channels, hidden_channels, n_heads, p_dropout=p_dropout, proximal_bias=proximal_bias, + proximal_init=proximal_init)) + self.norm_layers_0.append(LayerNorm(hidden_channels)) + self.ffn_layers.append( + FFN(hidden_channels, hidden_channels, filter_channels, kernel_size, p_dropout=p_dropout, causal=True)) + self.norm_layers_1.append(LayerNorm(hidden_channels)) + + def forward(self, x, x_mask): + """ + x: decoder input + h: encoder output + """ + self_attn_mask = commons.subsequent_mask(x_mask.size(2)).to(device=x.device, dtype=x.dtype) + x = x * x_mask + for i in range(self.n_layers): + y = self.self_attn_layers[i](x, x, self_attn_mask) + y = self.drop(y) + x = self.norm_layers_0[i](x + y) + + y = self.ffn_layers[i](x, x_mask) + y = self.drop(y) + x = self.norm_layers_1[i](x + y) + x = x * x_mask + return x + + +class Encoder(nn.Module): + def __init__(self, hidden_channels, filter_channels, n_heads, n_layers, kernel_size=1, p_dropout=0., window_size=4, **kwargs): + super().__init__() + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.window_size = window_size + + self.drop = nn.Dropout(p_dropout) + self.attn_layers = nn.ModuleList() + self.norm_layers_1 = nn.ModuleList() + self.ffn_layers = nn.ModuleList() + self.norm_layers_2 = nn.ModuleList() + for i in range(self.n_layers): + self.attn_layers.append(MultiHeadAttention(hidden_channels, hidden_channels, n_heads, p_dropout=p_dropout, window_size=window_size)) + self.norm_layers_1.append(LayerNorm(hidden_channels)) + self.ffn_layers.append(FFN(hidden_channels, hidden_channels, filter_channels, kernel_size, p_dropout=p_dropout)) + self.norm_layers_2.append(LayerNorm(hidden_channels)) + + def forward(self, x, x_mask): + attn_mask = x_mask.unsqueeze(2) * x_mask.unsqueeze(-1) + x = x * x_mask + for i in range(self.n_layers): + y = self.attn_layers[i](x, x, attn_mask) + y = self.drop(y) + x = self.norm_layers_1[i](x + y) + + y = self.ffn_layers[i](x, x_mask) + y = self.drop(y) + x = self.norm_layers_2[i](x + y) + x = x * x_mask + return x + + +class Decoder(nn.Module): + def __init__(self, hidden_channels, filter_channels, n_heads, n_layers, kernel_size=1, p_dropout=0., proximal_bias=False, proximal_init=True, **kwargs): + super().__init__() + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.proximal_bias = proximal_bias + self.proximal_init = proximal_init + + self.drop = nn.Dropout(p_dropout) + self.self_attn_layers = nn.ModuleList() + self.norm_layers_0 = nn.ModuleList() + self.encdec_attn_layers = nn.ModuleList() + self.norm_layers_1 = nn.ModuleList() + self.ffn_layers = nn.ModuleList() + self.norm_layers_2 = nn.ModuleList() + for i in range(self.n_layers): + self.self_attn_layers.append(MultiHeadAttention(hidden_channels, hidden_channels, n_heads, p_dropout=p_dropout, proximal_bias=proximal_bias, proximal_init=proximal_init)) + self.norm_layers_0.append(LayerNorm(hidden_channels)) + self.encdec_attn_layers.append(MultiHeadAttention(hidden_channels, hidden_channels, n_heads, p_dropout=p_dropout)) + self.norm_layers_1.append(LayerNorm(hidden_channels)) + self.ffn_layers.append(FFN(hidden_channels, hidden_channels, filter_channels, kernel_size, p_dropout=p_dropout, causal=True)) + self.norm_layers_2.append(LayerNorm(hidden_channels)) + + def forward(self, x, x_mask, h, h_mask): + """ + x: decoder input + h: encoder output + """ + self_attn_mask = commons.subsequent_mask(x_mask.size(2)).to(device=x.device, dtype=x.dtype) + encdec_attn_mask = h_mask.unsqueeze(2) * x_mask.unsqueeze(-1) + x = x * x_mask + for i in range(self.n_layers): + y = self.self_attn_layers[i](x, x, self_attn_mask) + y = self.drop(y) + x = self.norm_layers_0[i](x + y) + + y = self.encdec_attn_layers[i](x, h, encdec_attn_mask) + y = self.drop(y) + x = self.norm_layers_1[i](x + y) + + y = self.ffn_layers[i](x, x_mask) + y = self.drop(y) + x = self.norm_layers_2[i](x + y) + x = x * x_mask + return x + + +class MultiHeadAttention(nn.Module): + def __init__(self, channels, out_channels, n_heads, p_dropout=0., window_size=None, heads_share=True, block_length=None, proximal_bias=False, proximal_init=False): + super().__init__() + assert channels % n_heads == 0 + + self.channels = channels + self.out_channels = out_channels + self.n_heads = n_heads + self.p_dropout = p_dropout + self.window_size = window_size + self.heads_share = heads_share + self.block_length = block_length + self.proximal_bias = proximal_bias + self.proximal_init = proximal_init + self.attn = None + + self.k_channels = channels // n_heads + self.conv_q = nn.Conv1d(channels, channels, 1) + self.conv_k = nn.Conv1d(channels, channels, 1) + self.conv_v = nn.Conv1d(channels, channels, 1) + self.conv_o = nn.Conv1d(channels, out_channels, 1) + self.drop = nn.Dropout(p_dropout) + + if window_size is not None: + n_heads_rel = 1 if heads_share else n_heads + rel_stddev = self.k_channels**-0.5 + self.emb_rel_k = nn.Parameter(torch.randn(n_heads_rel, window_size * 2 + 1, self.k_channels) * rel_stddev) + self.emb_rel_v = nn.Parameter(torch.randn(n_heads_rel, window_size * 2 + 1, self.k_channels) * rel_stddev) + + nn.init.xavier_uniform_(self.conv_q.weight) + nn.init.xavier_uniform_(self.conv_k.weight) + nn.init.xavier_uniform_(self.conv_v.weight) + if proximal_init: + with torch.no_grad(): + self.conv_k.weight.copy_(self.conv_q.weight) + self.conv_k.bias.copy_(self.conv_q.bias) + + def forward(self, x, c, attn_mask=None): + q = self.conv_q(x) + k = self.conv_k(c) + v = self.conv_v(c) + + x, self.attn = self.attention(q, k, v, mask=attn_mask) + + x = self.conv_o(x) + return x + + def attention(self, query, key, value, mask=None): + # reshape [b, d, t] -> [b, n_h, t, d_k] + b, d, t_s, t_t = (*key.size(), query.size(2)) + query = query.view(b, self.n_heads, self.k_channels, t_t).transpose(2, 3) + key = key.view(b, self.n_heads, self.k_channels, t_s).transpose(2, 3) + value = value.view(b, self.n_heads, self.k_channels, t_s).transpose(2, 3) + + scores = torch.matmul(query / math.sqrt(self.k_channels), key.transpose(-2, -1)) + if self.window_size is not None: + assert t_s == t_t, "Relative attention is only available for self-attention." + key_relative_embeddings = self._get_relative_embeddings(self.emb_rel_k, t_s) + rel_logits = self._matmul_with_relative_keys(query /math.sqrt(self.k_channels), key_relative_embeddings) + scores_local = self._relative_position_to_absolute_position(rel_logits) + scores = scores + scores_local + if self.proximal_bias: + assert t_s == t_t, "Proximal bias is only available for self-attention." + scores = scores + self._attention_bias_proximal(t_s).to(device=scores.device, dtype=scores.dtype) + if mask is not None: + scores = scores.masked_fill(mask == 0, -1e4) + if self.block_length is not None: + assert t_s == t_t, "Local attention is only available for self-attention." + block_mask = torch.ones_like(scores).triu(-self.block_length).tril(self.block_length) + scores = scores.masked_fill(block_mask == 0, -1e4) + p_attn = F.softmax(scores, dim=-1) # [b, n_h, t_t, t_s] + p_attn = self.drop(p_attn) + output = torch.matmul(p_attn, value) + if self.window_size is not None: + relative_weights = self._absolute_position_to_relative_position(p_attn) + value_relative_embeddings = self._get_relative_embeddings(self.emb_rel_v, t_s) + output = output + self._matmul_with_relative_values(relative_weights, value_relative_embeddings) + output = output.transpose(2, 3).contiguous().view(b, d, t_t) # [b, n_h, t_t, d_k] -> [b, d, t_t] + return output, p_attn + + def _matmul_with_relative_values(self, x, y): + """ + x: [b, h, l, m] + y: [h or 1, m, d] + ret: [b, h, l, d] + """ + ret = torch.matmul(x, y.unsqueeze(0)) + return ret + + def _matmul_with_relative_keys(self, x, y): + """ + x: [b, h, l, d] + y: [h or 1, m, d] + ret: [b, h, l, m] + """ + ret = torch.matmul(x, y.unsqueeze(0).transpose(-2, -1)) + return ret + + def _get_relative_embeddings(self, relative_embeddings, length): + max_relative_position = 2 * self.window_size + 1 + # Pad first before slice to avoid using cond ops. + pad_length = max(length - (self.window_size + 1), 0) + slice_start_position = max((self.window_size + 1) - length, 0) + slice_end_position = slice_start_position + 2 * length - 1 + if pad_length > 0: + padded_relative_embeddings = F.pad( + relative_embeddings, + commons.convert_pad_shape([[0, 0], [pad_length, pad_length], [0, 0]])) + else: + padded_relative_embeddings = relative_embeddings + used_relative_embeddings = padded_relative_embeddings[:,slice_start_position:slice_end_position] + return used_relative_embeddings + + def _relative_position_to_absolute_position(self, x): + """ + x: [b, h, l, 2*l-1] + ret: [b, h, l, l] + """ + batch, heads, length, _ = x.size() + # Concat columns of pad to shift from relative to absolute indexing. + x = F.pad(x, commons.convert_pad_shape([[0,0],[0,0],[0,0],[0,1]])) + + # Concat extra elements so to add up to shape (len+1, 2*len-1). + x_flat = x.view([batch, heads, length * 2 * length]) + x_flat = F.pad(x_flat, commons.convert_pad_shape([[0,0],[0,0],[0,length-1]])) + + # Reshape and slice out the padded elements. + x_final = x_flat.view([batch, heads, length+1, 2*length-1])[:, :, :length, length-1:] + return x_final + + def _absolute_position_to_relative_position(self, x): + """ + x: [b, h, l, l] + ret: [b, h, l, 2*l-1] + """ + batch, heads, length, _ = x.size() + # padd along column + x = F.pad(x, commons.convert_pad_shape([[0, 0], [0, 0], [0, 0], [0, length-1]])) + x_flat = x.view([batch, heads, length**2 + length*(length -1)]) + # add 0's in the beginning that will skew the elements after reshape + x_flat = F.pad(x_flat, commons.convert_pad_shape([[0, 0], [0, 0], [length, 0]])) + x_final = x_flat.view([batch, heads, length, 2*length])[:,:,:,1:] + return x_final + + def _attention_bias_proximal(self, length): + """Bias for self-attention to encourage attention to close positions. + Args: + length: an integer scalar. + Returns: + a Tensor with shape [1, 1, length, length] + """ + r = torch.arange(length, dtype=torch.float32) + diff = torch.unsqueeze(r, 0) - torch.unsqueeze(r, 1) + return torch.unsqueeze(torch.unsqueeze(-torch.log1p(torch.abs(diff)), 0), 0) + + +class FFN(nn.Module): + def __init__(self, in_channels, out_channels, filter_channels, kernel_size, p_dropout=0., activation=None, causal=False): + super().__init__() + self.in_channels = in_channels + self.out_channels = out_channels + self.filter_channels = filter_channels + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.activation = activation + self.causal = causal + + if causal: + self.padding = self._causal_padding + else: + self.padding = self._same_padding + + self.conv_1 = nn.Conv1d(in_channels, filter_channels, kernel_size) + self.conv_2 = nn.Conv1d(filter_channels, out_channels, kernel_size) + self.drop = nn.Dropout(p_dropout) + + def forward(self, x, x_mask): + x = self.conv_1(self.padding(x * x_mask)) + if self.activation == "gelu": + x = x * torch.sigmoid(1.702 * x) + else: + x = torch.relu(x) + x = self.drop(x) + x = self.conv_2(self.padding(x * x_mask)) + return x * x_mask + + def _causal_padding(self, x): + if self.kernel_size == 1: + return x + pad_l = self.kernel_size - 1 + pad_r = 0 + padding = [[0, 0], [0, 0], [pad_l, pad_r]] + x = F.pad(x, commons.convert_pad_shape(padding)) + return x + + def _same_padding(self, x): + if self.kernel_size == 1: + return x + pad_l = (self.kernel_size - 1) // 2 + pad_r = self.kernel_size // 2 + padding = [[0, 0], [0, 0], [pad_l, pad_r]] + x = F.pad(x, commons.convert_pad_shape(padding)) + return x diff --git a/modules/commons.py b/modules/commons.py new file mode 100644 index 0000000000000000000000000000000000000000..074888006392e956ce204d8368362dbb2cd4e304 --- /dev/null +++ b/modules/commons.py @@ -0,0 +1,188 @@ +import math +import numpy as np +import torch +from torch import nn +from torch.nn import functional as F + +def slice_pitch_segments(x, ids_str, segment_size=4): + ret = torch.zeros_like(x[:, :segment_size]) + for i in range(x.size(0)): + idx_str = ids_str[i] + idx_end = idx_str + segment_size + ret[i] = x[i, idx_str:idx_end] + return ret + +def rand_slice_segments_with_pitch(x, pitch, x_lengths=None, segment_size=4): + b, d, t = x.size() + if x_lengths is None: + x_lengths = t + ids_str_max = x_lengths - segment_size + 1 + ids_str = (torch.rand([b]).to(device=x.device) * ids_str_max).to(dtype=torch.long) + ret = slice_segments(x, ids_str, segment_size) + ret_pitch = slice_pitch_segments(pitch, ids_str, segment_size) + return ret, ret_pitch, ids_str + +def init_weights(m, mean=0.0, std=0.01): + classname = m.__class__.__name__ + if classname.find("Conv") != -1: + m.weight.data.normal_(mean, std) + + +def get_padding(kernel_size, dilation=1): + return int((kernel_size*dilation - dilation)/2) + + +def convert_pad_shape(pad_shape): + l = pad_shape[::-1] + pad_shape = [item for sublist in l for item in sublist] + return pad_shape + + +def intersperse(lst, item): + result = [item] * (len(lst) * 2 + 1) + result[1::2] = lst + return result + + +def kl_divergence(m_p, logs_p, m_q, logs_q): + """KL(P||Q)""" + kl = (logs_q - logs_p) - 0.5 + kl += 0.5 * (torch.exp(2. * logs_p) + ((m_p - m_q)**2)) * torch.exp(-2. * logs_q) + return kl + + +def rand_gumbel(shape): + """Sample from the Gumbel distribution, protect from overflows.""" + uniform_samples = torch.rand(shape) * 0.99998 + 0.00001 + return -torch.log(-torch.log(uniform_samples)) + + +def rand_gumbel_like(x): + g = rand_gumbel(x.size()).to(dtype=x.dtype, device=x.device) + return g + + +def slice_segments(x, ids_str, segment_size=4): + ret = torch.zeros_like(x[:, :, :segment_size]) + for i in range(x.size(0)): + idx_str = ids_str[i] + idx_end = idx_str + segment_size + ret[i] = x[i, :, idx_str:idx_end] + return ret + + +def rand_slice_segments(x, x_lengths=None, segment_size=4): + b, d, t = x.size() + if x_lengths is None: + x_lengths = t + ids_str_max = x_lengths - segment_size + 1 + ids_str = (torch.rand([b]).to(device=x.device) * ids_str_max).to(dtype=torch.long) + ret = slice_segments(x, ids_str, segment_size) + return ret, ids_str + + +def rand_spec_segments(x, x_lengths=None, segment_size=4): + b, d, t = x.size() + if x_lengths is None: + x_lengths = t + ids_str_max = x_lengths - segment_size + ids_str = (torch.rand([b]).to(device=x.device) * ids_str_max).to(dtype=torch.long) + ret = slice_segments(x, ids_str, segment_size) + return ret, ids_str + + +def get_timing_signal_1d( + length, channels, min_timescale=1.0, max_timescale=1.0e4): + position = torch.arange(length, dtype=torch.float) + num_timescales = channels // 2 + log_timescale_increment = ( + math.log(float(max_timescale) / float(min_timescale)) / + (num_timescales - 1)) + inv_timescales = min_timescale * torch.exp( + torch.arange(num_timescales, dtype=torch.float) * -log_timescale_increment) + scaled_time = position.unsqueeze(0) * inv_timescales.unsqueeze(1) + signal = torch.cat([torch.sin(scaled_time), torch.cos(scaled_time)], 0) + signal = F.pad(signal, [0, 0, 0, channels % 2]) + signal = signal.view(1, channels, length) + return signal + + +def add_timing_signal_1d(x, min_timescale=1.0, max_timescale=1.0e4): + b, channels, length = x.size() + signal = get_timing_signal_1d(length, channels, min_timescale, max_timescale) + return x + signal.to(dtype=x.dtype, device=x.device) + + +def cat_timing_signal_1d(x, min_timescale=1.0, max_timescale=1.0e4, axis=1): + b, channels, length = x.size() + signal = get_timing_signal_1d(length, channels, min_timescale, max_timescale) + return torch.cat([x, signal.to(dtype=x.dtype, device=x.device)], axis) + + +def subsequent_mask(length): + mask = torch.tril(torch.ones(length, length)).unsqueeze(0).unsqueeze(0) + return mask + + +@torch.jit.script +def fused_add_tanh_sigmoid_multiply(input_a, input_b, n_channels): + n_channels_int = n_channels[0] + in_act = input_a + input_b + t_act = torch.tanh(in_act[:, :n_channels_int, :]) + s_act = torch.sigmoid(in_act[:, n_channels_int:, :]) + acts = t_act * s_act + return acts + + +def convert_pad_shape(pad_shape): + l = pad_shape[::-1] + pad_shape = [item for sublist in l for item in sublist] + return pad_shape + + +def shift_1d(x): + x = F.pad(x, convert_pad_shape([[0, 0], [0, 0], [1, 0]]))[:, :, :-1] + return x + + +def sequence_mask(length, max_length=None): + if max_length is None: + max_length = length.max() + x = torch.arange(max_length, dtype=length.dtype, device=length.device) + return x.unsqueeze(0) < length.unsqueeze(1) + + +def generate_path(duration, mask): + """ + duration: [b, 1, t_x] + mask: [b, 1, t_y, t_x] + """ + device = duration.device + + b, _, t_y, t_x = mask.shape + cum_duration = torch.cumsum(duration, -1) + + cum_duration_flat = cum_duration.view(b * t_x) + path = sequence_mask(cum_duration_flat, t_y).to(mask.dtype) + path = path.view(b, t_x, t_y) + path = path - F.pad(path, convert_pad_shape([[0, 0], [1, 0], [0, 0]]))[:, :-1] + path = path.unsqueeze(1).transpose(2,3) * mask + return path + + +def clip_grad_value_(parameters, clip_value, norm_type=2): + if isinstance(parameters, torch.Tensor): + parameters = [parameters] + parameters = list(filter(lambda p: p.grad is not None, parameters)) + norm_type = float(norm_type) + if clip_value is not None: + clip_value = float(clip_value) + + total_norm = 0 + for p in parameters: + param_norm = p.grad.data.norm(norm_type) + total_norm += param_norm.item() ** norm_type + if clip_value is not None: + p.grad.data.clamp_(min=-clip_value, max=clip_value) + total_norm = total_norm ** (1. / norm_type) + return total_norm diff --git a/modules/crepe.py b/modules/crepe.py new file mode 100644 index 0000000000000000000000000000000000000000..b58c1680d02fef54497c36bd47a36776cc7f6af5 --- /dev/null +++ b/modules/crepe.py @@ -0,0 +1,331 @@ +from typing import Optional,Union +try: + from typing import Literal +except Exception as e: + from typing_extensions import Literal +import numpy as np +import torch +import torchcrepe +from torch import nn +from torch.nn import functional as F +import scipy + +#from:https://github.com/fishaudio/fish-diffusion + +def repeat_expand( + content: Union[torch.Tensor, np.ndarray], target_len: int, mode: str = "nearest" +): + """Repeat content to target length. + This is a wrapper of torch.nn.functional.interpolate. + + Args: + content (torch.Tensor): tensor + target_len (int): target length + mode (str, optional): interpolation mode. Defaults to "nearest". + + Returns: + torch.Tensor: tensor + """ + + ndim = content.ndim + + if content.ndim == 1: + content = content[None, None] + elif content.ndim == 2: + content = content[None] + + assert content.ndim == 3 + + is_np = isinstance(content, np.ndarray) + if is_np: + content = torch.from_numpy(content) + + results = torch.nn.functional.interpolate(content, size=target_len, mode=mode) + + if is_np: + results = results.numpy() + + if ndim == 1: + return results[0, 0] + elif ndim == 2: + return results[0] + + +class BasePitchExtractor: + def __init__( + self, + hop_length: int = 512, + f0_min: float = 50.0, + f0_max: float = 1100.0, + keep_zeros: bool = True, + ): + """Base pitch extractor. + + Args: + hop_length (int, optional): Hop length. Defaults to 512. + f0_min (float, optional): Minimum f0. Defaults to 50.0. + f0_max (float, optional): Maximum f0. Defaults to 1100.0. + keep_zeros (bool, optional): Whether keep zeros in pitch. Defaults to True. + """ + + self.hop_length = hop_length + self.f0_min = f0_min + self.f0_max = f0_max + self.keep_zeros = keep_zeros + + def __call__(self, x, sampling_rate=44100, pad_to=None): + raise NotImplementedError("BasePitchExtractor is not callable.") + + def post_process(self, x, sampling_rate, f0, pad_to): + if isinstance(f0, np.ndarray): + f0 = torch.from_numpy(f0).float().to(x.device) + + if pad_to is None: + return f0 + + f0 = repeat_expand(f0, pad_to) + + if self.keep_zeros: + return f0 + + vuv_vector = torch.zeros_like(f0) + vuv_vector[f0 > 0.0] = 1.0 + vuv_vector[f0 <= 0.0] = 0.0 + + # Remove 0 frequency and apply linear interpolation + nzindex = torch.nonzero(f0).squeeze() + f0 = torch.index_select(f0, dim=0, index=nzindex).cpu().numpy() + time_org = self.hop_length / sampling_rate * nzindex.cpu().numpy() + time_frame = np.arange(pad_to) * self.hop_length / sampling_rate + + if f0.shape[0] <= 0: + return torch.zeros(pad_to, dtype=torch.float, device=x.device),torch.zeros(pad_to, dtype=torch.float, device=x.device) + + if f0.shape[0] == 1: + return torch.ones(pad_to, dtype=torch.float, device=x.device) * f0[0],torch.ones(pad_to, dtype=torch.float, device=x.device) + + # Probably can be rewritten with torch? + f0 = np.interp(time_frame, time_org, f0, left=f0[0], right=f0[-1]) + vuv_vector = vuv_vector.cpu().numpy() + vuv_vector = np.ceil(scipy.ndimage.zoom(vuv_vector,pad_to/len(vuv_vector),order = 0)) + + return f0,vuv_vector + + +class MaskedAvgPool1d(nn.Module): + def __init__( + self, kernel_size: int, stride: Optional[int] = None, padding: Optional[int] = 0 + ): + """An implementation of mean pooling that supports masked values. + + Args: + kernel_size (int): The size of the median pooling window. + stride (int, optional): The stride of the median pooling window. Defaults to None. + padding (int, optional): The padding of the median pooling window. Defaults to 0. + """ + + super(MaskedAvgPool1d, self).__init__() + self.kernel_size = kernel_size + self.stride = stride or kernel_size + self.padding = padding + + def forward(self, x, mask=None): + ndim = x.dim() + if ndim == 2: + x = x.unsqueeze(1) + + assert ( + x.dim() == 3 + ), "Input tensor must have 2 or 3 dimensions (batch_size, channels, width)" + + # Apply the mask by setting masked elements to zero, or make NaNs zero + if mask is None: + mask = ~torch.isnan(x) + + # Ensure mask has the same shape as the input tensor + assert x.shape == mask.shape, "Input tensor and mask must have the same shape" + + masked_x = torch.where(mask, x, torch.zeros_like(x)) + # Create a ones kernel with the same number of channels as the input tensor + ones_kernel = torch.ones(x.size(1), 1, self.kernel_size, device=x.device) + + # Perform sum pooling + sum_pooled = nn.functional.conv1d( + masked_x, + ones_kernel, + stride=self.stride, + padding=self.padding, + groups=x.size(1), + ) + + # Count the non-masked (valid) elements in each pooling window + valid_count = nn.functional.conv1d( + mask.float(), + ones_kernel, + stride=self.stride, + padding=self.padding, + groups=x.size(1), + ) + valid_count = valid_count.clamp(min=1) # Avoid division by zero + + # Perform masked average pooling + avg_pooled = sum_pooled / valid_count + + # Fill zero values with NaNs + avg_pooled[avg_pooled == 0] = float("nan") + + if ndim == 2: + return avg_pooled.squeeze(1) + + return avg_pooled + + +class MaskedMedianPool1d(nn.Module): + def __init__( + self, kernel_size: int, stride: Optional[int] = None, padding: Optional[int] = 0 + ): + """An implementation of median pooling that supports masked values. + + This implementation is inspired by the median pooling implementation in + https://gist.github.com/rwightman/f2d3849281624be7c0f11c85c87c1598 + + Args: + kernel_size (int): The size of the median pooling window. + stride (int, optional): The stride of the median pooling window. Defaults to None. + padding (int, optional): The padding of the median pooling window. Defaults to 0. + """ + + super(MaskedMedianPool1d, self).__init__() + self.kernel_size = kernel_size + self.stride = stride or kernel_size + self.padding = padding + + def forward(self, x, mask=None): + ndim = x.dim() + if ndim == 2: + x = x.unsqueeze(1) + + assert ( + x.dim() == 3 + ), "Input tensor must have 2 or 3 dimensions (batch_size, channels, width)" + + if mask is None: + mask = ~torch.isnan(x) + + assert x.shape == mask.shape, "Input tensor and mask must have the same shape" + + masked_x = torch.where(mask, x, torch.zeros_like(x)) + + x = F.pad(masked_x, (self.padding, self.padding), mode="reflect") + mask = F.pad( + mask.float(), (self.padding, self.padding), mode="constant", value=0 + ) + + x = x.unfold(2, self.kernel_size, self.stride) + mask = mask.unfold(2, self.kernel_size, self.stride) + + x = x.contiguous().view(x.size()[:3] + (-1,)) + mask = mask.contiguous().view(mask.size()[:3] + (-1,)).to(x.device) + + # Combine the mask with the input tensor + #x_masked = torch.where(mask.bool(), x, torch.fill_(torch.zeros_like(x),float("inf"))) + x_masked = torch.where(mask.bool(), x, torch.FloatTensor([float("inf")]).to(x.device)) + + # Sort the masked tensor along the last dimension + x_sorted, _ = torch.sort(x_masked, dim=-1) + + # Compute the count of non-masked (valid) values + valid_count = mask.sum(dim=-1) + + # Calculate the index of the median value for each pooling window + median_idx = (torch.div((valid_count - 1), 2, rounding_mode='trunc')).clamp(min=0) + + # Gather the median values using the calculated indices + median_pooled = x_sorted.gather(-1, median_idx.unsqueeze(-1).long()).squeeze(-1) + + # Fill infinite values with NaNs + median_pooled[torch.isinf(median_pooled)] = float("nan") + + if ndim == 2: + return median_pooled.squeeze(1) + + return median_pooled + + +class CrepePitchExtractor(BasePitchExtractor): + def __init__( + self, + hop_length: int = 512, + f0_min: float = 50.0, + f0_max: float = 1100.0, + threshold: float = 0.05, + keep_zeros: bool = False, + device = None, + model: Literal["full", "tiny"] = "full", + use_fast_filters: bool = True, + ): + super().__init__(hop_length, f0_min, f0_max, keep_zeros) + + self.threshold = threshold + self.model = model + self.use_fast_filters = use_fast_filters + self.hop_length = hop_length + if device is None: + self.dev = torch.device("cuda" if torch.cuda.is_available() else "cpu") + else: + self.dev = torch.device(device) + if self.use_fast_filters: + self.median_filter = MaskedMedianPool1d(3, 1, 1).to(device) + self.mean_filter = MaskedAvgPool1d(3, 1, 1).to(device) + + def __call__(self, x, sampling_rate=44100, pad_to=None): + """Extract pitch using crepe. + + + Args: + x (torch.Tensor): Audio signal, shape (1, T). + sampling_rate (int, optional): Sampling rate. Defaults to 44100. + pad_to (int, optional): Pad to length. Defaults to None. + + Returns: + torch.Tensor: Pitch, shape (T // hop_length,). + """ + + assert x.ndim == 2, f"Expected 2D tensor, got {x.ndim}D tensor." + assert x.shape[0] == 1, f"Expected 1 channel, got {x.shape[0]} channels." + + x = x.to(self.dev) + f0, pd = torchcrepe.predict( + x, + sampling_rate, + self.hop_length, + self.f0_min, + self.f0_max, + pad=True, + model=self.model, + batch_size=1024, + device=x.device, + return_periodicity=True, + ) + + # Filter, remove silence, set uv threshold, refer to the original warehouse readme + if self.use_fast_filters: + pd = self.median_filter(pd) + else: + pd = torchcrepe.filter.median(pd, 3) + + pd = torchcrepe.threshold.Silence(-60.0)(pd, x, sampling_rate, 512) + f0 = torchcrepe.threshold.At(self.threshold)(f0, pd) + + if self.use_fast_filters: + f0 = self.mean_filter(f0) + else: + f0 = torchcrepe.filter.mean(f0, 3) + + f0 = torch.where(torch.isnan(f0), torch.full_like(f0, 0), f0)[0] + + if torch.all(f0 == 0): + rtn = f0.cpu().numpy() if pad_to==None else np.zeros(pad_to) + return rtn,rtn + + return self.post_process(x, sampling_rate, f0, pad_to) diff --git a/modules/enhancer.py b/modules/enhancer.py new file mode 100644 index 0000000000000000000000000000000000000000..37676311f7d8dc4ddc2a5244dedc27b2437e04f5 --- /dev/null +++ b/modules/enhancer.py @@ -0,0 +1,105 @@ +import numpy as np +import torch +import torch.nn.functional as F +from vdecoder.nsf_hifigan.nvSTFT import STFT +from vdecoder.nsf_hifigan.models import load_model +from torchaudio.transforms import Resample + +class Enhancer: + def __init__(self, enhancer_type, enhancer_ckpt, device=None): + if device is None: + device = 'cuda' if torch.cuda.is_available() else 'cpu' + self.device = device + + if enhancer_type == 'nsf-hifigan': + self.enhancer = NsfHifiGAN(enhancer_ckpt, device=self.device) + else: + raise ValueError(f" [x] Unknown enhancer: {enhancer_type}") + + self.resample_kernel = {} + self.enhancer_sample_rate = self.enhancer.sample_rate() + self.enhancer_hop_size = self.enhancer.hop_size() + + def enhance(self, + audio, # 1, T + sample_rate, + f0, # 1, n_frames, 1 + hop_size, + adaptive_key = 0, + silence_front = 0 + ): + # enhancer start time + start_frame = int(silence_front * sample_rate / hop_size) + real_silence_front = start_frame * hop_size / sample_rate + audio = audio[:, int(np.round(real_silence_front * sample_rate)) : ] + f0 = f0[: , start_frame :, :] + + # adaptive parameters + adaptive_factor = 2 ** ( -adaptive_key / 12) + adaptive_sample_rate = 100 * int(np.round(self.enhancer_sample_rate / adaptive_factor / 100)) + real_factor = self.enhancer_sample_rate / adaptive_sample_rate + + # resample the ddsp output + if sample_rate == adaptive_sample_rate: + audio_res = audio + else: + key_str = str(sample_rate) + str(adaptive_sample_rate) + if key_str not in self.resample_kernel: + self.resample_kernel[key_str] = Resample(sample_rate, adaptive_sample_rate, lowpass_filter_width = 128).to(self.device) + audio_res = self.resample_kernel[key_str](audio) + + n_frames = int(audio_res.size(-1) // self.enhancer_hop_size + 1) + + # resample f0 + f0_np = f0.squeeze(0).squeeze(-1).cpu().numpy() + f0_np *= real_factor + time_org = (hop_size / sample_rate) * np.arange(len(f0_np)) / real_factor + time_frame = (self.enhancer_hop_size / self.enhancer_sample_rate) * np.arange(n_frames) + f0_res = np.interp(time_frame, time_org, f0_np, left=f0_np[0], right=f0_np[-1]) + f0_res = torch.from_numpy(f0_res).unsqueeze(0).float().to(self.device) # 1, n_frames + + # enhance + enhanced_audio, enhancer_sample_rate = self.enhancer(audio_res, f0_res) + + # resample the enhanced output + if adaptive_factor != 0: + key_str = str(adaptive_sample_rate) + str(enhancer_sample_rate) + if key_str not in self.resample_kernel: + self.resample_kernel[key_str] = Resample(adaptive_sample_rate, enhancer_sample_rate, lowpass_filter_width = 128).to(self.device) + enhanced_audio = self.resample_kernel[key_str](enhanced_audio) + + # pad the silence frames + if start_frame > 0: + enhanced_audio = F.pad(enhanced_audio, (int(np.round(enhancer_sample_rate * real_silence_front)), 0)) + + return enhanced_audio, enhancer_sample_rate + + +class NsfHifiGAN(torch.nn.Module): + def __init__(self, model_path, device=None): + super().__init__() + if device is None: + device = 'cuda' if torch.cuda.is_available() else 'cpu' + self.device = device + print('| Load HifiGAN: ', model_path) + self.model, self.h = load_model(model_path, device=self.device) + + def sample_rate(self): + return self.h.sampling_rate + + def hop_size(self): + return self.h.hop_size + + def forward(self, audio, f0): + stft = STFT( + self.h.sampling_rate, + self.h.num_mels, + self.h.n_fft, + self.h.win_size, + self.h.hop_size, + self.h.fmin, + self.h.fmax) + with torch.no_grad(): + mel = stft.get_mel(audio) + enhanced_audio = self.model(mel, f0[:,:mel.size(-1)]).view(-1) + return enhanced_audio, self.h.sampling_rate \ No newline at end of file diff --git a/modules/losses.py b/modules/losses.py new file mode 100644 index 0000000000000000000000000000000000000000..cd21799eccde350c3aac0bdd661baf96ed220147 --- /dev/null +++ b/modules/losses.py @@ -0,0 +1,61 @@ +import torch +from torch.nn import functional as F + +import modules.commons as commons + + +def feature_loss(fmap_r, fmap_g): + loss = 0 + for dr, dg in zip(fmap_r, fmap_g): + for rl, gl in zip(dr, dg): + rl = rl.float().detach() + gl = gl.float() + loss += torch.mean(torch.abs(rl - gl)) + + return loss * 2 + + +def discriminator_loss(disc_real_outputs, disc_generated_outputs): + loss = 0 + r_losses = [] + g_losses = [] + for dr, dg in zip(disc_real_outputs, disc_generated_outputs): + dr = dr.float() + dg = dg.float() + r_loss = torch.mean((1-dr)**2) + g_loss = torch.mean(dg**2) + loss += (r_loss + g_loss) + r_losses.append(r_loss.item()) + g_losses.append(g_loss.item()) + + return loss, r_losses, g_losses + + +def generator_loss(disc_outputs): + loss = 0 + gen_losses = [] + for dg in disc_outputs: + dg = dg.float() + l = torch.mean((1-dg)**2) + gen_losses.append(l) + loss += l + + return loss, gen_losses + + +def kl_loss(z_p, logs_q, m_p, logs_p, z_mask): + """ + z_p, logs_q: [b, h, t_t] + m_p, logs_p: [b, h, t_t] + """ + z_p = z_p.float() + logs_q = logs_q.float() + m_p = m_p.float() + logs_p = logs_p.float() + z_mask = z_mask.float() + #print(logs_p) + kl = logs_p - logs_q - 0.5 + kl += 0.5 * ((z_p - m_p)**2) * torch.exp(-2. * logs_p) + kl = torch.sum(kl * z_mask) + l = kl / torch.sum(z_mask) + return l diff --git a/modules/mel_processing.py b/modules/mel_processing.py new file mode 100644 index 0000000000000000000000000000000000000000..99c5b35beb83f3b288af0fac5b49ebf2c69f062c --- /dev/null +++ b/modules/mel_processing.py @@ -0,0 +1,112 @@ +import math +import os +import random +import torch +from torch import nn +import torch.nn.functional as F +import torch.utils.data +import numpy as np +import librosa +import librosa.util as librosa_util +from librosa.util import normalize, pad_center, tiny +from scipy.signal import get_window +from scipy.io.wavfile import read +from librosa.filters import mel as librosa_mel_fn + +MAX_WAV_VALUE = 32768.0 + + +def dynamic_range_compression_torch(x, C=1, clip_val=1e-5): + """ + PARAMS + ------ + C: compression factor + """ + return torch.log(torch.clamp(x, min=clip_val) * C) + + +def dynamic_range_decompression_torch(x, C=1): + """ + PARAMS + ------ + C: compression factor used to compress + """ + return torch.exp(x) / C + + +def spectral_normalize_torch(magnitudes): + output = dynamic_range_compression_torch(magnitudes) + return output + + +def spectral_de_normalize_torch(magnitudes): + output = dynamic_range_decompression_torch(magnitudes) + return output + + +mel_basis = {} +hann_window = {} + + +def spectrogram_torch(y, n_fft, sampling_rate, hop_size, win_size, center=False): + if torch.min(y) < -1.: + print('min value is ', torch.min(y)) + if torch.max(y) > 1.: + print('max value is ', torch.max(y)) + + global hann_window + dtype_device = str(y.dtype) + '_' + str(y.device) + wnsize_dtype_device = str(win_size) + '_' + dtype_device + if wnsize_dtype_device not in hann_window: + hann_window[wnsize_dtype_device] = torch.hann_window(win_size).to(dtype=y.dtype, device=y.device) + + y = torch.nn.functional.pad(y.unsqueeze(1), (int((n_fft-hop_size)/2), int((n_fft-hop_size)/2)), mode='reflect') + y = y.squeeze(1) + + spec = torch.stft(y, n_fft, hop_length=hop_size, win_length=win_size, window=hann_window[wnsize_dtype_device], + center=center, pad_mode='reflect', normalized=False, onesided=True, return_complex=False) + + spec = torch.sqrt(spec.pow(2).sum(-1) + 1e-6) + return spec + + +def spec_to_mel_torch(spec, n_fft, num_mels, sampling_rate, fmin, fmax): + global mel_basis + dtype_device = str(spec.dtype) + '_' + str(spec.device) + fmax_dtype_device = str(fmax) + '_' + dtype_device + if fmax_dtype_device not in mel_basis: + mel = librosa_mel_fn(sr=sampling_rate, n_fft=n_fft, n_mels=num_mels, fmin=fmin, fmax=fmax) + mel_basis[fmax_dtype_device] = torch.from_numpy(mel).to(dtype=spec.dtype, device=spec.device) + spec = torch.matmul(mel_basis[fmax_dtype_device], spec) + spec = spectral_normalize_torch(spec) + return spec + + +def mel_spectrogram_torch(y, n_fft, num_mels, sampling_rate, hop_size, win_size, fmin, fmax, center=False): + if torch.min(y) < -1.: + print('min value is ', torch.min(y)) + if torch.max(y) > 1.: + print('max value is ', torch.max(y)) + + global mel_basis, hann_window + dtype_device = str(y.dtype) + '_' + str(y.device) + fmax_dtype_device = str(fmax) + '_' + dtype_device + wnsize_dtype_device = str(win_size) + '_' + dtype_device + if fmax_dtype_device not in mel_basis: + mel = librosa_mel_fn(sr=sampling_rate, n_fft=n_fft, n_mels=num_mels, fmin=fmin, fmax=fmax) + mel_basis[fmax_dtype_device] = torch.from_numpy(mel).to(dtype=y.dtype, device=y.device) + if wnsize_dtype_device not in hann_window: + hann_window[wnsize_dtype_device] = torch.hann_window(win_size).to(dtype=y.dtype, device=y.device) + + y = torch.nn.functional.pad(y.unsqueeze(1), (int((n_fft-hop_size)/2), int((n_fft-hop_size)/2)), mode='reflect') + y = y.squeeze(1) + + spec = torch.stft(y, n_fft, hop_length=hop_size, win_length=win_size, window=hann_window[wnsize_dtype_device], + center=center, pad_mode='reflect', normalized=False, onesided=True, return_complex=False) + + spec = torch.sqrt(spec.pow(2).sum(-1) + 1e-6) + + spec = torch.matmul(mel_basis[fmax_dtype_device], spec) + spec = spectral_normalize_torch(spec) + + return spec diff --git a/modules/modules.py b/modules/modules.py new file mode 100644 index 0000000000000000000000000000000000000000..54290fd207b25e93831bd21005990ea137e6b50e --- /dev/null +++ b/modules/modules.py @@ -0,0 +1,342 @@ +import copy +import math +import numpy as np +import scipy +import torch +from torch import nn +from torch.nn import functional as F + +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm + +import modules.commons as commons +from modules.commons import init_weights, get_padding + + +LRELU_SLOPE = 0.1 + + +class LayerNorm(nn.Module): + def __init__(self, channels, eps=1e-5): + super().__init__() + self.channels = channels + self.eps = eps + + self.gamma = nn.Parameter(torch.ones(channels)) + self.beta = nn.Parameter(torch.zeros(channels)) + + def forward(self, x): + x = x.transpose(1, -1) + x = F.layer_norm(x, (self.channels,), self.gamma, self.beta, self.eps) + return x.transpose(1, -1) + + +class ConvReluNorm(nn.Module): + def __init__(self, in_channels, hidden_channels, out_channels, kernel_size, n_layers, p_dropout): + super().__init__() + self.in_channels = in_channels + self.hidden_channels = hidden_channels + self.out_channels = out_channels + self.kernel_size = kernel_size + self.n_layers = n_layers + self.p_dropout = p_dropout + assert n_layers > 1, "Number of layers should be larger than 0." + + self.conv_layers = nn.ModuleList() + self.norm_layers = nn.ModuleList() + self.conv_layers.append(nn.Conv1d(in_channels, hidden_channels, kernel_size, padding=kernel_size//2)) + self.norm_layers.append(LayerNorm(hidden_channels)) + self.relu_drop = nn.Sequential( + nn.ReLU(), + nn.Dropout(p_dropout)) + for _ in range(n_layers-1): + self.conv_layers.append(nn.Conv1d(hidden_channels, hidden_channels, kernel_size, padding=kernel_size//2)) + self.norm_layers.append(LayerNorm(hidden_channels)) + self.proj = nn.Conv1d(hidden_channels, out_channels, 1) + self.proj.weight.data.zero_() + self.proj.bias.data.zero_() + + def forward(self, x, x_mask): + x_org = x + for i in range(self.n_layers): + x = self.conv_layers[i](x * x_mask) + x = self.norm_layers[i](x) + x = self.relu_drop(x) + x = x_org + self.proj(x) + return x * x_mask + + +class DDSConv(nn.Module): + """ + Dialted and Depth-Separable Convolution + """ + def __init__(self, channels, kernel_size, n_layers, p_dropout=0.): + super().__init__() + self.channels = channels + self.kernel_size = kernel_size + self.n_layers = n_layers + self.p_dropout = p_dropout + + self.drop = nn.Dropout(p_dropout) + self.convs_sep = nn.ModuleList() + self.convs_1x1 = nn.ModuleList() + self.norms_1 = nn.ModuleList() + self.norms_2 = nn.ModuleList() + for i in range(n_layers): + dilation = kernel_size ** i + padding = (kernel_size * dilation - dilation) // 2 + self.convs_sep.append(nn.Conv1d(channels, channels, kernel_size, + groups=channels, dilation=dilation, padding=padding + )) + self.convs_1x1.append(nn.Conv1d(channels, channels, 1)) + self.norms_1.append(LayerNorm(channels)) + self.norms_2.append(LayerNorm(channels)) + + def forward(self, x, x_mask, g=None): + if g is not None: + x = x + g + for i in range(self.n_layers): + y = self.convs_sep[i](x * x_mask) + y = self.norms_1[i](y) + y = F.gelu(y) + y = self.convs_1x1[i](y) + y = self.norms_2[i](y) + y = F.gelu(y) + y = self.drop(y) + x = x + y + return x * x_mask + + +class WN(torch.nn.Module): + def __init__(self, hidden_channels, kernel_size, dilation_rate, n_layers, gin_channels=0, p_dropout=0): + super(WN, self).__init__() + assert(kernel_size % 2 == 1) + self.hidden_channels =hidden_channels + self.kernel_size = kernel_size, + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.gin_channels = gin_channels + self.p_dropout = p_dropout + + self.in_layers = torch.nn.ModuleList() + self.res_skip_layers = torch.nn.ModuleList() + self.drop = nn.Dropout(p_dropout) + + if gin_channels != 0: + cond_layer = torch.nn.Conv1d(gin_channels, 2*hidden_channels*n_layers, 1) + self.cond_layer = torch.nn.utils.weight_norm(cond_layer, name='weight') + + for i in range(n_layers): + dilation = dilation_rate ** i + padding = int((kernel_size * dilation - dilation) / 2) + in_layer = torch.nn.Conv1d(hidden_channels, 2*hidden_channels, kernel_size, + dilation=dilation, padding=padding) + in_layer = torch.nn.utils.weight_norm(in_layer, name='weight') + self.in_layers.append(in_layer) + + # last one is not necessary + if i < n_layers - 1: + res_skip_channels = 2 * hidden_channels + else: + res_skip_channels = hidden_channels + + res_skip_layer = torch.nn.Conv1d(hidden_channels, res_skip_channels, 1) + res_skip_layer = torch.nn.utils.weight_norm(res_skip_layer, name='weight') + self.res_skip_layers.append(res_skip_layer) + + def forward(self, x, x_mask, g=None, **kwargs): + output = torch.zeros_like(x) + n_channels_tensor = torch.IntTensor([self.hidden_channels]) + + if g is not None: + g = self.cond_layer(g) + + for i in range(self.n_layers): + x_in = self.in_layers[i](x) + if g is not None: + cond_offset = i * 2 * self.hidden_channels + g_l = g[:,cond_offset:cond_offset+2*self.hidden_channels,:] + else: + g_l = torch.zeros_like(x_in) + + acts = commons.fused_add_tanh_sigmoid_multiply( + x_in, + g_l, + n_channels_tensor) + acts = self.drop(acts) + + res_skip_acts = self.res_skip_layers[i](acts) + if i < self.n_layers - 1: + res_acts = res_skip_acts[:,:self.hidden_channels,:] + x = (x + res_acts) * x_mask + output = output + res_skip_acts[:,self.hidden_channels:,:] + else: + output = output + res_skip_acts + return output * x_mask + + def remove_weight_norm(self): + if self.gin_channels != 0: + torch.nn.utils.remove_weight_norm(self.cond_layer) + for l in self.in_layers: + torch.nn.utils.remove_weight_norm(l) + for l in self.res_skip_layers: + torch.nn.utils.remove_weight_norm(l) + + +class ResBlock1(torch.nn.Module): + def __init__(self, channels, kernel_size=3, dilation=(1, 3, 5)): + super(ResBlock1, self).__init__() + self.convs1 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[2], + padding=get_padding(kernel_size, dilation[2]))) + ]) + self.convs1.apply(init_weights) + + self.convs2 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))) + ]) + self.convs2.apply(init_weights) + + def forward(self, x, x_mask=None): + for c1, c2 in zip(self.convs1, self.convs2): + xt = F.leaky_relu(x, LRELU_SLOPE) + if x_mask is not None: + xt = xt * x_mask + xt = c1(xt) + xt = F.leaky_relu(xt, LRELU_SLOPE) + if x_mask is not None: + xt = xt * x_mask + xt = c2(xt) + x = xt + x + if x_mask is not None: + x = x * x_mask + return x + + def remove_weight_norm(self): + for l in self.convs1: + remove_weight_norm(l) + for l in self.convs2: + remove_weight_norm(l) + + +class ResBlock2(torch.nn.Module): + def __init__(self, channels, kernel_size=3, dilation=(1, 3)): + super(ResBlock2, self).__init__() + self.convs = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))) + ]) + self.convs.apply(init_weights) + + def forward(self, x, x_mask=None): + for c in self.convs: + xt = F.leaky_relu(x, LRELU_SLOPE) + if x_mask is not None: + xt = xt * x_mask + xt = c(xt) + x = xt + x + if x_mask is not None: + x = x * x_mask + return x + + def remove_weight_norm(self): + for l in self.convs: + remove_weight_norm(l) + + +class Log(nn.Module): + def forward(self, x, x_mask, reverse=False, **kwargs): + if not reverse: + y = torch.log(torch.clamp_min(x, 1e-5)) * x_mask + logdet = torch.sum(-y, [1, 2]) + return y, logdet + else: + x = torch.exp(x) * x_mask + return x + + +class Flip(nn.Module): + def forward(self, x, *args, reverse=False, **kwargs): + x = torch.flip(x, [1]) + if not reverse: + logdet = torch.zeros(x.size(0)).to(dtype=x.dtype, device=x.device) + return x, logdet + else: + return x + + +class ElementwiseAffine(nn.Module): + def __init__(self, channels): + super().__init__() + self.channels = channels + self.m = nn.Parameter(torch.zeros(channels,1)) + self.logs = nn.Parameter(torch.zeros(channels,1)) + + def forward(self, x, x_mask, reverse=False, **kwargs): + if not reverse: + y = self.m + torch.exp(self.logs) * x + y = y * x_mask + logdet = torch.sum(self.logs * x_mask, [1,2]) + return y, logdet + else: + x = (x - self.m) * torch.exp(-self.logs) * x_mask + return x + + +class ResidualCouplingLayer(nn.Module): + def __init__(self, + channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + p_dropout=0, + gin_channels=0, + mean_only=False): + assert channels % 2 == 0, "channels should be divisible by 2" + super().__init__() + self.channels = channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.half_channels = channels // 2 + self.mean_only = mean_only + + self.pre = nn.Conv1d(self.half_channels, hidden_channels, 1) + self.enc = WN(hidden_channels, kernel_size, dilation_rate, n_layers, p_dropout=p_dropout, gin_channels=gin_channels) + self.post = nn.Conv1d(hidden_channels, self.half_channels * (2 - mean_only), 1) + self.post.weight.data.zero_() + self.post.bias.data.zero_() + + def forward(self, x, x_mask, g=None, reverse=False): + x0, x1 = torch.split(x, [self.half_channels]*2, 1) + h = self.pre(x0) * x_mask + h = self.enc(h, x_mask, g=g) + stats = self.post(h) * x_mask + if not self.mean_only: + m, logs = torch.split(stats, [self.half_channels]*2, 1) + else: + m = stats + logs = torch.zeros_like(m) + + if not reverse: + x1 = m + x1 * torch.exp(logs) * x_mask + x = torch.cat([x0, x1], 1) + logdet = torch.sum(logs, [1,2]) + return x, logdet + else: + x1 = (x1 - m) * torch.exp(-logs) * x_mask + x = torch.cat([x0, x1], 1) + return x diff --git a/onnx_export.py b/onnx_export.py new file mode 100644 index 0000000000000000000000000000000000000000..e392523c54d8a2f264924fe9db1b15c72f2222a3 --- /dev/null +++ b/onnx_export.py @@ -0,0 +1,56 @@ +import torch +from onnxexport.model_onnx import SynthesizerTrn +import utils + +def main(NetExport): + path = "SoVits4.0" + if NetExport: + device = torch.device("cpu") + hps = utils.get_hparams_from_file(f"checkpoints/{path}/config.json") + SVCVITS = SynthesizerTrn( + hps.data.filter_length // 2 + 1, + hps.train.segment_size // hps.data.hop_length, + **hps.model) + _ = utils.load_checkpoint(f"checkpoints/{path}/model.pth", SVCVITS, None) + _ = SVCVITS.eval().to(device) + for i in SVCVITS.parameters(): + i.requires_grad = False + + n_frame = 10 + hidden_channels = 256 #(Hubert's shape[2]) + + test_hidden_unit = torch.rand(1, n_frame, hidden_channels) + test_pitch = torch.rand(1, n_frame) + test_mel2ph = torch.arange(0, n_frame, dtype=torch.int64)[None] # torch.LongTensor([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]).unsqueeze(0) + test_uv = torch.ones(1, n_frame, dtype=torch.float32) + test_noise = torch.randn(1, 192, n_frame) + test_sid = torch.LongTensor([0]) + input_names = ["c", "f0", "mel2ph", "uv", "noise", "sid"] + output_names = ["audio", ] + + torch.onnx.export(SVCVITS, + ( + test_hidden_unit.to(device), + test_pitch.to(device), + test_mel2ph.to(device), + test_uv.to(device), + test_noise.to(device), + test_sid.to(device) + ), + f"checkpoints/{path}/model.onnx", + dynamic_axes={ + "c": [0, 1], + "f0": [1], + "mel2ph": [1], + "uv": [1], + "noise": [2], + }, + do_constant_folding=False, + opset_version=16, + verbose=False, + input_names=input_names, + output_names=output_names) + + +if __name__ == '__main__': + main(True) diff --git a/onnx_export_speaker_mix.py b/onnx_export_speaker_mix.py new file mode 100644 index 0000000000000000000000000000000000000000..dc0a9bdda9c8f17679f74d9e1c5e521e7d98f2c6 --- /dev/null +++ b/onnx_export_speaker_mix.py @@ -0,0 +1,106 @@ +import torch +from torchaudio.models.wav2vec2.utils import import_fairseq_model +from fairseq import checkpoint_utils +from onnxexport.model_onnx_speaker_mix import SynthesizerTrn +import utils + +def get_hubert_model(): + vec_path = "hubert/checkpoint_best_legacy_500.pt" + print("load model(s) from {}".format(vec_path)) + models, saved_cfg, task = checkpoint_utils.load_model_ensemble_and_task( + [vec_path], + suffix="", + ) + model = models[0] + model.eval() + return model + + +def main(HubertExport, NetExport): + path = "SoVits4.0" + + '''if HubertExport: + device = torch.device("cpu") + vec_path = "hubert/checkpoint_best_legacy_500.pt" + models, saved_cfg, task = checkpoint_utils.load_model_ensemble_and_task( + [vec_path], + suffix="", + ) + original = models[0] + original.eval() + model = original + test_input = torch.rand(1, 1, 16000) + model(test_input) + torch.onnx.export(model, + test_input, + "hubert4.0.onnx", + export_params=True, + opset_version=16, + do_constant_folding=True, + input_names=['source'], + output_names=['embed'], + dynamic_axes={ + 'source': + { + 2: "sample_length" + }, + } + )''' + if NetExport: + device = torch.device("cpu") + hps = utils.get_hparams_from_file(f"checkpoints/{path}/config.json") + SVCVITS = SynthesizerTrn( + hps.data.filter_length // 2 + 1, + hps.train.segment_size // hps.data.hop_length, + **hps.model) + _ = utils.load_checkpoint(f"checkpoints/{path}/model.pth", SVCVITS, None) + _ = SVCVITS.eval().to(device) + for i in SVCVITS.parameters(): + i.requires_grad = False + test_hidden_unit = torch.rand(1, 10, SVCVITS.gin_channels) + test_pitch = torch.rand(1, 10) + test_mel2ph = torch.LongTensor([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]).unsqueeze(0) + test_uv = torch.ones(1, 10, dtype=torch.float32) + test_noise = torch.randn(1, 192, 10) + + export_mix = False + + test_sid = torch.LongTensor([0]) + spk_mix = [] + if export_mix: + n_spk = len(hps.spk) + for i in range(n_spk): + spk_mix.append(1.0/float(n_spk)) + test_sid = torch.tensor(spk_mix) + SVCVITS.export_chara_mix(n_spk) + + input_names = ["c", "f0", "mel2ph", "uv", "noise", "sid"] + output_names = ["audio", ] + SVCVITS.eval() + + torch.onnx.export(SVCVITS, + ( + test_hidden_unit.to(device), + test_pitch.to(device), + test_mel2ph.to(device), + test_uv.to(device), + test_noise.to(device), + test_sid.to(device) + ), + f"checkpoints/{path}/model.onnx", + dynamic_axes={ + "c": [0, 1], + "f0": [1], + "mel2ph": [1], + "uv": [1], + "noise": [2], + }, + do_constant_folding=False, + opset_version=16, + verbose=False, + input_names=input_names, + output_names=output_names) + + +if __name__ == '__main__': + main(False, True) diff --git a/onnxexport/model_onnx.py b/onnxexport/model_onnx.py new file mode 100644 index 0000000000000000000000000000000000000000..e28bae95ec1e53aa05d06fc784ff86d55f228d60 --- /dev/null +++ b/onnxexport/model_onnx.py @@ -0,0 +1,335 @@ +import torch +from torch import nn +from torch.nn import functional as F + +import modules.attentions as attentions +import modules.commons as commons +import modules.modules as modules + +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm, spectral_norm + +import utils +from modules.commons import init_weights, get_padding +from vdecoder.hifigan.models import Generator +from utils import f0_to_coarse + + +class ResidualCouplingBlock(nn.Module): + def __init__(self, + channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + n_flows=4, + gin_channels=0): + super().__init__() + self.channels = channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.n_flows = n_flows + self.gin_channels = gin_channels + + self.flows = nn.ModuleList() + for i in range(n_flows): + self.flows.append( + modules.ResidualCouplingLayer(channels, hidden_channels, kernel_size, dilation_rate, n_layers, + gin_channels=gin_channels, mean_only=True)) + self.flows.append(modules.Flip()) + + def forward(self, x, x_mask, g=None, reverse=False): + if not reverse: + for flow in self.flows: + x, _ = flow(x, x_mask, g=g, reverse=reverse) + else: + for flow in reversed(self.flows): + x = flow(x, x_mask, g=g, reverse=reverse) + return x + + +class Encoder(nn.Module): + def __init__(self, + in_channels, + out_channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + gin_channels=0): + super().__init__() + self.in_channels = in_channels + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.gin_channels = gin_channels + + self.pre = nn.Conv1d(in_channels, hidden_channels, 1) + self.enc = modules.WN(hidden_channels, kernel_size, dilation_rate, n_layers, gin_channels=gin_channels) + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + + def forward(self, x, x_lengths, g=None): + # print(x.shape,x_lengths.shape) + x_mask = torch.unsqueeze(commons.sequence_mask(x_lengths, x.size(2)), 1).to(x.dtype) + x = self.pre(x) * x_mask + x = self.enc(x, x_mask, g=g) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + torch.randn_like(m) * torch.exp(logs)) * x_mask + return z, m, logs, x_mask + + +class TextEncoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + kernel_size, + n_layers, + gin_channels=0, + filter_channels=None, + n_heads=None, + p_dropout=None): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.n_layers = n_layers + self.gin_channels = gin_channels + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + self.f0_emb = nn.Embedding(256, hidden_channels) + + self.enc_ = attentions.Encoder( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + + def forward(self, x, x_mask, f0=None, z=None): + x = x + self.f0_emb(f0).transpose(1, 2) + x = self.enc_(x * x_mask, x_mask) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + z * torch.exp(logs)) * x_mask + return z, m, logs, x_mask + + +class DiscriminatorP(torch.nn.Module): + def __init__(self, period, kernel_size=5, stride=3, use_spectral_norm=False): + super(DiscriminatorP, self).__init__() + self.period = period + self.use_spectral_norm = use_spectral_norm + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv2d(1, 32, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(32, 128, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(128, 512, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(512, 1024, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(1024, 1024, (kernel_size, 1), 1, padding=(get_padding(kernel_size, 1), 0))), + ]) + self.conv_post = norm_f(Conv2d(1024, 1, (3, 1), 1, padding=(1, 0))) + + def forward(self, x): + fmap = [] + + # 1d to 2d + b, c, t = x.shape + if t % self.period != 0: # pad first + n_pad = self.period - (t % self.period) + x = F.pad(x, (0, n_pad), "reflect") + t = t + n_pad + x = x.view(b, c, t // self.period, self.period) + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class DiscriminatorS(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(DiscriminatorS, self).__init__() + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv1d(1, 16, 15, 1, padding=7)), + norm_f(Conv1d(16, 64, 41, 4, groups=4, padding=20)), + norm_f(Conv1d(64, 256, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(256, 1024, 41, 4, groups=64, padding=20)), + norm_f(Conv1d(1024, 1024, 41, 4, groups=256, padding=20)), + norm_f(Conv1d(1024, 1024, 5, 1, padding=2)), + ]) + self.conv_post = norm_f(Conv1d(1024, 1, 3, 1, padding=1)) + + def forward(self, x): + fmap = [] + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class F0Decoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=0): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.spk_channels = spk_channels + + self.prenet = nn.Conv1d(hidden_channels, hidden_channels, 3, padding=1) + self.decoder = attentions.FFT( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + self.proj = nn.Conv1d(hidden_channels, out_channels, 1) + self.f0_prenet = nn.Conv1d(1, hidden_channels, 3, padding=1) + self.cond = nn.Conv1d(spk_channels, hidden_channels, 1) + + def forward(self, x, norm_f0, x_mask, spk_emb=None): + x = torch.detach(x) + if spk_emb is not None: + x = x + self.cond(spk_emb) + x += self.f0_prenet(norm_f0) + x = self.prenet(x) * x_mask + x = self.decoder(x * x_mask, x_mask) + x = self.proj(x) * x_mask + return x + + +class SynthesizerTrn(nn.Module): + """ + Synthesizer for Training + """ + + def __init__(self, + spec_channels, + segment_size, + inter_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + resblock, + resblock_kernel_sizes, + resblock_dilation_sizes, + upsample_rates, + upsample_initial_channel, + upsample_kernel_sizes, + gin_channels, + ssl_dim, + n_speakers, + sampling_rate=44100, + **kwargs): + super().__init__() + self.spec_channels = spec_channels + self.inter_channels = inter_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.resblock = resblock + self.resblock_kernel_sizes = resblock_kernel_sizes + self.resblock_dilation_sizes = resblock_dilation_sizes + self.upsample_rates = upsample_rates + self.upsample_initial_channel = upsample_initial_channel + self.upsample_kernel_sizes = upsample_kernel_sizes + self.segment_size = segment_size + self.gin_channels = gin_channels + self.ssl_dim = ssl_dim + self.emb_g = nn.Embedding(n_speakers, gin_channels) + + self.pre = nn.Conv1d(ssl_dim, hidden_channels, kernel_size=5, padding=2) + + self.enc_p = TextEncoder( + inter_channels, + hidden_channels, + filter_channels=filter_channels, + n_heads=n_heads, + n_layers=n_layers, + kernel_size=kernel_size, + p_dropout=p_dropout + ) + hps = { + "sampling_rate": sampling_rate, + "inter_channels": inter_channels, + "resblock": resblock, + "resblock_kernel_sizes": resblock_kernel_sizes, + "resblock_dilation_sizes": resblock_dilation_sizes, + "upsample_rates": upsample_rates, + "upsample_initial_channel": upsample_initial_channel, + "upsample_kernel_sizes": upsample_kernel_sizes, + "gin_channels": gin_channels, + } + self.dec = Generator(h=hps) + self.enc_q = Encoder(spec_channels, inter_channels, hidden_channels, 5, 1, 16, gin_channels=gin_channels) + self.flow = ResidualCouplingBlock(inter_channels, hidden_channels, 5, 1, 4, gin_channels=gin_channels) + self.f0_decoder = F0Decoder( + 1, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=gin_channels + ) + self.emb_uv = nn.Embedding(2, hidden_channels) + self.predict_f0 = False + + def forward(self, c, f0, mel2ph, uv, noise=None, g=None): + + decoder_inp = F.pad(c, [0, 0, 1, 0]) + mel2ph_ = mel2ph.unsqueeze(2).repeat([1, 1, c.shape[-1]]) + c = torch.gather(decoder_inp, 1, mel2ph_).transpose(1, 2) # [B, T, H] + + c_lengths = (torch.ones(c.size(0)) * c.size(-1)).to(c.device) + g = g.unsqueeze(0) + g = self.emb_g(g).transpose(1, 2) + x_mask = torch.unsqueeze(commons.sequence_mask(c_lengths, c.size(2)), 1).to(c.dtype) + x = self.pre(c) * x_mask + self.emb_uv(uv.long()).transpose(1, 2) + + if self.predict_f0: + lf0 = 2595. * torch.log10(1. + f0.unsqueeze(1) / 700.) / 500 + norm_lf0 = utils.normalize_f0(lf0, x_mask, uv, random_scale=False) + pred_lf0 = self.f0_decoder(x, norm_lf0, x_mask, spk_emb=g) + f0 = (700 * (torch.pow(10, pred_lf0 * 500 / 2595) - 1)).squeeze(1) + + z_p, m_p, logs_p, c_mask = self.enc_p(x, x_mask, f0=f0_to_coarse(f0), z=noise) + z = self.flow(z_p, c_mask, g=g, reverse=True) + o = self.dec(z * c_mask, g=g, f0=f0) + return o diff --git a/onnxexport/model_onnx_speaker_mix.py b/onnxexport/model_onnx_speaker_mix.py new file mode 100644 index 0000000000000000000000000000000000000000..c4b443162b0c82418286fd3834b4b5b010a454a8 --- /dev/null +++ b/onnxexport/model_onnx_speaker_mix.py @@ -0,0 +1,363 @@ +import torch +from torch import nn +from torch.nn import functional as F +import cluster +import modules.attentions as attentions +import modules.commons as commons +import modules.modules as modules + +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm, spectral_norm + +import utils +from modules.commons import init_weights, get_padding +from vdecoder.hifigan.models import Generator +from utils import f0_to_coarse + + +class ResidualCouplingBlock(nn.Module): + def __init__(self, + channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + n_flows=4, + gin_channels=0): + super().__init__() + self.channels = channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.n_flows = n_flows + self.gin_channels = gin_channels + + self.flows = nn.ModuleList() + for i in range(n_flows): + self.flows.append( + modules.ResidualCouplingLayer(channels, hidden_channels, kernel_size, dilation_rate, n_layers, + gin_channels=gin_channels, mean_only=True)) + self.flows.append(modules.Flip()) + + def forward(self, x, x_mask, g=None, reverse=False): + if not reverse: + for flow in self.flows: + x, _ = flow(x, x_mask, g=g, reverse=reverse) + else: + for flow in reversed(self.flows): + x = flow(x, x_mask, g=g, reverse=reverse) + return x + + +class Encoder(nn.Module): + def __init__(self, + in_channels, + out_channels, + hidden_channels, + kernel_size, + dilation_rate, + n_layers, + gin_channels=0): + super().__init__() + self.in_channels = in_channels + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.dilation_rate = dilation_rate + self.n_layers = n_layers + self.gin_channels = gin_channels + + self.pre = nn.Conv1d(in_channels, hidden_channels, 1) + self.enc = modules.WN(hidden_channels, kernel_size, dilation_rate, n_layers, gin_channels=gin_channels) + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + + def forward(self, x, x_lengths, g=None): + # print(x.shape,x_lengths.shape) + x_mask = torch.unsqueeze(commons.sequence_mask(x_lengths, x.size(2)), 1).to(x.dtype) + x = self.pre(x) * x_mask + x = self.enc(x, x_mask, g=g) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + torch.randn_like(m) * torch.exp(logs)) * x_mask + return z, m, logs, x_mask + + +class TextEncoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + kernel_size, + n_layers, + gin_channels=0, + filter_channels=None, + n_heads=None, + p_dropout=None): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.kernel_size = kernel_size + self.n_layers = n_layers + self.gin_channels = gin_channels + self.proj = nn.Conv1d(hidden_channels, out_channels * 2, 1) + self.f0_emb = nn.Embedding(256, hidden_channels) + + self.enc_ = attentions.Encoder( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + + def forward(self, x, x_mask, f0=None, z=None): + x = x + self.f0_emb(f0).transpose(1, 2) + x = self.enc_(x * x_mask, x_mask) + stats = self.proj(x) * x_mask + m, logs = torch.split(stats, self.out_channels, dim=1) + z = (m + z * torch.exp(logs)) * x_mask + return z, m, logs, x_mask + + +class DiscriminatorP(torch.nn.Module): + def __init__(self, period, kernel_size=5, stride=3, use_spectral_norm=False): + super(DiscriminatorP, self).__init__() + self.period = period + self.use_spectral_norm = use_spectral_norm + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv2d(1, 32, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(32, 128, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(128, 512, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(512, 1024, (kernel_size, 1), (stride, 1), padding=(get_padding(kernel_size, 1), 0))), + norm_f(Conv2d(1024, 1024, (kernel_size, 1), 1, padding=(get_padding(kernel_size, 1), 0))), + ]) + self.conv_post = norm_f(Conv2d(1024, 1, (3, 1), 1, padding=(1, 0))) + + def forward(self, x): + fmap = [] + + # 1d to 2d + b, c, t = x.shape + if t % self.period != 0: # pad first + n_pad = self.period - (t % self.period) + x = F.pad(x, (0, n_pad), "reflect") + t = t + n_pad + x = x.view(b, c, t // self.period, self.period) + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class DiscriminatorS(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(DiscriminatorS, self).__init__() + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv1d(1, 16, 15, 1, padding=7)), + norm_f(Conv1d(16, 64, 41, 4, groups=4, padding=20)), + norm_f(Conv1d(64, 256, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(256, 1024, 41, 4, groups=64, padding=20)), + norm_f(Conv1d(1024, 1024, 41, 4, groups=256, padding=20)), + norm_f(Conv1d(1024, 1024, 5, 1, padding=2)), + ]) + self.conv_post = norm_f(Conv1d(1024, 1, 3, 1, padding=1)) + + def forward(self, x): + fmap = [] + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, modules.LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class F0Decoder(nn.Module): + def __init__(self, + out_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=0): + super().__init__() + self.out_channels = out_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.spk_channels = spk_channels + + self.prenet = nn.Conv1d(hidden_channels, hidden_channels, 3, padding=1) + self.decoder = attentions.FFT( + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout) + self.proj = nn.Conv1d(hidden_channels, out_channels, 1) + self.f0_prenet = nn.Conv1d(1, hidden_channels, 3, padding=1) + self.cond = nn.Conv1d(spk_channels, hidden_channels, 1) + + def forward(self, x, norm_f0, x_mask, spk_emb=None): + x = torch.detach(x) + if spk_emb is not None: + x = x + self.cond(spk_emb) + x += self.f0_prenet(norm_f0) + x = self.prenet(x) * x_mask + x = self.decoder(x * x_mask, x_mask) + x = self.proj(x) * x_mask + return x + + +class SynthesizerTrn(nn.Module): + """ + Synthesizer for Training + """ + + def __init__(self, + spec_channels, + segment_size, + inter_channels, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + resblock, + resblock_kernel_sizes, + resblock_dilation_sizes, + upsample_rates, + upsample_initial_channel, + upsample_kernel_sizes, + gin_channels, + ssl_dim, + n_speakers, + sampling_rate=44100, + **kwargs): + super().__init__() + self.spec_channels = spec_channels + self.inter_channels = inter_channels + self.hidden_channels = hidden_channels + self.filter_channels = filter_channels + self.n_heads = n_heads + self.n_layers = n_layers + self.kernel_size = kernel_size + self.p_dropout = p_dropout + self.resblock = resblock + self.resblock_kernel_sizes = resblock_kernel_sizes + self.resblock_dilation_sizes = resblock_dilation_sizes + self.upsample_rates = upsample_rates + self.upsample_initial_channel = upsample_initial_channel + self.upsample_kernel_sizes = upsample_kernel_sizes + self.segment_size = segment_size + self.gin_channels = gin_channels + self.ssl_dim = ssl_dim + self.emb_g = nn.Embedding(n_speakers, gin_channels) + + self.pre = nn.Conv1d(ssl_dim, hidden_channels, kernel_size=5, padding=2) + + self.enc_p = TextEncoder( + inter_channels, + hidden_channels, + filter_channels=filter_channels, + n_heads=n_heads, + n_layers=n_layers, + kernel_size=kernel_size, + p_dropout=p_dropout + ) + hps = { + "sampling_rate": sampling_rate, + "inter_channels": inter_channels, + "resblock": resblock, + "resblock_kernel_sizes": resblock_kernel_sizes, + "resblock_dilation_sizes": resblock_dilation_sizes, + "upsample_rates": upsample_rates, + "upsample_initial_channel": upsample_initial_channel, + "upsample_kernel_sizes": upsample_kernel_sizes, + "gin_channels": gin_channels, + } + self.dec = Generator(h=hps) + self.enc_q = Encoder(spec_channels, inter_channels, hidden_channels, 5, 1, 16, gin_channels=gin_channels) + self.flow = ResidualCouplingBlock(inter_channels, hidden_channels, 5, 1, 4, gin_channels=gin_channels) + self.f0_decoder = F0Decoder( + 1, + hidden_channels, + filter_channels, + n_heads, + n_layers, + kernel_size, + p_dropout, + spk_channels=gin_channels + ) + self.emb_uv = nn.Embedding(2, hidden_channels) + self.predict_f0 = False + cluster_model_path="kmeans_10000.pt" + if os.path.exists(cluster_model_path): + self.cluster_model = cluster.get_cluster_model(cluster_model_path) + else: + self.cluster_model = None + self.speaker_map = [] + self.export_mix = False + + def export_chara_mix(self, n_speakers_mix): + spkmap = [] + for i in range(n_speakers_mix): + spkmap.append(self.emb_g(torch.LongTensor([[i]])).transpose(1, 2).detach().numpy()) + self.speaker_map = torch.tensor(spkmap) + self.export_mix = True + + def forward(self, c, f0, mel2ph, uv, noise=None, g=None, cluster_infer_ratio=0.1): + + decoder_inp = F.pad(c, [0, 0, 1, 0]) + mel2ph_ = mel2ph.unsqueeze(2).repeat([1, 1, c.shape[-1]]) + c = torch.gather(decoder_inp, 1, mel2ph_).transpose(1, 2) # [B, T, H] + + if self.cluster_model is not None: + predict = self.cluster_model[speaker].predict(c.transpose(0, 1)) + model[speaker].cluster_centers_[predict] + cluster_c = cluster.get_cluster_center_result(self.cluster_model, c.cpu().numpy().T, speaker).T + cluster_c = torch.FloatTensor(cluster_c).to(self.dev) + c = cluster_infer_ratio * cluster_c + (1 - cluster_infer_ratio) * c + + c_lengths = (torch.ones(c.size(0)) * c.size(-1)).to(c.device) + + if self.export_mix: + spk_mix = spk_mix.unsqueeze(-1).unsqueeze(-1).unsqueeze(-1) + g = torch.sum(spk_mix * self.speaker_map, dim=0).transpose(1, 2) + else: + g = g.unsqueeze(0) + g = self.emb_g(g).transpose(1, 2) + + + x_mask = torch.unsqueeze(commons.sequence_mask(c_lengths, c.size(2)), 1).to(c.dtype) + x = self.pre(c) * x_mask + self.emb_uv(uv.long()).transpose(1, 2) + + if self.predict_f0: + lf0 = 2595. * torch.log10(1. + f0.unsqueeze(1) / 700.) / 500 + norm_lf0 = utils.normalize_f0(lf0, x_mask, uv, random_scale=False) + pred_lf0 = self.f0_decoder(x, norm_lf0, x_mask, spk_emb=g) + f0 = (700 * (torch.pow(10, pred_lf0 * 500 / 2595) - 1)).squeeze(1) + + z_p, m_p, logs_p, c_mask = self.enc_p(x, x_mask, f0=f0_to_coarse(f0), z=noise) + z = self.flow(z_p, c_mask, g=g, reverse=True) + o = self.dec(z * c_mask, g=g, f0=f0) + return o diff --git a/preprocess_flist_config.py b/preprocess_flist_config.py new file mode 100644 index 0000000000000000000000000000000000000000..ac946865d42801fb8e710973f0af6788e47ff3a0 --- /dev/null +++ b/preprocess_flist_config.py @@ -0,0 +1,75 @@ +import os +import argparse +import re + +from tqdm import tqdm +from random import shuffle +import json +import wave + +config_template = json.load(open("configs_template/config_template.json")) + +pattern = re.compile(r'^[\.a-zA-Z0-9_\/]+$') + +def get_wav_duration(file_path): + with wave.open(file_path, 'rb') as wav_file: + # get audio frames + n_frames = wav_file.getnframes() + # get sampling rate + framerate = wav_file.getframerate() + # calculate duration in seconds + duration = n_frames / float(framerate) + return duration + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("--train_list", type=str, default="./filelists/train.txt", help="path to train list") + parser.add_argument("--val_list", type=str, default="./filelists/val.txt", help="path to val list") + parser.add_argument("--source_dir", type=str, default="./dataset/44k", help="path to source dir") + args = parser.parse_args() + + train = [] + val = [] + idx = 0 + spk_dict = {} + spk_id = 0 + for speaker in tqdm(os.listdir(args.source_dir)): + spk_dict[speaker] = spk_id + spk_id += 1 + wavs = ["/".join([args.source_dir, speaker, i]) for i in os.listdir(os.path.join(args.source_dir, speaker))] + new_wavs = [] + for file in wavs: + if not file.endswith("wav"): + continue + if not pattern.match(file): + print(f"Warning: The file name of {file} contains non-alphanumeric and underscores, which may cause issues. (or maybe not)") + if get_wav_duration(file) < 0.3: + print("skip too short audio:", file) + continue + new_wavs.append(file) + wavs = new_wavs + shuffle(wavs) + train += wavs[2:] + val += wavs[:2] + + shuffle(train) + shuffle(val) + + print("Writing", args.train_list) + with open(args.train_list, "w") as f: + for fname in tqdm(train): + wavpath = fname + f.write(wavpath + "\n") + + print("Writing", args.val_list) + with open(args.val_list, "w") as f: + for fname in tqdm(val): + wavpath = fname + f.write(wavpath + "\n") + + config_template["spk"] = spk_dict + config_template["model"]["n_speakers"] = spk_id + + print("Writing configs/config.json") + with open("configs/config.json", "w") as f: + json.dump(config_template, f, indent=2) diff --git a/preprocess_hubert_f0.py b/preprocess_hubert_f0.py new file mode 100644 index 0000000000000000000000000000000000000000..763fb0d65540ed4d62b269914e81c740f3ff6bba --- /dev/null +++ b/preprocess_hubert_f0.py @@ -0,0 +1,101 @@ +import math +import multiprocessing +import os +import argparse +from random import shuffle + +import torch +from glob import glob +from tqdm import tqdm +from modules.mel_processing import spectrogram_torch + +import utils +import logging + +logging.getLogger("numba").setLevel(logging.WARNING) +import librosa +import numpy as np + +hps = utils.get_hparams_from_file("configs/config.json") +sampling_rate = hps.data.sampling_rate +hop_length = hps.data.hop_length + + +def process_one(filename, hmodel): + # print(filename) + wav, sr = librosa.load(filename, sr=sampling_rate) + soft_path = filename + ".soft.pt" + if not os.path.exists(soft_path): + device = torch.device("cuda" if torch.cuda.is_available() else "cpu") + wav16k = librosa.resample(wav, orig_sr=sampling_rate, target_sr=16000) + wav16k = torch.from_numpy(wav16k).to(device) + c = utils.get_hubert_content(hmodel, wav_16k_tensor=wav16k) + torch.save(c.cpu(), soft_path) + + f0_path = filename + ".f0.npy" + if not os.path.exists(f0_path): + f0 = utils.compute_f0_dio( + wav, sampling_rate=sampling_rate, hop_length=hop_length + ) + np.save(f0_path, f0) + + spec_path = filename.replace(".wav", ".spec.pt") + if not os.path.exists(spec_path): + # Process spectrogram + # The following code can't be replaced by torch.FloatTensor(wav) + # because load_wav_to_torch return a tensor that need to be normalized + + audio, sr = utils.load_wav_to_torch(filename) + if sr != hps.data.sampling_rate: + raise ValueError( + "{} SR doesn't match target {} SR".format( + sr, hps.data.sampling_rate + ) + ) + + audio_norm = audio / hps.data.max_wav_value + audio_norm = audio_norm.unsqueeze(0) + + spec = spectrogram_torch( + audio_norm, + hps.data.filter_length, + hps.data.sampling_rate, + hps.data.hop_length, + hps.data.win_length, + center=False, + ) + spec = torch.squeeze(spec, 0) + torch.save(spec, spec_path) + + +def process_batch(filenames): + print("Loading hubert for content...") + device = "cuda" if torch.cuda.is_available() else "cpu" + hmodel = utils.get_hubert_model().to(device) + print("Loaded hubert.") + for filename in tqdm(filenames): + process_one(filename, hmodel) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument( + "--in_dir", type=str, default="dataset/44k", help="path to input dir" + ) + + args = parser.parse_args() + filenames = glob(f"{args.in_dir}/*/*.wav", recursive=True) # [:10] + shuffle(filenames) + multiprocessing.set_start_method("spawn", force=True) + + num_processes = 1 + chunk_size = int(math.ceil(len(filenames) / num_processes)) + chunks = [ + filenames[i : i + chunk_size] for i in range(0, len(filenames), chunk_size) + ] + print([len(c) for c in chunks]) + processes = [ + multiprocessing.Process(target=process_batch, args=(chunk,)) for chunk in chunks + ] + for p in processes: + p.start() diff --git a/pretrain/nsf_hifigan/put_nsf_hifigan_ckpt_here b/pretrain/nsf_hifigan/put_nsf_hifigan_ckpt_here new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000000000000000000000000000000000000..9dd41d4fd9c0ce7e66ac790a81897696655f7846 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,21 @@ +Flask +Flask_Cors +gradio>=3.7.0 +numpy==1.23.0 +pyworld==0.2.5 +scipy==1.10.0 +SoundFile==0.12.1 +torch==1.13.1 +torchaudio==0.13.1 +torchcrepe +tqdm +scikit-maad +praat-parselmouth +onnx +onnxsim +onnxoptimizer +fairseq==0.12.2 +librosa==0.9.1 +tensorboard +tensorboardX +edge_tts diff --git a/requirements_win.txt b/requirements_win.txt new file mode 100644 index 0000000000000000000000000000000000000000..8201f6d4b0c5b9ea37f49dc74770d48f3cdd334c --- /dev/null +++ b/requirements_win.txt @@ -0,0 +1,24 @@ +librosa==0.9.1 +fairseq==0.12.2 +Flask==2.1.2 +Flask_Cors==3.0.10 +gradio>=3.7.0 +numpy +playsound==1.3.0 +PyAudio==0.2.12 +pydub==0.25.1 +pyworld==0.3.0 +requests==2.28.1 +scipy==1.7.3 +sounddevice==0.4.5 +SoundFile==0.10.3.post1 +starlette==0.19.1 +tqdm==4.63.0 +torchcrepe +scikit-maad +praat-parselmouth +onnx +onnxsim +onnxoptimizer +tensorboardX +edge_tts diff --git a/resample.py b/resample.py new file mode 100644 index 0000000000000000000000000000000000000000..b28a86eb779d7b3f163e89fac64ecabe044ad1e2 --- /dev/null +++ b/resample.py @@ -0,0 +1,48 @@ +import os +import argparse +import librosa +import numpy as np +from multiprocessing import Pool, cpu_count +from scipy.io import wavfile +from tqdm import tqdm + + +def process(item): + spkdir, wav_name, args = item + # speaker 's5', 'p280', 'p315' are excluded, + speaker = spkdir.replace("\\", "/").split("/")[-1] + wav_path = os.path.join(args.in_dir, speaker, wav_name) + if os.path.exists(wav_path) and '.wav' in wav_path: + os.makedirs(os.path.join(args.out_dir2, speaker), exist_ok=True) + wav, sr = librosa.load(wav_path, sr=None) + wav, _ = librosa.effects.trim(wav, top_db=20) + peak = np.abs(wav).max() + if peak > 1.0: + wav = 0.98 * wav / peak + wav2 = librosa.resample(wav, orig_sr=sr, target_sr=args.sr2) + wav2 /= max(wav2.max(), -wav2.min()) + save_name = wav_name + save_path2 = os.path.join(args.out_dir2, speaker, save_name) + wavfile.write( + save_path2, + args.sr2, + (wav2 * np.iinfo(np.int16).max).astype(np.int16) + ) + + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("--sr2", type=int, default=44100, help="sampling rate") + parser.add_argument("--in_dir", type=str, default="./dataset_raw", help="path to source dir") + parser.add_argument("--out_dir2", type=str, default="./dataset/44k", help="path to target dir") + args = parser.parse_args() + processs = 30 if cpu_count() > 60 else (cpu_count()-2 if cpu_count() > 4 else 1) + pool = Pool(processes=processs) + + for speaker in os.listdir(args.in_dir): + spk_dir = os.path.join(args.in_dir, speaker) + if os.path.isdir(spk_dir): + print(spk_dir) + for _ in tqdm(pool.imap_unordered(process, [(spk_dir, i, args) for i in os.listdir(spk_dir) if i.endswith("wav")])): + pass diff --git a/sovits4_for_colab.ipynb b/sovits4_for_colab.ipynb new file mode 100644 index 0000000000000000000000000000000000000000..1c4cf1c1d0a9cb0ff6f9ac5b8ceaf63161b726da --- /dev/null +++ b/sovits4_for_colab.ipynb @@ -0,0 +1 @@ +{"cells":[{"cell_type":"markdown","metadata":{"id":"2q0l56aFQhAM"},"source":["# Terms of Use\n","\n","### Please solve the authorization problem of the dataset on your own. You shall be solely responsible for any problems caused by the use of non-authorized datasets for training and all consequences thereof.The repository and its maintainer, svc develop team, have nothing to do with the consequences!\n","\n","1. This project is established for academic exchange purposes only and is intended for communication and learning purposes. It is not intended for production environments.\n","2. Any videos based on sovits that are published on video platforms must clearly indicate in the description that they are used for voice changing and specify the input source of the voice or audio, for example, using videos or audios published by others and separating the vocals as input source for conversion, which must provide clear original video or music links. If your own voice or other synthesized voices from other commercial vocal synthesis software are used as the input source for conversion, you must also explain it in the description.\n","3. You shall be solely responsible for any infringement problems caused by the input source. When using other commercial vocal synthesis software as input source, please ensure that you comply with the terms of use of the software. Note that many vocal synthesis engines clearly state in their terms of use that they cannot be used for input source conversion.\n","4. Continuing to use this project is deemed as agreeing to the relevant provisions stated in this repository README. This repository README has the obligation to persuade, and is not responsible for any subsequent problems that may arise.\n","5. If you distribute this repository's code or publish any results produced by this project publicly (including but not limited to video sharing platforms), please indicate the original author and code source (this repository).\n","6. If you use this project for any other plan, please contact and inform the author of this repository in advance. Thank you very much.\n"]},{"cell_type":"markdown","metadata":{"id":"M_RcDbVPhivj"},"source":["## **Note:**\n","## **Make sure there is no a directory named `sovits4data` in your google drive at the first time you use this notebook.**\n","## **It will be created to store some necessary files.** \n","## **For sure you can change it to another directory by modifying `sovits_data_dir` variable.**"]},{"cell_type":"markdown","metadata":{"id":"fHaw6hGEa_Nk"},"source":["# **Initialize environment**"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"0gQcIZ8RsOkn"},"outputs":[],"source":["#@title Connect to colab runtime and check GPU\n","\n","#@markdown # Connect to colab runtime and check GPU\n","\n","#@markdown\n","\n","!nvidia-smi"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"0YUGpYrXhMck"},"outputs":[],"source":["#@title Clone repository and install requirements\n","\n","#@markdown # Clone repository and install requirements\n","\n","#@markdown\n","\n","#@markdown ### After the execution is completed, the runtime will **automatically restart**\n","\n","#@markdown\n","\n","!git clone https://github.com/svc-develop-team/so-vits-svc -b 4.0\n","!pip uninstall torchdata torchtext\n","!pip install --upgrade pip setuptools numpy numba\n","!pip install pyworld praat-parselmouth fairseq tensorboardX torchcrepe librosa==0.9.1\n","!pip install torch==1.13.1+cu117 torchvision==0.14.1+cu117 torchaudio==0.13.1+cu117 --extra-index-url https://download.pytorch.org/whl/cu117\n","%cd /content/so-vits-svc\n","!curl -L https://github.com/openvpi/vocoders/releases/download/nsf-hifigan-v1/nsf_hifigan_20221211.zip -o /content/so-vits-svc/nsf_hifigan_20221211.zip\n","!unzip nsf_hifigan_20221211.zip\n","!rm -rf pretrain/nsf_hifigan\n","!mv -v nsf_hifigan pretrain\n","!curl -L https://ibm.ent.box.com/shared/static/z1wgl1stco8ffooyatzdwsqn2psd9lrr -o /content/so-vits-svc/hubert/checkpoint_best_legacy_500.pt\n","exit()"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"wmUkpUmfn_Hs"},"outputs":[],"source":["#@title Mount google drive and select which directories to sync with google drive\n","\n","#@markdown # Mount google drive and select which directories to sync with google drive\n","\n","#@markdown\n","\n","from google.colab import drive\n","drive.mount(\"/content/drive\")\n","\n","#@markdown Directory to store **necessary files**, dont miss the slash at the end👇.\n","sovits_data_dir = \"/content/drive/MyDrive/sovits4data/\" #@param {type:\"string\"}\n","#@markdown By default it will create a `sovits4data/` folder in your google drive.\n","RAW_DIR = sovits_data_dir + \"raw/\"\n","RESULTS_DIR = sovits_data_dir + \"results/\"\n","FILELISTS_DIR = sovits_data_dir + \"filelists/\"\n","CONFIGS_DIR = sovits_data_dir + \"configs/\"\n","LOGS_DIR = sovits_data_dir + \"logs/44k/\"\n","\n","#@markdown\n","\n","#@markdown ### These folders will be synced with your google drvie\n","\n","#@markdown ### **Strongly recommend to check all.**\n","\n","#@markdown Sync **input audios** and **output audios**\n","sync_raw_and_results = True #@param {type:\"boolean\"}\n","if sync_raw_and_results:\n"," !mkdir -p {RAW_DIR}\n"," !mkdir -p {RESULTS_DIR}\n"," !rm -rf /content/so-vits-svc/raw\n"," !rm -rf /content/so-vits-svc/results\n"," !ln -s {RAW_DIR} /content/so-vits-svc/raw\n"," !ln -s {RESULTS_DIR} /content/so-vits-svc/results\n","\n","#@markdown Sync **config** and **models**\n","sync_configs_and_logs = True #@param {type:\"boolean\"}\n","if sync_configs_and_logs:\n"," !mkdir -p {FILELISTS_DIR}\n"," !mkdir -p {CONFIGS_DIR}\n"," !mkdir -p {LOGS_DIR}\n"," !rm -rf /content/so-vits-svc/filelists\n"," !rm -rf /content/so-vits-svc/configs\n"," !rm -rf /content/so-vits-svc/logs/44k\n"," !ln -s {FILELISTS_DIR} /content/so-vits-svc/filelists\n"," !ln -s {CONFIGS_DIR} /content/so-vits-svc/configs\n"," !ln -s {LOGS_DIR} /content/so-vits-svc/logs/44k"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"G_PMPCN6wvgZ"},"outputs":[],"source":["#@title Get pretrained model(Optional but strongly recommend).\n","\n","#@markdown # Get pretrained model(Optional but strongly recommend).\n","\n","#@markdown\n","\n","#@markdown - Pre-trained model files: `G_0.pth` `D_0.pth`\n","#@markdown - Place them under /sovits4data/logs/44k/ in your google drive manualy\n","\n","#@markdown Get them from svc-develop-team(TBD) or anywhere else.\n","\n","#@markdown Although the pretrained model generally does not cause any copyright problems, please pay attention to it. For example, ask the author in advance, or the author has indicated the feasible use in the description clearly.\n","\n","!pwd"]},{"cell_type":"markdown","metadata":{"id":"k1qadJBFehMo"},"source":["# **Dataset preprocessing**"]},{"cell_type":"markdown","metadata":{"id":"kBlju6Q3lSM6"},"source":["Pack and upload your raw dataset(dataset_raw/) to your google drive.\n","\n","Makesure the file structure in your zip file looks like this:\n","\n","```\n","YourZIPforSingleSpeakers.zip\n","└───speaker\n"," ├───xxx1-xxx1.wav\n"," ├───...\n"," └───Lxx-0xx8.wav\n","```\n","\n","```\n","YourZIPforMultipleSpeakers.zip\n","├───speaker0\n","│ ├───xxx1-xxx1.wav\n","│ ├───...\n","│ └───Lxx-0xx8.wav\n","└───speaker1\n"," ├───xx2-0xxx2.wav\n"," ├───...\n"," └───xxx7-xxx007.wav\n","```\n","\n","**Even if there is only one speaker, a folder named `{speaker_name}` is needed.**\n","\n","![1.png](data:image/png;base64,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)\n","\n","![2.png](data:image/png;base64,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)"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"U05CXlAipvJR"},"outputs":[],"source":["#@title Get raw dataset from google drive\n","\n","#@markdown # Get raw dataset from google drive\n","\n","#@markdown\n","\n","#@markdown Directory where **your zip file** located in, dont miss the slash at the end👇.\n","sovits_data_dir = \"/content/drive/MyDrive/sovits4data/\" #@param {type:\"string\"}\n","#@markdown Filename of **your zip file**, do NOT be \"dataset.zip\"\n","zip_filename = \"YourZIPFilenameofRawDataset.zip\" #@param {type:\"string\"}\n","ZIP_PATH = sovits_data_dir + zip_filename\n","\n","!unzip -od /content/so-vits-svc/dataset_raw {ZIP_PATH}"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"_ThKTzYs5CfL"},"outputs":[],"source":["#@title Resample to 44100Hz and mono\n","\n","#@markdown # Resample to 44100Hz and mono\n","\n","#@markdown\n","\n","%cd /content/so-vits-svc\n","!python resample.py"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"svITReeL5N8K"},"outputs":[],"source":["#@title Divide filelists and generate config.json\n","\n","#@markdown # Divide filelists and generate config.json\n","\n","#@markdown\n","\n","%cd /content/so-vits-svc\n","!python preprocess_flist_config.py"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"xHUXMi836DMe"},"outputs":[],"source":["#@title Generate hubert and f0\n","\n","#@markdown # Generate hubert and f0\n","\n","#@markdown\n","\n","%cd /content/so-vits-svc\n","!python preprocess_hubert_f0.py"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"Wo4OTmTAUXgj"},"outputs":[],"source":["#@title Save the preprocessed dataset to google drive\n","\n","#@markdown # Save the preprocessed dataset to google drive\n","\n","#@markdown\n","\n","#@markdown You can save the dataset and related files to your google drive for the next training\n","\n","#@markdown **Directory for saving**, dont miss the slash at the end👇.\n","sovits_data_dir = \"/content/drive/MyDrive/sovits4data/\" #@param {type:\"string\"}\n","\n","#@markdown There will be a `dataset.zip` contained `dataset/` in your google drive, which is preprocessed data.\n","\n","!mkdir -p {sovits_data_dir}\n","!zip -r dataset.zip /content/so-vits-svc/dataset\n","!cp -vr dataset.zip \"{sovits_data_dir}\""]},{"cell_type":"code","execution_count":null,"metadata":{"id":"P2G6v_6zblWK"},"outputs":[],"source":["#@title Unzip preprocessed dataset from google drive directly if you have preprocessed already.\n","\n","#@markdown # Unzip preprocessed dataset from google drive directly if you have preprocessed already.\n","\n","#@markdown\n","\n","#@markdown Directory where **your preprocessed dataset** located in, dont miss the slash at the end👇.\n","sovits_data_dir = \"/content/drive/MyDrive/sovits4data/\" #@param {type:\"string\"}\n","CONFIG = sovits_data_dir + \"configs/\"\n","FILELISTS = sovits_data_dir + \"filelists/\"\n","DATASET = sovits_data_dir + \"dataset.zip\"\n","\n","!cp -vr {CONFIG} /content/so-vits-svc/\n","!cp -vr {FILELISTS} /content/so-vits-svc/\n","!unzip {DATASET} -d /"]},{"cell_type":"markdown","metadata":{"id":"ENoH-pShel7w"},"source":["# **Trainning**"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"-hEFFTCfZf57"},"outputs":[],"source":["#@title Start training\n","\n","#@markdown # Start training\n","\n","#@markdown If you want to use pre-trained models, upload them to /sovits4data/logs/44k/ in your google drive manualy.\n","\n","#@markdown\n","\n","#@markdown Whether to enable tensorboard\n","tensorboard_on = True #@param {type:\"boolean\"}\n","\n","if tensorboard_on:\n"," %load_ext tensorboard\n"," %tensorboard --logdir logs/44k\n","\n","%cd /content/so-vits-svc\n","!python train.py -c configs/config.json -m 44k"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"ZThaMxmIJgWy"},"outputs":[],"source":["#@title Train cluster model (Optional)\n","\n","#@markdown # Train cluster model (Optional)\n","\n","#@markdown #### Details see [README.md#cluster-based-timbre-leakage-control](https://github.com/svc-develop-team/so-vits-svc#cluster-based-timbre-leakage-control)\n","\n","#@markdown\n","\n","%cd /content/so-vits-svc\n","!python cluster/train_cluster.py"]},{"cell_type":"markdown","metadata":{"id":"oCnbX-OT897k"},"source":["# **Inference**\n","### Upload wav files from this notebook\n","### **OR**\n","### Upload to `sovits4data/raw/` in your google drive manualy (should be faster)"]},{"cell_type":"code","execution_count":null,"metadata":{"colab":{"base_uri":"https://localhost:8080/","height":75},"executionInfo":{"elapsed":94633,"status":"ok","timestamp":1678591088790,"user":{"displayName":"謬紗特","userId":"09445825975794260265"},"user_tz":-480},"id":"XUsmGkgCMD_Q","outputId":"8bbfde13-030a-4ba0-bbdb-7eb6b89c02b4"},"outputs":[{"data":{"text/html":["\n"," \n"," \n"," Upload widget is only available when the cell has been executed in the\n"," current browser session. Please rerun this cell to enable.\n"," \n"," "],"text/plain":[""]},"metadata":{},"output_type":"display_data"},{"name":"stdout","output_type":"stream","text":["Saving YourWAVFile.wav to YourWAVFile.wav\n"]}],"source":["#@title Upload wav files, the filename should not contain any special symbols like `#` `$` `(` `)`\n","\n","#@markdown # Upload wav files, the filename should not contain any special symbols like `#` `$` `(` `)`\n","\n","#@markdown\n","\n","%cd /content/so-vits-svc\n","%run wav_upload.py --type audio"]},{"cell_type":"code","execution_count":null,"metadata":{"id":"dYnKuKTIj3z1"},"outputs":[],"source":["#@title Start inference (and download)\n","\n","#@markdown # Start inference (and download)\n","\n","#@markdown Parameters see [README.MD#Inference](https://github.com/svc-develop-team/so-vits-svc#-inference)\n","\n","#@markdown\n","\n","wav_filename = \"YourWAVFile.wav\" #@param {type:\"string\"}\n","model_filename = \"G_210000.pth\" #@param {type:\"string\"}\n","model_path = \"/content/so-vits-svc/logs/44k/\" + model_filename\n","speaker = \"YourSpeaker\" #@param {type:\"string\"}\n","trans = \"0\" #@param {type:\"string\"}\n","cluster_infer_ratio = \"0\" #@param {type:\"string\"}\n","auto_predict_f0 = False #@param {type:\"boolean\"}\n","apf = \"\"\n","if auto_predict_f0:\n"," apf = \" -a \"\n","f0_mean_pooling = False #@param {type:\"boolean\"}\n","fmp = \"\"\n","if f0_mean_pooling:\n"," fmp = \" -fmp \"\n","enhance = False #@param {type:\"boolean\"}\n","ehc = \"\"\n","if enhance:\n"," ehc = \" -eh \"\n","#@markdown\n","\n","#@markdown Generally keep default:\n","config_filename = \"config.json\" #@param {type:\"string\"}\n","config_path = \"/content/so-vits-svc/configs/\" + config_filename\n","kmeans_filenname = \"kmeans_10000.pt\" #@param {type:\"string\"}\n","kmeans_path = \"/content/so-vits-svc/logs/44k/\" + kmeans_filenname\n","slice_db = \"-40\" #@param {type:\"string\"}\n","wav_format = \"flac\" #@param {type:\"string\"}\n","wav_output = \"/content/so-vits-svc/results/\" + wav_filename + \"_\" + trans + \"key\" + \"_\" + speaker + \".\" + wav_format\n","\n","%cd /content/so-vits-svc\n","!python inference_main.py -n {wav_filename} -m {model_path} -s {speaker} -t {trans} -cr {cluster_infer_ratio} -c {config_path} -cm {kmeans_path} -sd {slice_db} -wf {wav_format} {apf} {fmp} {ehc}\n","\n","#@markdown\n","\n","#@markdown If you dont want to download from here, uncheck this.\n","download_after_inference = True #@param {type:\"boolean\"}\n","\n","if download_after_inference:\n"," from google.colab import files\n"," files.download(wav_output)"]}],"metadata":{"accelerator":"GPU","colab":{"provenance":[{"file_id":"19fxpo-ZoL_ShEUeZIZi6Di-YioWrEyhR","timestamp":1678516497580},{"file_id":"1rCUOOVG7-XQlVZuWRAj5IpGrMM8t07pE","timestamp":1673086970071},{"file_id":"1Ul5SmzWiSHBj0MaKA0B682C-RZKOycwF","timestamp":1670483515921}]},"gpuClass":"standard","kernelspec":{"display_name":"Python 3","name":"python3"},"language_info":{"name":"python"}},"nbformat":4,"nbformat_minor":0} diff --git a/train.py b/train.py new file mode 100644 index 0000000000000000000000000000000000000000..410f19213866f388763f0c9ac21c24c09dd5dfea --- /dev/null +++ b/train.py @@ -0,0 +1,330 @@ +import logging +import multiprocessing +import time + +logging.getLogger('matplotlib').setLevel(logging.WARNING) +logging.getLogger('numba').setLevel(logging.WARNING) + +import os +import json +import argparse +import itertools +import math +import torch +from torch import nn, optim +from torch.nn import functional as F +from torch.utils.data import DataLoader +from torch.utils.tensorboard import SummaryWriter +import torch.multiprocessing as mp +import torch.distributed as dist +from torch.nn.parallel import DistributedDataParallel as DDP +from torch.cuda.amp import autocast, GradScaler + +import modules.commons as commons +import utils +from data_utils import TextAudioSpeakerLoader, TextAudioCollate +from models import ( + SynthesizerTrn, + MultiPeriodDiscriminator, +) +from modules.losses import ( + kl_loss, + generator_loss, discriminator_loss, feature_loss +) + +from modules.mel_processing import mel_spectrogram_torch, spec_to_mel_torch + +torch.backends.cudnn.benchmark = True +global_step = 0 +start_time = time.time() + +# os.environ['TORCH_DISTRIBUTED_DEBUG'] = 'INFO' + + +def main(): + """Assume Single Node Multi GPUs Training Only""" + assert torch.cuda.is_available(), "CPU training is not allowed." + hps = utils.get_hparams() + + n_gpus = torch.cuda.device_count() + os.environ['MASTER_ADDR'] = 'localhost' + os.environ['MASTER_PORT'] = hps.train.port + + mp.spawn(run, nprocs=n_gpus, args=(n_gpus, hps,)) + + +def run(rank, n_gpus, hps): + global global_step + if rank == 0: + logger = utils.get_logger(hps.model_dir) + logger.info(hps) + utils.check_git_hash(hps.model_dir) + writer = SummaryWriter(log_dir=hps.model_dir) + writer_eval = SummaryWriter(log_dir=os.path.join(hps.model_dir, "eval")) + + # for pytorch on win, backend use gloo + dist.init_process_group(backend= 'gloo' if os.name == 'nt' else 'nccl', init_method='env://', world_size=n_gpus, rank=rank) + torch.manual_seed(hps.train.seed) + torch.cuda.set_device(rank) + collate_fn = TextAudioCollate() + all_in_mem = hps.train.all_in_mem # If you have enough memory, turn on this option to avoid disk IO and speed up training. + train_dataset = TextAudioSpeakerLoader(hps.data.training_files, hps, all_in_mem=all_in_mem) + num_workers = 5 if multiprocessing.cpu_count() > 4 else multiprocessing.cpu_count() + if all_in_mem: + num_workers = 0 + train_loader = DataLoader(train_dataset, num_workers=num_workers, shuffle=False, pin_memory=True, + batch_size=hps.train.batch_size, collate_fn=collate_fn) + if rank == 0: + eval_dataset = TextAudioSpeakerLoader(hps.data.validation_files, hps, all_in_mem=all_in_mem) + eval_loader = DataLoader(eval_dataset, num_workers=1, shuffle=False, + batch_size=1, pin_memory=False, + drop_last=False, collate_fn=collate_fn) + + net_g = SynthesizerTrn( + hps.data.filter_length // 2 + 1, + hps.train.segment_size // hps.data.hop_length, + **hps.model).cuda(rank) + net_d = MultiPeriodDiscriminator(hps.model.use_spectral_norm).cuda(rank) + optim_g = torch.optim.AdamW( + net_g.parameters(), + hps.train.learning_rate, + betas=hps.train.betas, + eps=hps.train.eps) + optim_d = torch.optim.AdamW( + net_d.parameters(), + hps.train.learning_rate, + betas=hps.train.betas, + eps=hps.train.eps) + net_g = DDP(net_g, device_ids=[rank]) # , find_unused_parameters=True) + net_d = DDP(net_d, device_ids=[rank]) + + skip_optimizer = False + try: + _, _, _, epoch_str = utils.load_checkpoint(utils.latest_checkpoint_path(hps.model_dir, "G_*.pth"), net_g, + optim_g, skip_optimizer) + _, _, _, epoch_str = utils.load_checkpoint(utils.latest_checkpoint_path(hps.model_dir, "D_*.pth"), net_d, + optim_d, skip_optimizer) + epoch_str = max(epoch_str, 1) + name=utils.latest_checkpoint_path(hps.model_dir, "D_*.pth") + global_step=int(name[name.rfind("_")+1:name.rfind(".")])+1 + #global_step = (epoch_str - 1) * len(train_loader) + except: + print("load old checkpoint failed...") + epoch_str = 1 + global_step = 0 + if skip_optimizer: + epoch_str = 1 + global_step = 0 + + warmup_epoch = hps.train.warmup_epochs + scheduler_g = torch.optim.lr_scheduler.ExponentialLR(optim_g, gamma=hps.train.lr_decay, last_epoch=epoch_str - 2) + scheduler_d = torch.optim.lr_scheduler.ExponentialLR(optim_d, gamma=hps.train.lr_decay, last_epoch=epoch_str - 2) + + scaler = GradScaler(enabled=hps.train.fp16_run) + + for epoch in range(epoch_str, hps.train.epochs + 1): + # update learning rate + if epoch > 1: + scheduler_g.step() + scheduler_d.step() + # set up warm-up learning rate + if epoch <= warmup_epoch: + for param_group in optim_g.param_groups: + param_group['lr'] = hps.train.learning_rate / warmup_epoch * epoch + for param_group in optim_d.param_groups: + param_group['lr'] = hps.train.learning_rate / warmup_epoch * epoch + # training + if rank == 0: + train_and_evaluate(rank, epoch, hps, [net_g, net_d], [optim_g, optim_d], [scheduler_g, scheduler_d], scaler, + [train_loader, eval_loader], logger, [writer, writer_eval]) + else: + train_and_evaluate(rank, epoch, hps, [net_g, net_d], [optim_g, optim_d], [scheduler_g, scheduler_d], scaler, + [train_loader, None], None, None) + + +def train_and_evaluate(rank, epoch, hps, nets, optims, schedulers, scaler, loaders, logger, writers): + net_g, net_d = nets + optim_g, optim_d = optims + scheduler_g, scheduler_d = schedulers + train_loader, eval_loader = loaders + if writers is not None: + writer, writer_eval = writers + + # train_loader.batch_sampler.set_epoch(epoch) + global global_step + + net_g.train() + net_d.train() + for batch_idx, items in enumerate(train_loader): + c, f0, spec, y, spk, lengths, uv = items + g = spk.cuda(rank, non_blocking=True) + spec, y = spec.cuda(rank, non_blocking=True), y.cuda(rank, non_blocking=True) + c = c.cuda(rank, non_blocking=True) + f0 = f0.cuda(rank, non_blocking=True) + uv = uv.cuda(rank, non_blocking=True) + lengths = lengths.cuda(rank, non_blocking=True) + mel = spec_to_mel_torch( + spec, + hps.data.filter_length, + hps.data.n_mel_channels, + hps.data.sampling_rate, + hps.data.mel_fmin, + hps.data.mel_fmax) + + with autocast(enabled=hps.train.fp16_run): + y_hat, ids_slice, z_mask, \ + (z, z_p, m_p, logs_p, m_q, logs_q), pred_lf0, norm_lf0, lf0 = net_g(c, f0, uv, spec, g=g, c_lengths=lengths, + spec_lengths=lengths) + + y_mel = commons.slice_segments(mel, ids_slice, hps.train.segment_size // hps.data.hop_length) + y_hat_mel = mel_spectrogram_torch( + y_hat.squeeze(1), + hps.data.filter_length, + hps.data.n_mel_channels, + hps.data.sampling_rate, + hps.data.hop_length, + hps.data.win_length, + hps.data.mel_fmin, + hps.data.mel_fmax + ) + y = commons.slice_segments(y, ids_slice * hps.data.hop_length, hps.train.segment_size) # slice + + # Discriminator + y_d_hat_r, y_d_hat_g, _, _ = net_d(y, y_hat.detach()) + + with autocast(enabled=False): + loss_disc, losses_disc_r, losses_disc_g = discriminator_loss(y_d_hat_r, y_d_hat_g) + loss_disc_all = loss_disc + + optim_d.zero_grad() + scaler.scale(loss_disc_all).backward() + scaler.unscale_(optim_d) + grad_norm_d = commons.clip_grad_value_(net_d.parameters(), None) + scaler.step(optim_d) + + with autocast(enabled=hps.train.fp16_run): + # Generator + y_d_hat_r, y_d_hat_g, fmap_r, fmap_g = net_d(y, y_hat) + with autocast(enabled=False): + loss_mel = F.l1_loss(y_mel, y_hat_mel) * hps.train.c_mel + loss_kl = kl_loss(z_p, logs_q, m_p, logs_p, z_mask) * hps.train.c_kl + loss_fm = feature_loss(fmap_r, fmap_g) + loss_gen, losses_gen = generator_loss(y_d_hat_g) + loss_lf0 = F.mse_loss(pred_lf0, lf0) + loss_gen_all = loss_gen + loss_fm + loss_mel + loss_kl + loss_lf0 + optim_g.zero_grad() + scaler.scale(loss_gen_all).backward() + scaler.unscale_(optim_g) + grad_norm_g = commons.clip_grad_value_(net_g.parameters(), None) + scaler.step(optim_g) + scaler.update() + + if rank == 0: + if global_step % hps.train.log_interval == 0: + lr = optim_g.param_groups[0]['lr'] + losses = [loss_disc, loss_gen, loss_fm, loss_mel, loss_kl] + reference_loss=0 + for i in losses: + reference_loss += i + logger.info('Train Epoch: {} [{:.0f}%]'.format( + epoch, + 100. * batch_idx / len(train_loader))) + logger.info(f"Losses: {[x.item() for x in losses]}, step: {global_step}, lr: {lr}, reference_loss: {reference_loss}") + + scalar_dict = {"loss/g/total": loss_gen_all, "loss/d/total": loss_disc_all, "learning_rate": lr, + "grad_norm_d": grad_norm_d, "grad_norm_g": grad_norm_g} + scalar_dict.update({"loss/g/fm": loss_fm, "loss/g/mel": loss_mel, "loss/g/kl": loss_kl, + "loss/g/lf0": loss_lf0}) + + # scalar_dict.update({"loss/g/{}".format(i): v for i, v in enumerate(losses_gen)}) + # scalar_dict.update({"loss/d_r/{}".format(i): v for i, v in enumerate(losses_disc_r)}) + # scalar_dict.update({"loss/d_g/{}".format(i): v for i, v in enumerate(losses_disc_g)}) + image_dict = { + "slice/mel_org": utils.plot_spectrogram_to_numpy(y_mel[0].data.cpu().numpy()), + "slice/mel_gen": utils.plot_spectrogram_to_numpy(y_hat_mel[0].data.cpu().numpy()), + "all/mel": utils.plot_spectrogram_to_numpy(mel[0].data.cpu().numpy()), + "all/lf0": utils.plot_data_to_numpy(lf0[0, 0, :].cpu().numpy(), + pred_lf0[0, 0, :].detach().cpu().numpy()), + "all/norm_lf0": utils.plot_data_to_numpy(lf0[0, 0, :].cpu().numpy(), + norm_lf0[0, 0, :].detach().cpu().numpy()) + } + + utils.summarize( + writer=writer, + global_step=global_step, + images=image_dict, + scalars=scalar_dict + ) + + if global_step % hps.train.eval_interval == 0: + evaluate(hps, net_g, eval_loader, writer_eval) + utils.save_checkpoint(net_g, optim_g, hps.train.learning_rate, epoch, + os.path.join(hps.model_dir, "G_{}.pth".format(global_step))) + utils.save_checkpoint(net_d, optim_d, hps.train.learning_rate, epoch, + os.path.join(hps.model_dir, "D_{}.pth".format(global_step))) + keep_ckpts = getattr(hps.train, 'keep_ckpts', 0) + if keep_ckpts > 0: + utils.clean_checkpoints(path_to_models=hps.model_dir, n_ckpts_to_keep=keep_ckpts, sort_by_time=True) + + global_step += 1 + + if rank == 0: + global start_time + now = time.time() + durtaion = format(now - start_time, '.2f') + logger.info(f'====> Epoch: {epoch}, cost {durtaion} s') + start_time = now + + +def evaluate(hps, generator, eval_loader, writer_eval): + generator.eval() + image_dict = {} + audio_dict = {} + with torch.no_grad(): + for batch_idx, items in enumerate(eval_loader): + c, f0, spec, y, spk, _, uv = items + g = spk[:1].cuda(0) + spec, y = spec[:1].cuda(0), y[:1].cuda(0) + c = c[:1].cuda(0) + f0 = f0[:1].cuda(0) + uv= uv[:1].cuda(0) + mel = spec_to_mel_torch( + spec, + hps.data.filter_length, + hps.data.n_mel_channels, + hps.data.sampling_rate, + hps.data.mel_fmin, + hps.data.mel_fmax) + y_hat = generator.module.infer(c, f0, uv, g=g) + + y_hat_mel = mel_spectrogram_torch( + y_hat.squeeze(1).float(), + hps.data.filter_length, + hps.data.n_mel_channels, + hps.data.sampling_rate, + hps.data.hop_length, + hps.data.win_length, + hps.data.mel_fmin, + hps.data.mel_fmax + ) + + audio_dict.update({ + f"gen/audio_{batch_idx}": y_hat[0], + f"gt/audio_{batch_idx}": y[0] + }) + image_dict.update({ + f"gen/mel": utils.plot_spectrogram_to_numpy(y_hat_mel[0].cpu().numpy()), + "gt/mel": utils.plot_spectrogram_to_numpy(mel[0].cpu().numpy()) + }) + utils.summarize( + writer=writer_eval, + global_step=global_step, + images=image_dict, + audios=audio_dict, + audio_sampling_rate=hps.data.sampling_rate + ) + generator.train() + + +if __name__ == "__main__": + main() diff --git a/utils.py b/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..326a6ef8c231dc5fe6b90c3efc44c86247a5f2d1 --- /dev/null +++ b/utils.py @@ -0,0 +1,543 @@ +import os +import glob +import re +import sys +import argparse +import logging +import json +import subprocess +import warnings +import random +import functools + +import librosa +import numpy as np +from scipy.io.wavfile import read +import torch +from torch.nn import functional as F +from modules.commons import sequence_mask +from hubert import hubert_model + +MATPLOTLIB_FLAG = False + +logging.basicConfig(stream=sys.stdout, level=logging.DEBUG) +logger = logging + +f0_bin = 256 +f0_max = 1100.0 +f0_min = 50.0 +f0_mel_min = 1127 * np.log(1 + f0_min / 700) +f0_mel_max = 1127 * np.log(1 + f0_max / 700) + + +# def normalize_f0(f0, random_scale=True): +# f0_norm = f0.clone() # create a copy of the input Tensor +# batch_size, _, frame_length = f0_norm.shape +# for i in range(batch_size): +# means = torch.mean(f0_norm[i, 0, :]) +# if random_scale: +# factor = random.uniform(0.8, 1.2) +# else: +# factor = 1 +# f0_norm[i, 0, :] = (f0_norm[i, 0, :] - means) * factor +# return f0_norm +# def normalize_f0(f0, random_scale=True): +# means = torch.mean(f0[:, 0, :], dim=1, keepdim=True) +# if random_scale: +# factor = torch.Tensor(f0.shape[0],1).uniform_(0.8, 1.2).to(f0.device) +# else: +# factor = torch.ones(f0.shape[0], 1, 1).to(f0.device) +# f0_norm = (f0 - means.unsqueeze(-1)) * factor.unsqueeze(-1) +# return f0_norm + +def deprecated(func): + """This is a decorator which can be used to mark functions + as deprecated. It will result in a warning being emitted + when the function is used.""" + @functools.wraps(func) + def new_func(*args, **kwargs): + warnings.simplefilter('always', DeprecationWarning) # turn off filter + warnings.warn("Call to deprecated function {}.".format(func.__name__), + category=DeprecationWarning, + stacklevel=2) + warnings.simplefilter('default', DeprecationWarning) # reset filter + return func(*args, **kwargs) + return new_func + +def normalize_f0(f0, x_mask, uv, random_scale=True): + # calculate means based on x_mask + uv_sum = torch.sum(uv, dim=1, keepdim=True) + uv_sum[uv_sum == 0] = 9999 + means = torch.sum(f0[:, 0, :] * uv, dim=1, keepdim=True) / uv_sum + + if random_scale: + factor = torch.Tensor(f0.shape[0], 1).uniform_(0.8, 1.2).to(f0.device) + else: + factor = torch.ones(f0.shape[0], 1).to(f0.device) + # normalize f0 based on means and factor + f0_norm = (f0 - means.unsqueeze(-1)) * factor.unsqueeze(-1) + if torch.isnan(f0_norm).any(): + exit(0) + return f0_norm * x_mask + +def compute_f0_uv_torchcrepe(wav_numpy, p_len=None, sampling_rate=44100, hop_length=512,device=None,cr_threshold=0.05): + from modules.crepe import CrepePitchExtractor + x = wav_numpy + if p_len is None: + p_len = x.shape[0]//hop_length + else: + assert abs(p_len-x.shape[0]//hop_length) < 4, "pad length error" + + f0_min = 50 + f0_max = 1100 + F0Creper = CrepePitchExtractor(hop_length=hop_length,f0_min=f0_min,f0_max=f0_max,device=device,threshold=cr_threshold) + f0,uv = F0Creper(x[None,:].float(),sampling_rate,pad_to=p_len) + return f0,uv + +def plot_data_to_numpy(x, y): + global MATPLOTLIB_FLAG + if not MATPLOTLIB_FLAG: + import matplotlib + matplotlib.use("Agg") + MATPLOTLIB_FLAG = True + mpl_logger = logging.getLogger('matplotlib') + mpl_logger.setLevel(logging.WARNING) + import matplotlib.pylab as plt + import numpy as np + + fig, ax = plt.subplots(figsize=(10, 2)) + plt.plot(x) + plt.plot(y) + plt.tight_layout() + + fig.canvas.draw() + data = np.fromstring(fig.canvas.tostring_rgb(), dtype=np.uint8, sep='') + data = data.reshape(fig.canvas.get_width_height()[::-1] + (3,)) + plt.close() + return data + + + +def interpolate_f0(f0): + + data = np.reshape(f0, (f0.size, 1)) + + vuv_vector = np.zeros((data.size, 1), dtype=np.float32) + vuv_vector[data > 0.0] = 1.0 + vuv_vector[data <= 0.0] = 0.0 + + ip_data = data + + frame_number = data.size + last_value = 0.0 + for i in range(frame_number): + if data[i] <= 0.0: + j = i + 1 + for j in range(i + 1, frame_number): + if data[j] > 0.0: + break + if j < frame_number - 1: + if last_value > 0.0: + step = (data[j] - data[i - 1]) / float(j - i) + for k in range(i, j): + ip_data[k] = data[i - 1] + step * (k - i + 1) + else: + for k in range(i, j): + ip_data[k] = data[j] + else: + for k in range(i, frame_number): + ip_data[k] = last_value + else: + ip_data[i] = data[i] # this may not be necessary + last_value = data[i] + + return ip_data[:,0], vuv_vector[:,0] + + +def compute_f0_parselmouth(wav_numpy, p_len=None, sampling_rate=44100, hop_length=512): + import parselmouth + x = wav_numpy + if p_len is None: + p_len = x.shape[0]//hop_length + else: + assert abs(p_len-x.shape[0]//hop_length) < 4, "pad length error" + time_step = hop_length / sampling_rate * 1000 + f0_min = 50 + f0_max = 1100 + f0 = parselmouth.Sound(x, sampling_rate).to_pitch_ac( + time_step=time_step / 1000, voicing_threshold=0.6, + pitch_floor=f0_min, pitch_ceiling=f0_max).selected_array['frequency'] + + pad_size=(p_len - len(f0) + 1) // 2 + if(pad_size>0 or p_len - len(f0) - pad_size>0): + f0 = np.pad(f0,[[pad_size,p_len - len(f0) - pad_size]], mode='constant') + return f0 + +def resize_f0(x, target_len): + source = np.array(x) + source[source<0.001] = np.nan + target = np.interp(np.arange(0, len(source)*target_len, len(source))/ target_len, np.arange(0, len(source)), source) + res = np.nan_to_num(target) + return res + +def compute_f0_dio(wav_numpy, p_len=None, sampling_rate=44100, hop_length=512): + import pyworld + if p_len is None: + p_len = wav_numpy.shape[0]//hop_length + f0, t = pyworld.dio( + wav_numpy.astype(np.double), + fs=sampling_rate, + f0_ceil=800, + frame_period=1000 * hop_length / sampling_rate, + ) + f0 = pyworld.stonemask(wav_numpy.astype(np.double), f0, t, sampling_rate) + for index, pitch in enumerate(f0): + f0[index] = round(pitch, 1) + return resize_f0(f0, p_len) + +def f0_to_coarse(f0): + is_torch = isinstance(f0, torch.Tensor) + f0_mel = 1127 * (1 + f0 / 700).log() if is_torch else 1127 * np.log(1 + f0 / 700) + f0_mel[f0_mel > 0] = (f0_mel[f0_mel > 0] - f0_mel_min) * (f0_bin - 2) / (f0_mel_max - f0_mel_min) + 1 + + f0_mel[f0_mel <= 1] = 1 + f0_mel[f0_mel > f0_bin - 1] = f0_bin - 1 + f0_coarse = (f0_mel + 0.5).int() if is_torch else np.rint(f0_mel).astype(np.int) + assert f0_coarse.max() <= 255 and f0_coarse.min() >= 1, (f0_coarse.max(), f0_coarse.min()) + return f0_coarse + + +def get_hubert_model(): + vec_path = "hubert/checkpoint_best_legacy_500.pt" + print("load model(s) from {}".format(vec_path)) + from fairseq import checkpoint_utils + models, saved_cfg, task = checkpoint_utils.load_model_ensemble_and_task( + [vec_path], + suffix="", + ) + model = models[0] + model.eval() + return model + +def get_hubert_content(hmodel, wav_16k_tensor): + feats = wav_16k_tensor + if feats.dim() == 2: # double channels + feats = feats.mean(-1) + assert feats.dim() == 1, feats.dim() + feats = feats.view(1, -1) + padding_mask = torch.BoolTensor(feats.shape).fill_(False) + inputs = { + "source": feats.to(wav_16k_tensor.device), + "padding_mask": padding_mask.to(wav_16k_tensor.device), + "output_layer": 9, # layer 9 + } + with torch.no_grad(): + logits = hmodel.extract_features(**inputs) + feats = hmodel.final_proj(logits[0]) + return feats.transpose(1, 2) + + +def get_content(cmodel, y): + with torch.no_grad(): + c = cmodel.extract_features(y.squeeze(1))[0] + c = c.transpose(1, 2) + return c + + + +def load_checkpoint(checkpoint_path, model, optimizer=None, skip_optimizer=False): + assert os.path.isfile(checkpoint_path) + checkpoint_dict = torch.load(checkpoint_path, map_location='cpu') + iteration = checkpoint_dict['iteration'] + learning_rate = checkpoint_dict['learning_rate'] + if optimizer is not None and not skip_optimizer and checkpoint_dict['optimizer'] is not None: + optimizer.load_state_dict(checkpoint_dict['optimizer']) + saved_state_dict = checkpoint_dict['model'] + if hasattr(model, 'module'): + state_dict = model.module.state_dict() + else: + state_dict = model.state_dict() + new_state_dict = {} + for k, v in state_dict.items(): + try: + # assert "dec" in k or "disc" in k + # print("load", k) + new_state_dict[k] = saved_state_dict[k] + assert saved_state_dict[k].shape == v.shape, (saved_state_dict[k].shape, v.shape) + except: + print("error, %s is not in the checkpoint" % k) + logger.info("%s is not in the checkpoint" % k) + new_state_dict[k] = v + if hasattr(model, 'module'): + model.module.load_state_dict(new_state_dict) + else: + model.load_state_dict(new_state_dict) + print("load ") + logger.info("Loaded checkpoint '{}' (iteration {})".format( + checkpoint_path, iteration)) + return model, optimizer, learning_rate, iteration + + +def save_checkpoint(model, optimizer, learning_rate, iteration, checkpoint_path): + logger.info("Saving model and optimizer state at iteration {} to {}".format( + iteration, checkpoint_path)) + if hasattr(model, 'module'): + state_dict = model.module.state_dict() + else: + state_dict = model.state_dict() + torch.save({'model': state_dict, + 'iteration': iteration, + 'optimizer': optimizer.state_dict(), + 'learning_rate': learning_rate}, checkpoint_path) + +def clean_checkpoints(path_to_models='logs/44k/', n_ckpts_to_keep=2, sort_by_time=True): + """Freeing up space by deleting saved ckpts + + Arguments: + path_to_models -- Path to the model directory + n_ckpts_to_keep -- Number of ckpts to keep, excluding G_0.pth and D_0.pth + sort_by_time -- True -> chronologically delete ckpts + False -> lexicographically delete ckpts + """ + ckpts_files = [f for f in os.listdir(path_to_models) if os.path.isfile(os.path.join(path_to_models, f))] + name_key = (lambda _f: int(re.compile('._(\d+)\.pth').match(_f).group(1))) + time_key = (lambda _f: os.path.getmtime(os.path.join(path_to_models, _f))) + sort_key = time_key if sort_by_time else name_key + x_sorted = lambda _x: sorted([f for f in ckpts_files if f.startswith(_x) and not f.endswith('_0.pth')], key=sort_key) + to_del = [os.path.join(path_to_models, fn) for fn in + (x_sorted('G')[:-n_ckpts_to_keep] + x_sorted('D')[:-n_ckpts_to_keep])] + del_info = lambda fn: logger.info(f".. Free up space by deleting ckpt {fn}") + del_routine = lambda x: [os.remove(x), del_info(x)] + rs = [del_routine(fn) for fn in to_del] + +def summarize(writer, global_step, scalars={}, histograms={}, images={}, audios={}, audio_sampling_rate=22050): + for k, v in scalars.items(): + writer.add_scalar(k, v, global_step) + for k, v in histograms.items(): + writer.add_histogram(k, v, global_step) + for k, v in images.items(): + writer.add_image(k, v, global_step, dataformats='HWC') + for k, v in audios.items(): + writer.add_audio(k, v, global_step, audio_sampling_rate) + + +def latest_checkpoint_path(dir_path, regex="G_*.pth"): + f_list = glob.glob(os.path.join(dir_path, regex)) + f_list.sort(key=lambda f: int("".join(filter(str.isdigit, f)))) + x = f_list[-1] + print(x) + return x + + +def plot_spectrogram_to_numpy(spectrogram): + global MATPLOTLIB_FLAG + if not MATPLOTLIB_FLAG: + import matplotlib + matplotlib.use("Agg") + MATPLOTLIB_FLAG = True + mpl_logger = logging.getLogger('matplotlib') + mpl_logger.setLevel(logging.WARNING) + import matplotlib.pylab as plt + import numpy as np + + fig, ax = plt.subplots(figsize=(10,2)) + im = ax.imshow(spectrogram, aspect="auto", origin="lower", + interpolation='none') + plt.colorbar(im, ax=ax) + plt.xlabel("Frames") + plt.ylabel("Channels") + plt.tight_layout() + + fig.canvas.draw() + data = np.fromstring(fig.canvas.tostring_rgb(), dtype=np.uint8, sep='') + data = data.reshape(fig.canvas.get_width_height()[::-1] + (3,)) + plt.close() + return data + + +def plot_alignment_to_numpy(alignment, info=None): + global MATPLOTLIB_FLAG + if not MATPLOTLIB_FLAG: + import matplotlib + matplotlib.use("Agg") + MATPLOTLIB_FLAG = True + mpl_logger = logging.getLogger('matplotlib') + mpl_logger.setLevel(logging.WARNING) + import matplotlib.pylab as plt + import numpy as np + + fig, ax = plt.subplots(figsize=(6, 4)) + im = ax.imshow(alignment.transpose(), aspect='auto', origin='lower', + interpolation='none') + fig.colorbar(im, ax=ax) + xlabel = 'Decoder timestep' + if info is not None: + xlabel += '\n\n' + info + plt.xlabel(xlabel) + plt.ylabel('Encoder timestep') + plt.tight_layout() + + fig.canvas.draw() + data = np.fromstring(fig.canvas.tostring_rgb(), dtype=np.uint8, sep='') + data = data.reshape(fig.canvas.get_width_height()[::-1] + (3,)) + plt.close() + return data + + +def load_wav_to_torch(full_path): + sampling_rate, data = read(full_path) + return torch.FloatTensor(data.astype(np.float32)), sampling_rate + + +def load_filepaths_and_text(filename, split="|"): + with open(filename, encoding='utf-8') as f: + filepaths_and_text = [line.strip().split(split) for line in f] + return filepaths_and_text + + +def get_hparams(init=True): + parser = argparse.ArgumentParser() + parser.add_argument('-c', '--config', type=str, default="./configs/base.json", + help='JSON file for configuration') + parser.add_argument('-m', '--model', type=str, required=True, + help='Model name') + + args = parser.parse_args() + model_dir = os.path.join("./logs", args.model) + + if not os.path.exists(model_dir): + os.makedirs(model_dir) + + config_path = args.config + config_save_path = os.path.join(model_dir, "config.json") + if init: + with open(config_path, "r") as f: + data = f.read() + with open(config_save_path, "w") as f: + f.write(data) + else: + with open(config_save_path, "r") as f: + data = f.read() + config = json.loads(data) + + hparams = HParams(**config) + hparams.model_dir = model_dir + return hparams + + +def get_hparams_from_dir(model_dir): + config_save_path = os.path.join(model_dir, "config.json") + with open(config_save_path, "r") as f: + data = f.read() + config = json.loads(data) + + hparams =HParams(**config) + hparams.model_dir = model_dir + return hparams + + +def get_hparams_from_file(config_path): + with open(config_path, "r") as f: + data = f.read() + config = json.loads(data) + + hparams =HParams(**config) + return hparams + + +def check_git_hash(model_dir): + source_dir = os.path.dirname(os.path.realpath(__file__)) + if not os.path.exists(os.path.join(source_dir, ".git")): + logger.warn("{} is not a git repository, therefore hash value comparison will be ignored.".format( + source_dir + )) + return + + cur_hash = subprocess.getoutput("git rev-parse HEAD") + + path = os.path.join(model_dir, "githash") + if os.path.exists(path): + saved_hash = open(path).read() + if saved_hash != cur_hash: + logger.warn("git hash values are different. {}(saved) != {}(current)".format( + saved_hash[:8], cur_hash[:8])) + else: + open(path, "w").write(cur_hash) + + +def get_logger(model_dir, filename="train.log"): + global logger + logger = logging.getLogger(os.path.basename(model_dir)) + logger.setLevel(logging.DEBUG) + + formatter = logging.Formatter("%(asctime)s\t%(name)s\t%(levelname)s\t%(message)s") + if not os.path.exists(model_dir): + os.makedirs(model_dir) + h = logging.FileHandler(os.path.join(model_dir, filename)) + h.setLevel(logging.DEBUG) + h.setFormatter(formatter) + logger.addHandler(h) + return logger + + +def repeat_expand_2d(content, target_len): + # content : [h, t] + + src_len = content.shape[-1] + target = torch.zeros([content.shape[0], target_len], dtype=torch.float).to(content.device) + temp = torch.arange(src_len+1) * target_len / src_len + current_pos = 0 + for i in range(target_len): + if i < temp[current_pos+1]: + target[:, i] = content[:, current_pos] + else: + current_pos += 1 + target[:, i] = content[:, current_pos] + + return target + + +def mix_model(model_paths,mix_rate,mode): + mix_rate = torch.FloatTensor(mix_rate)/100 + model_tem = torch.load(model_paths[0]) + models = [torch.load(path)["model"] for path in model_paths] + if mode == 0: + mix_rate = F.softmax(mix_rate,dim=0) + for k in model_tem["model"].keys(): + model_tem["model"][k] = torch.zeros_like(model_tem["model"][k]) + for i,model in enumerate(models): + model_tem["model"][k] += model[k]*mix_rate[i] + torch.save(model_tem,os.path.join(os.path.curdir,"output.pth")) + return os.path.join(os.path.curdir,"output.pth") + +class HParams(): + def __init__(self, **kwargs): + for k, v in kwargs.items(): + if type(v) == dict: + v = HParams(**v) + self[k] = v + + def keys(self): + return self.__dict__.keys() + + def items(self): + return self.__dict__.items() + + def values(self): + return self.__dict__.values() + + def __len__(self): + return len(self.__dict__) + + def __getitem__(self, key): + return getattr(self, key) + + def __setitem__(self, key, value): + return setattr(self, key, value) + + def __contains__(self, key): + return key in self.__dict__ + + def __repr__(self): + return self.__dict__.__repr__() + diff --git a/vdecoder/__init__.py b/vdecoder/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/vdecoder/hifigan/env.py b/vdecoder/hifigan/env.py new file mode 100644 index 0000000000000000000000000000000000000000..2bdbc95d4f7a8bad8fd4f5eef657e2b51d946056 --- /dev/null +++ b/vdecoder/hifigan/env.py @@ -0,0 +1,15 @@ +import os +import shutil + + +class AttrDict(dict): + def __init__(self, *args, **kwargs): + super(AttrDict, self).__init__(*args, **kwargs) + self.__dict__ = self + + +def build_env(config, config_name, path): + t_path = os.path.join(path, config_name) + if config != t_path: + os.makedirs(path, exist_ok=True) + shutil.copyfile(config, os.path.join(path, config_name)) diff --git a/vdecoder/hifigan/models.py b/vdecoder/hifigan/models.py new file mode 100644 index 0000000000000000000000000000000000000000..9747301f350bb269e62601017fe4633ce271b27e --- /dev/null +++ b/vdecoder/hifigan/models.py @@ -0,0 +1,503 @@ +import os +import json +from .env import AttrDict +import numpy as np +import torch +import torch.nn.functional as F +import torch.nn as nn +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm, spectral_norm +from .utils import init_weights, get_padding + +LRELU_SLOPE = 0.1 + + +def load_model(model_path, device='cuda'): + config_file = os.path.join(os.path.split(model_path)[0], 'config.json') + with open(config_file) as f: + data = f.read() + + global h + json_config = json.loads(data) + h = AttrDict(json_config) + + generator = Generator(h).to(device) + + cp_dict = torch.load(model_path) + generator.load_state_dict(cp_dict['generator']) + generator.eval() + generator.remove_weight_norm() + del cp_dict + return generator, h + + +class ResBlock1(torch.nn.Module): + def __init__(self, h, channels, kernel_size=3, dilation=(1, 3, 5)): + super(ResBlock1, self).__init__() + self.h = h + self.convs1 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[2], + padding=get_padding(kernel_size, dilation[2]))) + ]) + self.convs1.apply(init_weights) + + self.convs2 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))) + ]) + self.convs2.apply(init_weights) + + def forward(self, x): + for c1, c2 in zip(self.convs1, self.convs2): + xt = F.leaky_relu(x, LRELU_SLOPE) + xt = c1(xt) + xt = F.leaky_relu(xt, LRELU_SLOPE) + xt = c2(xt) + x = xt + x + return x + + def remove_weight_norm(self): + for l in self.convs1: + remove_weight_norm(l) + for l in self.convs2: + remove_weight_norm(l) + + +class ResBlock2(torch.nn.Module): + def __init__(self, h, channels, kernel_size=3, dilation=(1, 3)): + super(ResBlock2, self).__init__() + self.h = h + self.convs = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))) + ]) + self.convs.apply(init_weights) + + def forward(self, x): + for c in self.convs: + xt = F.leaky_relu(x, LRELU_SLOPE) + xt = c(xt) + x = xt + x + return x + + def remove_weight_norm(self): + for l in self.convs: + remove_weight_norm(l) + + +def padDiff(x): + return F.pad(F.pad(x, (0,0,-1,1), 'constant', 0) - x, (0,0,0,-1), 'constant', 0) + +class SineGen(torch.nn.Module): + """ Definition of sine generator + SineGen(samp_rate, harmonic_num = 0, + sine_amp = 0.1, noise_std = 0.003, + voiced_threshold = 0, + flag_for_pulse=False) + samp_rate: sampling rate in Hz + harmonic_num: number of harmonic overtones (default 0) + sine_amp: amplitude of sine-wavefrom (default 0.1) + noise_std: std of Gaussian noise (default 0.003) + voiced_thoreshold: F0 threshold for U/V classification (default 0) + flag_for_pulse: this SinGen is used inside PulseGen (default False) + Note: when flag_for_pulse is True, the first time step of a voiced + segment is always sin(np.pi) or cos(0) + """ + + def __init__(self, samp_rate, harmonic_num=0, + sine_amp=0.1, noise_std=0.003, + voiced_threshold=0, + flag_for_pulse=False): + super(SineGen, self).__init__() + self.sine_amp = sine_amp + self.noise_std = noise_std + self.harmonic_num = harmonic_num + self.dim = self.harmonic_num + 1 + self.sampling_rate = samp_rate + self.voiced_threshold = voiced_threshold + self.flag_for_pulse = flag_for_pulse + + def _f02uv(self, f0): + # generate uv signal + uv = (f0 > self.voiced_threshold).type(torch.float32) + return uv + + def _f02sine(self, f0_values): + """ f0_values: (batchsize, length, dim) + where dim indicates fundamental tone and overtones + """ + # convert to F0 in rad. The interger part n can be ignored + # because 2 * np.pi * n doesn't affect phase + rad_values = (f0_values / self.sampling_rate) % 1 + + # initial phase noise (no noise for fundamental component) + rand_ini = torch.rand(f0_values.shape[0], f0_values.shape[2], \ + device=f0_values.device) + rand_ini[:, 0] = 0 + rad_values[:, 0, :] = rad_values[:, 0, :] + rand_ini + + # instantanouse phase sine[t] = sin(2*pi \sum_i=1 ^{t} rad) + if not self.flag_for_pulse: + # for normal case + + # To prevent torch.cumsum numerical overflow, + # it is necessary to add -1 whenever \sum_k=1^n rad_value_k > 1. + # Buffer tmp_over_one_idx indicates the time step to add -1. + # This will not change F0 of sine because (x-1) * 2*pi = x * 2*pi + tmp_over_one = torch.cumsum(rad_values, 1) % 1 + tmp_over_one_idx = (padDiff(tmp_over_one)) < 0 + cumsum_shift = torch.zeros_like(rad_values) + cumsum_shift[:, 1:, :] = tmp_over_one_idx * -1.0 + + sines = torch.sin(torch.cumsum(rad_values + cumsum_shift, dim=1) + * 2 * np.pi) + else: + # If necessary, make sure that the first time step of every + # voiced segments is sin(pi) or cos(0) + # This is used for pulse-train generation + + # identify the last time step in unvoiced segments + uv = self._f02uv(f0_values) + uv_1 = torch.roll(uv, shifts=-1, dims=1) + uv_1[:, -1, :] = 1 + u_loc = (uv < 1) * (uv_1 > 0) + + # get the instantanouse phase + tmp_cumsum = torch.cumsum(rad_values, dim=1) + # different batch needs to be processed differently + for idx in range(f0_values.shape[0]): + temp_sum = tmp_cumsum[idx, u_loc[idx, :, 0], :] + temp_sum[1:, :] = temp_sum[1:, :] - temp_sum[0:-1, :] + # stores the accumulation of i.phase within + # each voiced segments + tmp_cumsum[idx, :, :] = 0 + tmp_cumsum[idx, u_loc[idx, :, 0], :] = temp_sum + + # rad_values - tmp_cumsum: remove the accumulation of i.phase + # within the previous voiced segment. + i_phase = torch.cumsum(rad_values - tmp_cumsum, dim=1) + + # get the sines + sines = torch.cos(i_phase * 2 * np.pi) + return sines + + def forward(self, f0): + """ sine_tensor, uv = forward(f0) + input F0: tensor(batchsize=1, length, dim=1) + f0 for unvoiced steps should be 0 + output sine_tensor: tensor(batchsize=1, length, dim) + output uv: tensor(batchsize=1, length, 1) + """ + with torch.no_grad(): + f0_buf = torch.zeros(f0.shape[0], f0.shape[1], self.dim, + device=f0.device) + # fundamental component + fn = torch.multiply(f0, torch.FloatTensor([[range(1, self.harmonic_num + 2)]]).to(f0.device)) + + # generate sine waveforms + sine_waves = self._f02sine(fn) * self.sine_amp + + # generate uv signal + # uv = torch.ones(f0.shape) + # uv = uv * (f0 > self.voiced_threshold) + uv = self._f02uv(f0) + + # noise: for unvoiced should be similar to sine_amp + # std = self.sine_amp/3 -> max value ~ self.sine_amp + # . for voiced regions is self.noise_std + noise_amp = uv * self.noise_std + (1 - uv) * self.sine_amp / 3 + noise = noise_amp * torch.randn_like(sine_waves) + + # first: set the unvoiced part to 0 by uv + # then: additive noise + sine_waves = sine_waves * uv + noise + return sine_waves, uv, noise + + +class SourceModuleHnNSF(torch.nn.Module): + """ SourceModule for hn-nsf + SourceModule(sampling_rate, harmonic_num=0, sine_amp=0.1, + add_noise_std=0.003, voiced_threshod=0) + sampling_rate: sampling_rate in Hz + harmonic_num: number of harmonic above F0 (default: 0) + sine_amp: amplitude of sine source signal (default: 0.1) + add_noise_std: std of additive Gaussian noise (default: 0.003) + note that amplitude of noise in unvoiced is decided + by sine_amp + voiced_threshold: threhold to set U/V given F0 (default: 0) + Sine_source, noise_source = SourceModuleHnNSF(F0_sampled) + F0_sampled (batchsize, length, 1) + Sine_source (batchsize, length, 1) + noise_source (batchsize, length 1) + uv (batchsize, length, 1) + """ + + def __init__(self, sampling_rate, harmonic_num=0, sine_amp=0.1, + add_noise_std=0.003, voiced_threshod=0): + super(SourceModuleHnNSF, self).__init__() + + self.sine_amp = sine_amp + self.noise_std = add_noise_std + + # to produce sine waveforms + self.l_sin_gen = SineGen(sampling_rate, harmonic_num, + sine_amp, add_noise_std, voiced_threshod) + + # to merge source harmonics into a single excitation + self.l_linear = torch.nn.Linear(harmonic_num + 1, 1) + self.l_tanh = torch.nn.Tanh() + + def forward(self, x): + """ + Sine_source, noise_source = SourceModuleHnNSF(F0_sampled) + F0_sampled (batchsize, length, 1) + Sine_source (batchsize, length, 1) + noise_source (batchsize, length 1) + """ + # source for harmonic branch + sine_wavs, uv, _ = self.l_sin_gen(x) + sine_merge = self.l_tanh(self.l_linear(sine_wavs)) + + # source for noise branch, in the same shape as uv + noise = torch.randn_like(uv) * self.sine_amp / 3 + return sine_merge, noise, uv + + +class Generator(torch.nn.Module): + def __init__(self, h): + super(Generator, self).__init__() + self.h = h + + self.num_kernels = len(h["resblock_kernel_sizes"]) + self.num_upsamples = len(h["upsample_rates"]) + self.f0_upsamp = torch.nn.Upsample(scale_factor=np.prod(h["upsample_rates"])) + self.m_source = SourceModuleHnNSF( + sampling_rate=h["sampling_rate"], + harmonic_num=8) + self.noise_convs = nn.ModuleList() + self.conv_pre = weight_norm(Conv1d(h["inter_channels"], h["upsample_initial_channel"], 7, 1, padding=3)) + resblock = ResBlock1 if h["resblock"] == '1' else ResBlock2 + self.ups = nn.ModuleList() + for i, (u, k) in enumerate(zip(h["upsample_rates"], h["upsample_kernel_sizes"])): + c_cur = h["upsample_initial_channel"] // (2 ** (i + 1)) + self.ups.append(weight_norm( + ConvTranspose1d(h["upsample_initial_channel"] // (2 ** i), h["upsample_initial_channel"] // (2 ** (i + 1)), + k, u, padding=(k - u) // 2))) + if i + 1 < len(h["upsample_rates"]): # + stride_f0 = np.prod(h["upsample_rates"][i + 1:]) + self.noise_convs.append(Conv1d( + 1, c_cur, kernel_size=stride_f0 * 2, stride=stride_f0, padding=stride_f0 // 2)) + else: + self.noise_convs.append(Conv1d(1, c_cur, kernel_size=1)) + self.resblocks = nn.ModuleList() + for i in range(len(self.ups)): + ch = h["upsample_initial_channel"] // (2 ** (i + 1)) + for j, (k, d) in enumerate(zip(h["resblock_kernel_sizes"], h["resblock_dilation_sizes"])): + self.resblocks.append(resblock(h, ch, k, d)) + + self.conv_post = weight_norm(Conv1d(ch, 1, 7, 1, padding=3)) + self.ups.apply(init_weights) + self.conv_post.apply(init_weights) + self.cond = nn.Conv1d(h['gin_channels'], h['upsample_initial_channel'], 1) + + def forward(self, x, f0, g=None): + # print(1,x.shape,f0.shape,f0[:, None].shape) + f0 = self.f0_upsamp(f0[:, None]).transpose(1, 2) # bs,n,t + # print(2,f0.shape) + har_source, noi_source, uv = self.m_source(f0) + har_source = har_source.transpose(1, 2) + x = self.conv_pre(x) + x = x + self.cond(g) + # print(124,x.shape,har_source.shape) + for i in range(self.num_upsamples): + x = F.leaky_relu(x, LRELU_SLOPE) + # print(3,x.shape) + x = self.ups[i](x) + x_source = self.noise_convs[i](har_source) + # print(4,x_source.shape,har_source.shape,x.shape) + x = x + x_source + xs = None + for j in range(self.num_kernels): + if xs is None: + xs = self.resblocks[i * self.num_kernels + j](x) + else: + xs += self.resblocks[i * self.num_kernels + j](x) + x = xs / self.num_kernels + x = F.leaky_relu(x) + x = self.conv_post(x) + x = torch.tanh(x) + + return x + + def remove_weight_norm(self): + print('Removing weight norm...') + for l in self.ups: + remove_weight_norm(l) + for l in self.resblocks: + l.remove_weight_norm() + remove_weight_norm(self.conv_pre) + remove_weight_norm(self.conv_post) + + +class DiscriminatorP(torch.nn.Module): + def __init__(self, period, kernel_size=5, stride=3, use_spectral_norm=False): + super(DiscriminatorP, self).__init__() + self.period = period + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv2d(1, 32, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(32, 128, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(128, 512, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(512, 1024, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(1024, 1024, (kernel_size, 1), 1, padding=(2, 0))), + ]) + self.conv_post = norm_f(Conv2d(1024, 1, (3, 1), 1, padding=(1, 0))) + + def forward(self, x): + fmap = [] + + # 1d to 2d + b, c, t = x.shape + if t % self.period != 0: # pad first + n_pad = self.period - (t % self.period) + x = F.pad(x, (0, n_pad), "reflect") + t = t + n_pad + x = x.view(b, c, t // self.period, self.period) + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class MultiPeriodDiscriminator(torch.nn.Module): + def __init__(self, periods=None): + super(MultiPeriodDiscriminator, self).__init__() + self.periods = periods if periods is not None else [2, 3, 5, 7, 11] + self.discriminators = nn.ModuleList() + for period in self.periods: + self.discriminators.append(DiscriminatorP(period)) + + def forward(self, y, y_hat): + y_d_rs = [] + y_d_gs = [] + fmap_rs = [] + fmap_gs = [] + for i, d in enumerate(self.discriminators): + y_d_r, fmap_r = d(y) + y_d_g, fmap_g = d(y_hat) + y_d_rs.append(y_d_r) + fmap_rs.append(fmap_r) + y_d_gs.append(y_d_g) + fmap_gs.append(fmap_g) + + return y_d_rs, y_d_gs, fmap_rs, fmap_gs + + +class DiscriminatorS(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(DiscriminatorS, self).__init__() + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv1d(1, 128, 15, 1, padding=7)), + norm_f(Conv1d(128, 128, 41, 2, groups=4, padding=20)), + norm_f(Conv1d(128, 256, 41, 2, groups=16, padding=20)), + norm_f(Conv1d(256, 512, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(512, 1024, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(1024, 1024, 41, 1, groups=16, padding=20)), + norm_f(Conv1d(1024, 1024, 5, 1, padding=2)), + ]) + self.conv_post = norm_f(Conv1d(1024, 1, 3, 1, padding=1)) + + def forward(self, x): + fmap = [] + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class MultiScaleDiscriminator(torch.nn.Module): + def __init__(self): + super(MultiScaleDiscriminator, self).__init__() + self.discriminators = nn.ModuleList([ + DiscriminatorS(use_spectral_norm=True), + DiscriminatorS(), + DiscriminatorS(), + ]) + self.meanpools = nn.ModuleList([ + AvgPool1d(4, 2, padding=2), + AvgPool1d(4, 2, padding=2) + ]) + + def forward(self, y, y_hat): + y_d_rs = [] + y_d_gs = [] + fmap_rs = [] + fmap_gs = [] + for i, d in enumerate(self.discriminators): + if i != 0: + y = self.meanpools[i - 1](y) + y_hat = self.meanpools[i - 1](y_hat) + y_d_r, fmap_r = d(y) + y_d_g, fmap_g = d(y_hat) + y_d_rs.append(y_d_r) + fmap_rs.append(fmap_r) + y_d_gs.append(y_d_g) + fmap_gs.append(fmap_g) + + return y_d_rs, y_d_gs, fmap_rs, fmap_gs + + +def feature_loss(fmap_r, fmap_g): + loss = 0 + for dr, dg in zip(fmap_r, fmap_g): + for rl, gl in zip(dr, dg): + loss += torch.mean(torch.abs(rl - gl)) + + return loss * 2 + + +def discriminator_loss(disc_real_outputs, disc_generated_outputs): + loss = 0 + r_losses = [] + g_losses = [] + for dr, dg in zip(disc_real_outputs, disc_generated_outputs): + r_loss = torch.mean((1 - dr) ** 2) + g_loss = torch.mean(dg ** 2) + loss += (r_loss + g_loss) + r_losses.append(r_loss.item()) + g_losses.append(g_loss.item()) + + return loss, r_losses, g_losses + + +def generator_loss(disc_outputs): + loss = 0 + gen_losses = [] + for dg in disc_outputs: + l = torch.mean((1 - dg) ** 2) + gen_losses.append(l) + loss += l + + return loss, gen_losses diff --git a/vdecoder/hifigan/nvSTFT.py b/vdecoder/hifigan/nvSTFT.py new file mode 100644 index 0000000000000000000000000000000000000000..88597d62a505715091f9ba62d38bf0a85a31b95a --- /dev/null +++ b/vdecoder/hifigan/nvSTFT.py @@ -0,0 +1,111 @@ +import math +import os +os.environ["LRU_CACHE_CAPACITY"] = "3" +import random +import torch +import torch.utils.data +import numpy as np +import librosa +from librosa.util import normalize +from librosa.filters import mel as librosa_mel_fn +from scipy.io.wavfile import read +import soundfile as sf + +def load_wav_to_torch(full_path, target_sr=None, return_empty_on_exception=False): + sampling_rate = None + try: + data, sampling_rate = sf.read(full_path, always_2d=True)# than soundfile. + except Exception as ex: + print(f"'{full_path}' failed to load.\nException:") + print(ex) + if return_empty_on_exception: + return [], sampling_rate or target_sr or 32000 + else: + raise Exception(ex) + + if len(data.shape) > 1: + data = data[:, 0] + assert len(data) > 2# check duration of audio file is > 2 samples (because otherwise the slice operation was on the wrong dimension) + + if np.issubdtype(data.dtype, np.integer): # if audio data is type int + max_mag = -np.iinfo(data.dtype).min # maximum magnitude = min possible value of intXX + else: # if audio data is type fp32 + max_mag = max(np.amax(data), -np.amin(data)) + max_mag = (2**31)+1 if max_mag > (2**15) else ((2**15)+1 if max_mag > 1.01 else 1.0) # data should be either 16-bit INT, 32-bit INT or [-1 to 1] float32 + + data = torch.FloatTensor(data.astype(np.float32))/max_mag + + if (torch.isinf(data) | torch.isnan(data)).any() and return_empty_on_exception:# resample will crash with inf/NaN inputs. return_empty_on_exception will return empty arr instead of except + return [], sampling_rate or target_sr or 32000 + if target_sr is not None and sampling_rate != target_sr: + data = torch.from_numpy(librosa.core.resample(data.numpy(), orig_sr=sampling_rate, target_sr=target_sr)) + sampling_rate = target_sr + + return data, sampling_rate + +def dynamic_range_compression(x, C=1, clip_val=1e-5): + return np.log(np.clip(x, a_min=clip_val, a_max=None) * C) + +def dynamic_range_decompression(x, C=1): + return np.exp(x) / C + +def dynamic_range_compression_torch(x, C=1, clip_val=1e-5): + return torch.log(torch.clamp(x, min=clip_val) * C) + +def dynamic_range_decompression_torch(x, C=1): + return torch.exp(x) / C + +class STFT(): + def __init__(self, sr=22050, n_mels=80, n_fft=1024, win_size=1024, hop_length=256, fmin=20, fmax=11025, clip_val=1e-5): + self.target_sr = sr + + self.n_mels = n_mels + self.n_fft = n_fft + self.win_size = win_size + self.hop_length = hop_length + self.fmin = fmin + self.fmax = fmax + self.clip_val = clip_val + self.mel_basis = {} + self.hann_window = {} + + def get_mel(self, y, center=False): + sampling_rate = self.target_sr + n_mels = self.n_mels + n_fft = self.n_fft + win_size = self.win_size + hop_length = self.hop_length + fmin = self.fmin + fmax = self.fmax + clip_val = self.clip_val + + if torch.min(y) < -1.: + print('min value is ', torch.min(y)) + if torch.max(y) > 1.: + print('max value is ', torch.max(y)) + + if fmax not in self.mel_basis: + mel = librosa_mel_fn(sr=sampling_rate, n_fft=n_fft, n_mels=n_mels, fmin=fmin, fmax=fmax) + self.mel_basis[str(fmax)+'_'+str(y.device)] = torch.from_numpy(mel).float().to(y.device) + self.hann_window[str(y.device)] = torch.hann_window(self.win_size).to(y.device) + + y = torch.nn.functional.pad(y.unsqueeze(1), (int((n_fft-hop_length)/2), int((n_fft-hop_length)/2)), mode='reflect') + y = y.squeeze(1) + + spec = torch.stft(y, n_fft, hop_length=hop_length, win_length=win_size, window=self.hann_window[str(y.device)], + center=center, pad_mode='reflect', normalized=False, onesided=True) + # print(111,spec) + spec = torch.sqrt(spec.pow(2).sum(-1)+(1e-9)) + # print(222,spec) + spec = torch.matmul(self.mel_basis[str(fmax)+'_'+str(y.device)], spec) + # print(333,spec) + spec = dynamic_range_compression_torch(spec, clip_val=clip_val) + # print(444,spec) + return spec + + def __call__(self, audiopath): + audio, sr = load_wav_to_torch(audiopath, target_sr=self.target_sr) + spect = self.get_mel(audio.unsqueeze(0)).squeeze(0) + return spect + +stft = STFT() diff --git a/vdecoder/hifigan/utils.py b/vdecoder/hifigan/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..9c93c996d3cc73c30d71c1fc47056e4230f35c0f --- /dev/null +++ b/vdecoder/hifigan/utils.py @@ -0,0 +1,68 @@ +import glob +import os +import matplotlib +import torch +from torch.nn.utils import weight_norm +# matplotlib.use("Agg") +import matplotlib.pylab as plt + + +def plot_spectrogram(spectrogram): + fig, ax = plt.subplots(figsize=(10, 2)) + im = ax.imshow(spectrogram, aspect="auto", origin="lower", + interpolation='none') + plt.colorbar(im, ax=ax) + + fig.canvas.draw() + plt.close() + + return fig + + +def init_weights(m, mean=0.0, std=0.01): + classname = m.__class__.__name__ + if classname.find("Conv") != -1: + m.weight.data.normal_(mean, std) + + +def apply_weight_norm(m): + classname = m.__class__.__name__ + if classname.find("Conv") != -1: + weight_norm(m) + + +def get_padding(kernel_size, dilation=1): + return int((kernel_size*dilation - dilation)/2) + + +def load_checkpoint(filepath, device): + assert os.path.isfile(filepath) + print("Loading '{}'".format(filepath)) + checkpoint_dict = torch.load(filepath, map_location=device) + print("Complete.") + return checkpoint_dict + + +def save_checkpoint(filepath, obj): + print("Saving checkpoint to {}".format(filepath)) + torch.save(obj, filepath) + print("Complete.") + + +def del_old_checkpoints(cp_dir, prefix, n_models=2): + pattern = os.path.join(cp_dir, prefix + '????????') + cp_list = glob.glob(pattern) # get checkpoint paths + cp_list = sorted(cp_list)# sort by iter + if len(cp_list) > n_models: # if more than n_models models are found + for cp in cp_list[:-n_models]:# delete the oldest models other than lastest n_models + open(cp, 'w').close()# empty file contents + os.unlink(cp)# delete file (move to trash when using Colab) + + +def scan_checkpoint(cp_dir, prefix): + pattern = os.path.join(cp_dir, prefix + '????????') + cp_list = glob.glob(pattern) + if len(cp_list) == 0: + return None + return sorted(cp_list)[-1] + diff --git a/vdecoder/nsf_hifigan/env.py b/vdecoder/nsf_hifigan/env.py new file mode 100644 index 0000000000000000000000000000000000000000..2bdbc95d4f7a8bad8fd4f5eef657e2b51d946056 --- /dev/null +++ b/vdecoder/nsf_hifigan/env.py @@ -0,0 +1,15 @@ +import os +import shutil + + +class AttrDict(dict): + def __init__(self, *args, **kwargs): + super(AttrDict, self).__init__(*args, **kwargs) + self.__dict__ = self + + +def build_env(config, config_name, path): + t_path = os.path.join(path, config_name) + if config != t_path: + os.makedirs(path, exist_ok=True) + shutil.copyfile(config, os.path.join(path, config_name)) diff --git a/vdecoder/nsf_hifigan/models.py b/vdecoder/nsf_hifigan/models.py new file mode 100644 index 0000000000000000000000000000000000000000..eff691f31ac6bbea686c98982c31ce7b30efee75 --- /dev/null +++ b/vdecoder/nsf_hifigan/models.py @@ -0,0 +1,435 @@ +import os +import json +from .env import AttrDict +import numpy as np +import torch +import torch.nn.functional as F +import torch.nn as nn +from torch.nn import Conv1d, ConvTranspose1d, AvgPool1d, Conv2d +from torch.nn.utils import weight_norm, remove_weight_norm, spectral_norm +from .utils import init_weights, get_padding + +LRELU_SLOPE = 0.1 + + +def load_model(model_path, device='cuda'): + config_file = os.path.join(os.path.split(model_path)[0], 'config.json') + with open(config_file) as f: + data = f.read() + + json_config = json.loads(data) + h = AttrDict(json_config) + + generator = Generator(h).to(device) + + cp_dict = torch.load(model_path, map_location=device) + generator.load_state_dict(cp_dict['generator']) + generator.eval() + generator.remove_weight_norm() + del cp_dict + return generator, h + + +class ResBlock1(torch.nn.Module): + def __init__(self, h, channels, kernel_size=3, dilation=(1, 3, 5)): + super(ResBlock1, self).__init__() + self.h = h + self.convs1 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[2], + padding=get_padding(kernel_size, dilation[2]))) + ]) + self.convs1.apply(init_weights) + + self.convs2 = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=1, + padding=get_padding(kernel_size, 1))) + ]) + self.convs2.apply(init_weights) + + def forward(self, x): + for c1, c2 in zip(self.convs1, self.convs2): + xt = F.leaky_relu(x, LRELU_SLOPE) + xt = c1(xt) + xt = F.leaky_relu(xt, LRELU_SLOPE) + xt = c2(xt) + x = xt + x + return x + + def remove_weight_norm(self): + for l in self.convs1: + remove_weight_norm(l) + for l in self.convs2: + remove_weight_norm(l) + + +class ResBlock2(torch.nn.Module): + def __init__(self, h, channels, kernel_size=3, dilation=(1, 3)): + super(ResBlock2, self).__init__() + self.h = h + self.convs = nn.ModuleList([ + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[0], + padding=get_padding(kernel_size, dilation[0]))), + weight_norm(Conv1d(channels, channels, kernel_size, 1, dilation=dilation[1], + padding=get_padding(kernel_size, dilation[1]))) + ]) + self.convs.apply(init_weights) + + def forward(self, x): + for c in self.convs: + xt = F.leaky_relu(x, LRELU_SLOPE) + xt = c(xt) + x = xt + x + return x + + def remove_weight_norm(self): + for l in self.convs: + remove_weight_norm(l) + + +class SineGen(torch.nn.Module): + """ Definition of sine generator + SineGen(samp_rate, harmonic_num = 0, + sine_amp = 0.1, noise_std = 0.003, + voiced_threshold = 0, + flag_for_pulse=False) + samp_rate: sampling rate in Hz + harmonic_num: number of harmonic overtones (default 0) + sine_amp: amplitude of sine-wavefrom (default 0.1) + noise_std: std of Gaussian noise (default 0.003) + voiced_thoreshold: F0 threshold for U/V classification (default 0) + flag_for_pulse: this SinGen is used inside PulseGen (default False) + Note: when flag_for_pulse is True, the first time step of a voiced + segment is always sin(np.pi) or cos(0) + """ + + def __init__(self, samp_rate, harmonic_num=0, + sine_amp=0.1, noise_std=0.003, + voiced_threshold=0): + super(SineGen, self).__init__() + self.sine_amp = sine_amp + self.noise_std = noise_std + self.harmonic_num = harmonic_num + self.dim = self.harmonic_num + 1 + self.sampling_rate = samp_rate + self.voiced_threshold = voiced_threshold + + def _f02uv(self, f0): + # generate uv signal + uv = torch.ones_like(f0) + uv = uv * (f0 > self.voiced_threshold) + return uv + + @torch.no_grad() + def forward(self, f0, upp): + """ sine_tensor, uv = forward(f0) + input F0: tensor(batchsize=1, length, dim=1) + f0 for unvoiced steps should be 0 + output sine_tensor: tensor(batchsize=1, length, dim) + output uv: tensor(batchsize=1, length, 1) + """ + f0 = f0.unsqueeze(-1) + fn = torch.multiply(f0, torch.arange(1, self.dim + 1, device=f0.device).reshape((1, 1, -1))) + rad_values = (fn / self.sampling_rate) % 1 ###%1 means the product of n_har cannot be optimized for post-processing + rand_ini = torch.rand(fn.shape[0], fn.shape[2], device=fn.device) + rand_ini[:, 0] = 0 + rad_values[:, 0, :] = rad_values[:, 0, :] + rand_ini + is_half = rad_values.dtype is not torch.float32 + tmp_over_one = torch.cumsum(rad_values.double(), 1) # % 1 #####%1 means the following cumsum can no longer be optimized + if is_half: + tmp_over_one = tmp_over_one.half() + else: + tmp_over_one = tmp_over_one.float() + tmp_over_one *= upp + tmp_over_one = F.interpolate( + tmp_over_one.transpose(2, 1), scale_factor=upp, + mode='linear', align_corners=True + ).transpose(2, 1) + rad_values = F.interpolate(rad_values.transpose(2, 1), scale_factor=upp, mode='nearest').transpose(2, 1) + tmp_over_one %= 1 + tmp_over_one_idx = (tmp_over_one[:, 1:, :] - tmp_over_one[:, :-1, :]) < 0 + cumsum_shift = torch.zeros_like(rad_values) + cumsum_shift[:, 1:, :] = tmp_over_one_idx * -1.0 + rad_values = rad_values.double() + cumsum_shift = cumsum_shift.double() + sine_waves = torch.sin(torch.cumsum(rad_values + cumsum_shift, dim=1) * 2 * np.pi) + if is_half: + sine_waves = sine_waves.half() + else: + sine_waves = sine_waves.float() + sine_waves = sine_waves * self.sine_amp + uv = self._f02uv(f0) + uv = F.interpolate(uv.transpose(2, 1), scale_factor=upp, mode='nearest').transpose(2, 1) + noise_amp = uv * self.noise_std + (1 - uv) * self.sine_amp / 3 + noise = noise_amp * torch.randn_like(sine_waves) + sine_waves = sine_waves * uv + noise + return sine_waves, uv, noise + + +class SourceModuleHnNSF(torch.nn.Module): + """ SourceModule for hn-nsf + SourceModule(sampling_rate, harmonic_num=0, sine_amp=0.1, + add_noise_std=0.003, voiced_threshod=0) + sampling_rate: sampling_rate in Hz + harmonic_num: number of harmonic above F0 (default: 0) + sine_amp: amplitude of sine source signal (default: 0.1) + add_noise_std: std of additive Gaussian noise (default: 0.003) + note that amplitude of noise in unvoiced is decided + by sine_amp + voiced_threshold: threhold to set U/V given F0 (default: 0) + Sine_source, noise_source = SourceModuleHnNSF(F0_sampled) + F0_sampled (batchsize, length, 1) + Sine_source (batchsize, length, 1) + noise_source (batchsize, length 1) + uv (batchsize, length, 1) + """ + + def __init__(self, sampling_rate, harmonic_num=0, sine_amp=0.1, + add_noise_std=0.003, voiced_threshod=0): + super(SourceModuleHnNSF, self).__init__() + + self.sine_amp = sine_amp + self.noise_std = add_noise_std + + # to produce sine waveforms + self.l_sin_gen = SineGen(sampling_rate, harmonic_num, + sine_amp, add_noise_std, voiced_threshod) + + # to merge source harmonics into a single excitation + self.l_linear = torch.nn.Linear(harmonic_num + 1, 1) + self.l_tanh = torch.nn.Tanh() + + def forward(self, x, upp): + sine_wavs, uv, _ = self.l_sin_gen(x, upp) + sine_merge = self.l_tanh(self.l_linear(sine_wavs)) + return sine_merge + + +class Generator(torch.nn.Module): + def __init__(self, h): + super(Generator, self).__init__() + self.h = h + self.num_kernels = len(h.resblock_kernel_sizes) + self.num_upsamples = len(h.upsample_rates) + self.m_source = SourceModuleHnNSF( + sampling_rate=h.sampling_rate, + harmonic_num=8 + ) + self.noise_convs = nn.ModuleList() + self.conv_pre = weight_norm(Conv1d(h.num_mels, h.upsample_initial_channel, 7, 1, padding=3)) + resblock = ResBlock1 if h.resblock == '1' else ResBlock2 + + self.ups = nn.ModuleList() + for i, (u, k) in enumerate(zip(h.upsample_rates, h.upsample_kernel_sizes)): + c_cur = h.upsample_initial_channel // (2 ** (i + 1)) + self.ups.append(weight_norm( + ConvTranspose1d(h.upsample_initial_channel // (2 ** i), h.upsample_initial_channel // (2 ** (i + 1)), + k, u, padding=(k - u) // 2))) + if i + 1 < len(h.upsample_rates): # + stride_f0 = int(np.prod(h.upsample_rates[i + 1:])) + self.noise_convs.append(Conv1d( + 1, c_cur, kernel_size=stride_f0 * 2, stride=stride_f0, padding=stride_f0 // 2)) + else: + self.noise_convs.append(Conv1d(1, c_cur, kernel_size=1)) + self.resblocks = nn.ModuleList() + ch = h.upsample_initial_channel + for i in range(len(self.ups)): + ch //= 2 + for j, (k, d) in enumerate(zip(h.resblock_kernel_sizes, h.resblock_dilation_sizes)): + self.resblocks.append(resblock(h, ch, k, d)) + + self.conv_post = weight_norm(Conv1d(ch, 1, 7, 1, padding=3)) + self.ups.apply(init_weights) + self.conv_post.apply(init_weights) + self.upp = int(np.prod(h.upsample_rates)) + + def forward(self, x, f0): + har_source = self.m_source(f0, self.upp).transpose(1, 2) + x = self.conv_pre(x) + for i in range(self.num_upsamples): + x = F.leaky_relu(x, LRELU_SLOPE) + x = self.ups[i](x) + x_source = self.noise_convs[i](har_source) + x = x + x_source + xs = None + for j in range(self.num_kernels): + if xs is None: + xs = self.resblocks[i * self.num_kernels + j](x) + else: + xs += self.resblocks[i * self.num_kernels + j](x) + x = xs / self.num_kernels + x = F.leaky_relu(x) + x = self.conv_post(x) + x = torch.tanh(x) + + return x + + def remove_weight_norm(self): + print('Removing weight norm...') + for l in self.ups: + remove_weight_norm(l) + for l in self.resblocks: + l.remove_weight_norm() + remove_weight_norm(self.conv_pre) + remove_weight_norm(self.conv_post) + + +class DiscriminatorP(torch.nn.Module): + def __init__(self, period, kernel_size=5, stride=3, use_spectral_norm=False): + super(DiscriminatorP, self).__init__() + self.period = period + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv2d(1, 32, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(32, 128, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(128, 512, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(512, 1024, (kernel_size, 1), (stride, 1), padding=(get_padding(5, 1), 0))), + norm_f(Conv2d(1024, 1024, (kernel_size, 1), 1, padding=(2, 0))), + ]) + self.conv_post = norm_f(Conv2d(1024, 1, (3, 1), 1, padding=(1, 0))) + + def forward(self, x): + fmap = [] + + # 1d to 2d + b, c, t = x.shape + if t % self.period != 0: # pad first + n_pad = self.period - (t % self.period) + x = F.pad(x, (0, n_pad), "reflect") + t = t + n_pad + x = x.view(b, c, t // self.period, self.period) + + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class MultiPeriodDiscriminator(torch.nn.Module): + def __init__(self, periods=None): + super(MultiPeriodDiscriminator, self).__init__() + self.periods = periods if periods is not None else [2, 3, 5, 7, 11] + self.discriminators = nn.ModuleList() + for period in self.periods: + self.discriminators.append(DiscriminatorP(period)) + + def forward(self, y, y_hat): + y_d_rs = [] + y_d_gs = [] + fmap_rs = [] + fmap_gs = [] + for i, d in enumerate(self.discriminators): + y_d_r, fmap_r = d(y) + y_d_g, fmap_g = d(y_hat) + y_d_rs.append(y_d_r) + fmap_rs.append(fmap_r) + y_d_gs.append(y_d_g) + fmap_gs.append(fmap_g) + + return y_d_rs, y_d_gs, fmap_rs, fmap_gs + + +class DiscriminatorS(torch.nn.Module): + def __init__(self, use_spectral_norm=False): + super(DiscriminatorS, self).__init__() + norm_f = weight_norm if use_spectral_norm == False else spectral_norm + self.convs = nn.ModuleList([ + norm_f(Conv1d(1, 128, 15, 1, padding=7)), + norm_f(Conv1d(128, 128, 41, 2, groups=4, padding=20)), + norm_f(Conv1d(128, 256, 41, 2, groups=16, padding=20)), + norm_f(Conv1d(256, 512, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(512, 1024, 41, 4, groups=16, padding=20)), + norm_f(Conv1d(1024, 1024, 41, 1, groups=16, padding=20)), + norm_f(Conv1d(1024, 1024, 5, 1, padding=2)), + ]) + self.conv_post = norm_f(Conv1d(1024, 1, 3, 1, padding=1)) + + def forward(self, x): + fmap = [] + for l in self.convs: + x = l(x) + x = F.leaky_relu(x, LRELU_SLOPE) + fmap.append(x) + x = self.conv_post(x) + fmap.append(x) + x = torch.flatten(x, 1, -1) + + return x, fmap + + +class MultiScaleDiscriminator(torch.nn.Module): + def __init__(self): + super(MultiScaleDiscriminator, self).__init__() + self.discriminators = nn.ModuleList([ + DiscriminatorS(use_spectral_norm=True), + DiscriminatorS(), + DiscriminatorS(), + ]) + self.meanpools = nn.ModuleList([ + AvgPool1d(4, 2, padding=2), + AvgPool1d(4, 2, padding=2) + ]) + + def forward(self, y, y_hat): + y_d_rs = [] + y_d_gs = [] + fmap_rs = [] + fmap_gs = [] + for i, d in enumerate(self.discriminators): + if i != 0: + y = self.meanpools[i - 1](y) + y_hat = self.meanpools[i - 1](y_hat) + y_d_r, fmap_r = d(y) + y_d_g, fmap_g = d(y_hat) + y_d_rs.append(y_d_r) + fmap_rs.append(fmap_r) + y_d_gs.append(y_d_g) + fmap_gs.append(fmap_g) + + return y_d_rs, y_d_gs, fmap_rs, fmap_gs + + +def feature_loss(fmap_r, fmap_g): + loss = 0 + for dr, dg in zip(fmap_r, fmap_g): + for rl, gl in zip(dr, dg): + loss += torch.mean(torch.abs(rl - gl)) + + return loss * 2 + + +def discriminator_loss(disc_real_outputs, disc_generated_outputs): + loss = 0 + r_losses = [] + g_losses = [] + for dr, dg in zip(disc_real_outputs, disc_generated_outputs): + r_loss = torch.mean((1 - dr) ** 2) + g_loss = torch.mean(dg ** 2) + loss += (r_loss + g_loss) + r_losses.append(r_loss.item()) + g_losses.append(g_loss.item()) + + return loss, r_losses, g_losses + + +def generator_loss(disc_outputs): + loss = 0 + gen_losses = [] + for dg in disc_outputs: + l = torch.mean((1 - dg) ** 2) + gen_losses.append(l) + loss += l + + return loss, gen_losses diff --git a/vdecoder/nsf_hifigan/nvSTFT.py b/vdecoder/nsf_hifigan/nvSTFT.py new file mode 100644 index 0000000000000000000000000000000000000000..62bd5a008f81929054f036c81955d5d73377f772 --- /dev/null +++ b/vdecoder/nsf_hifigan/nvSTFT.py @@ -0,0 +1,134 @@ +import math +import os +os.environ["LRU_CACHE_CAPACITY"] = "3" +import random +import torch +import torch.utils.data +import numpy as np +import librosa +from librosa.util import normalize +from librosa.filters import mel as librosa_mel_fn +from scipy.io.wavfile import read +import soundfile as sf +import torch.nn.functional as F + +def load_wav_to_torch(full_path, target_sr=None, return_empty_on_exception=False): + sampling_rate = None + try: + data, sampling_rate = sf.read(full_path, always_2d=True)# than soundfile. + except Exception as ex: + print(f"'{full_path}' failed to load.\nException:") + print(ex) + if return_empty_on_exception: + return [], sampling_rate or target_sr or 48000 + else: + raise Exception(ex) + + if len(data.shape) > 1: + data = data[:, 0] + assert len(data) > 2# check duration of audio file is > 2 samples (because otherwise the slice operation was on the wrong dimension) + + if np.issubdtype(data.dtype, np.integer): # if audio data is type int + max_mag = -np.iinfo(data.dtype).min # maximum magnitude = min possible value of intXX + else: # if audio data is type fp32 + max_mag = max(np.amax(data), -np.amin(data)) + max_mag = (2**31)+1 if max_mag > (2**15) else ((2**15)+1 if max_mag > 1.01 else 1.0) # data should be either 16-bit INT, 32-bit INT or [-1 to 1] float32 + + data = torch.FloatTensor(data.astype(np.float32))/max_mag + + if (torch.isinf(data) | torch.isnan(data)).any() and return_empty_on_exception:# resample will crash with inf/NaN inputs. return_empty_on_exception will return empty arr instead of except + return [], sampling_rate or target_sr or 48000 + if target_sr is not None and sampling_rate != target_sr: + data = torch.from_numpy(librosa.core.resample(data.numpy(), orig_sr=sampling_rate, target_sr=target_sr)) + sampling_rate = target_sr + + return data, sampling_rate + +def dynamic_range_compression(x, C=1, clip_val=1e-5): + return np.log(np.clip(x, a_min=clip_val, a_max=None) * C) + +def dynamic_range_decompression(x, C=1): + return np.exp(x) / C + +def dynamic_range_compression_torch(x, C=1, clip_val=1e-5): + return torch.log(torch.clamp(x, min=clip_val) * C) + +def dynamic_range_decompression_torch(x, C=1): + return torch.exp(x) / C + +class STFT(): + def __init__(self, sr=22050, n_mels=80, n_fft=1024, win_size=1024, hop_length=256, fmin=20, fmax=11025, clip_val=1e-5): + self.target_sr = sr + + self.n_mels = n_mels + self.n_fft = n_fft + self.win_size = win_size + self.hop_length = hop_length + self.fmin = fmin + self.fmax = fmax + self.clip_val = clip_val + self.mel_basis = {} + self.hann_window = {} + + def get_mel(self, y, keyshift=0, speed=1, center=False): + sampling_rate = self.target_sr + n_mels = self.n_mels + n_fft = self.n_fft + win_size = self.win_size + hop_length = self.hop_length + fmin = self.fmin + fmax = self.fmax + clip_val = self.clip_val + + factor = 2 ** (keyshift / 12) + n_fft_new = int(np.round(n_fft * factor)) + win_size_new = int(np.round(win_size * factor)) + hop_length_new = int(np.round(hop_length * speed)) + + if torch.min(y) < -1.: + print('min value is ', torch.min(y)) + if torch.max(y) > 1.: + print('max value is ', torch.max(y)) + + mel_basis_key = str(fmax)+'_'+str(y.device) + if mel_basis_key not in self.mel_basis: + mel = librosa_mel_fn(sr=sampling_rate, n_fft=n_fft, n_mels=n_mels, fmin=fmin, fmax=fmax) + self.mel_basis[mel_basis_key] = torch.from_numpy(mel).float().to(y.device) + + keyshift_key = str(keyshift)+'_'+str(y.device) + if keyshift_key not in self.hann_window: + self.hann_window[keyshift_key] = torch.hann_window(win_size_new).to(y.device) + + pad_left = (win_size_new - hop_length_new) //2 + pad_right = max((win_size_new- hop_length_new + 1) //2, win_size_new - y.size(-1) - pad_left) + if pad_right < y.size(-1): + mode = 'reflect' + else: + mode = 'constant' + y = torch.nn.functional.pad(y.unsqueeze(1), (pad_left, pad_right), mode = mode) + y = y.squeeze(1) + + spec = torch.stft(y, n_fft_new, hop_length=hop_length_new, win_length=win_size_new, window=self.hann_window[keyshift_key], + center=center, pad_mode='reflect', normalized=False, onesided=True, return_complex=False) + # print(111,spec) + spec = torch.sqrt(spec.pow(2).sum(-1)+(1e-9)) + if keyshift != 0: + size = n_fft // 2 + 1 + resize = spec.size(1) + if resize < size: + spec = F.pad(spec, (0, 0, 0, size-resize)) + spec = spec[:, :size, :] * win_size / win_size_new + + # print(222,spec) + spec = torch.matmul(self.mel_basis[mel_basis_key], spec) + # print(333,spec) + spec = dynamic_range_compression_torch(spec, clip_val=clip_val) + # print(444,spec) + return spec + + def __call__(self, audiopath): + audio, sr = load_wav_to_torch(audiopath, target_sr=self.target_sr) + spect = self.get_mel(audio.unsqueeze(0)).squeeze(0) + return spect + +stft = STFT() diff --git a/vdecoder/nsf_hifigan/utils.py b/vdecoder/nsf_hifigan/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..84bff024f4d2e2de194b2a88ee7bbe5f0d33f67c --- /dev/null +++ b/vdecoder/nsf_hifigan/utils.py @@ -0,0 +1,68 @@ +import glob +import os +import matplotlib +import torch +from torch.nn.utils import weight_norm +matplotlib.use("Agg") +import matplotlib.pylab as plt + + +def plot_spectrogram(spectrogram): + fig, ax = plt.subplots(figsize=(10, 2)) + im = ax.imshow(spectrogram, aspect="auto", origin="lower", + interpolation='none') + plt.colorbar(im, ax=ax) + + fig.canvas.draw() + plt.close() + + return fig + + +def init_weights(m, mean=0.0, std=0.01): + classname = m.__class__.__name__ + if classname.find("Conv") != -1: + m.weight.data.normal_(mean, std) + + +def apply_weight_norm(m): + classname = m.__class__.__name__ + if classname.find("Conv") != -1: + weight_norm(m) + + +def get_padding(kernel_size, dilation=1): + return int((kernel_size*dilation - dilation)/2) + + +def load_checkpoint(filepath, device): + assert os.path.isfile(filepath) + print("Loading '{}'".format(filepath)) + checkpoint_dict = torch.load(filepath, map_location=device) + print("Complete.") + return checkpoint_dict + + +def save_checkpoint(filepath, obj): + print("Saving checkpoint to {}".format(filepath)) + torch.save(obj, filepath) + print("Complete.") + + +def del_old_checkpoints(cp_dir, prefix, n_models=2): + pattern = os.path.join(cp_dir, prefix + '????????') + cp_list = glob.glob(pattern) # get checkpoint paths + cp_list = sorted(cp_list)# sort by iter + if len(cp_list) > n_models: # if more than n_models models are found + for cp in cp_list[:-n_models]:# delete the oldest models other than lastest n_models + open(cp, 'w').close()# empty file contents + os.unlink(cp)# delete file (move to trash when using Colab) + + +def scan_checkpoint(cp_dir, prefix): + pattern = os.path.join(cp_dir, prefix + '????????') + cp_list = glob.glob(pattern) + if len(cp_list) == 0: + return None + return sorted(cp_list)[-1] + diff --git a/wav_upload.py b/wav_upload.py new file mode 100644 index 0000000000000000000000000000000000000000..1a347fa9359edc21dcd9fe633579bc657c0a3fd4 --- /dev/null +++ b/wav_upload.py @@ -0,0 +1,21 @@ +from google.colab import files +import shutil +import os +import argparse +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("--type", type=str, required=True, help="type of file to upload") + args = parser.parse_args() + file_type = args.type + + basepath = os.getcwd() + uploaded = files.upload() + assert(file_type in ['zip', 'audio']) + if file_type == "zip": + upload_path = "./upload/" + for filename in uploaded.keys(): + shutil.move(os.path.join(basepath, filename), os.path.join(upload_path, "userzip.zip")) + elif file_type == "audio": + upload_path = "./raw/" + for filename in uploaded.keys(): + shutil.move(os.path.join(basepath, filename), os.path.join(upload_path, filename)) \ No newline at end of file diff --git a/webUI.py b/webUI.py new file mode 100644 index 0000000000000000000000000000000000000000..499ff0ba3fd8678a01f9c26f9466a513d0b756b3 --- /dev/null +++ b/webUI.py @@ -0,0 +1,311 @@ +import io +import os + +# os.system("wget -P cvec/ https://huggingface.co/spaces/innnky/nanami/resolve/main/checkpoint_best_legacy_500.pt") +import gradio as gr +import gradio.processing_utils as gr_pu +import librosa +import numpy as np +import soundfile +from inference.infer_tool import Svc +import logging +import re +import json + +import subprocess +import edge_tts +import asyncio +from scipy.io import wavfile +import librosa +import torch +import time +import traceback +from itertools import chain +from utils import mix_model + +logging.getLogger('numba').setLevel(logging.WARNING) +logging.getLogger('markdown_it').setLevel(logging.WARNING) +logging.getLogger('urllib3').setLevel(logging.WARNING) +logging.getLogger('matplotlib').setLevel(logging.WARNING) +logging.getLogger('multipart').setLevel(logging.WARNING) + +model = None +spk = None +debug = False + +cuda = {} +if torch.cuda.is_available(): + for i in range(torch.cuda.device_count()): + device_name = torch.cuda.get_device_properties(i).name + cuda[f"CUDA:{i} {device_name}"] = f"cuda:{i}" + +def upload_mix_append_file(files,sfiles): + try: + if(sfiles == None): + file_paths = [file.name for file in files] + else: + file_paths = [file.name for file in chain(files,sfiles)] + p = {file:100 for file in file_paths} + return file_paths,mix_model_output1.update(value=json.dumps(p,indent=2)) + except Exception as e: + if debug: traceback.print_exc() + raise gr.Error(e) + +def mix_submit_click(js,mode): + try: + assert js.lstrip()!="" + modes = {"凸组合":0, "线性组合":1} + mode = modes[mode] + data = json.loads(js) + data = list(data.items()) + model_path,mix_rate = zip(*data) + path = mix_model(model_path,mix_rate,mode) + return f"成功,文件被保存在了{path}" + except Exception as e: + if debug: traceback.print_exc() + raise gr.Error(e) + +def updata_mix_info(files): + try: + if files == None : return mix_model_output1.update(value="") + p = {file.name:100 for file in files} + return mix_model_output1.update(value=json.dumps(p,indent=2)) + except Exception as e: + if debug: traceback.print_exc() + raise gr.Error(e) + +def modelAnalysis(model_path,config_path,cluster_model_path,device,enhance): + global model + try: + device = cuda[device] if "CUDA" in device else device + model = Svc(model_path.name, config_path.name, device=device if device!="Auto" else None, cluster_model_path = cluster_model_path.name if cluster_model_path != None else "",nsf_hifigan_enhance=enhance) + spks = list(model.spk2id.keys()) + device_name = torch.cuda.get_device_properties(model.dev).name if "cuda" in str(model.dev) else str(model.dev) + msg = f"成功加载模型到设备{device_name}上\n" + if cluster_model_path is None: + msg += "未加载聚类模型\n" + else: + msg += f"聚类模型{cluster_model_path.name}加载成功\n" + msg += "当前模型的可用音色:\n" + for i in spks: + msg += i + " " + return sid.update(choices = spks,value=spks[0]), msg + except Exception as e: + if debug: traceback.print_exc() + raise gr.Error(e) + + +def modelUnload(): + global model + if model is None: + return sid.update(choices = [],value=""),"没有模型需要卸载!" + else: + model.unload_model() + model = None + torch.cuda.empty_cache() + return sid.update(choices = [],value=""),"模型卸载完毕!" + + +def vc_fn(sid, input_audio, vc_transform, auto_f0,cluster_ratio, slice_db, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,F0_mean_pooling,enhancer_adaptive_key,cr_threshold): + global model + try: + if input_audio is None: + raise gr.Error("你需要上传音频") + if model is None: + raise gr.Error("你需要指定模型") + sampling_rate, audio = input_audio + # print(audio.shape,sampling_rate) + audio = (audio / np.iinfo(audio.dtype).max).astype(np.float32) + if len(audio.shape) > 1: + audio = librosa.to_mono(audio.transpose(1, 0)) + temp_path = "temp.wav" + soundfile.write(temp_path, audio, sampling_rate, format="wav") + _audio = model.slice_inference(temp_path, sid, vc_transform, slice_db, cluster_ratio, auto_f0, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,F0_mean_pooling,enhancer_adaptive_key,cr_threshold) + model.clear_empty() + os.remove(temp_path) + #构建保存文件的路径,并保存到results文件夹内 + try: + timestamp = str(int(time.time())) + filename = sid + "_" + timestamp + ".wav" + output_file = os.path.join("./results", filename) + soundfile.write(output_file, _audio, model.target_sample, format="wav") + return f"推理成功,音频文件保存为results/{filename}", (model.target_sample, _audio) + except Exception as e: + if debug: traceback.print_exc() + return f"文件保存失败,请手动保存", (model.target_sample, _audio) + except Exception as e: + if debug: traceback.print_exc() + raise gr.Error(e) + + +def tts_func(_text,_rate,_voice): + #使用edge-tts把文字转成音频 + # voice = "zh-CN-XiaoyiNeural"#女性,较高音 + # voice = "zh-CN-YunxiNeural"#男性 + voice = "zh-CN-YunxiNeural"#男性 + if ( _voice == "女" ) : voice = "zh-CN-XiaoyiNeural" + output_file = _text[0:10]+".wav" + # communicate = edge_tts.Communicate(_text, voice) + # await communicate.save(output_file) + if _rate>=0: + ratestr="+{:.0%}".format(_rate) + elif _rate<0: + ratestr="{:.0%}".format(_rate)#减号自带 + + p=subprocess.Popen("edge-tts "+ + " --text "+_text+ + " --write-media "+output_file+ + " --voice "+voice+ + " --rate="+ratestr + ,shell=True, + stdout=subprocess.PIPE, + stdin=subprocess.PIPE) + p.wait() + return output_file + +def text_clear(text): + return re.sub(r"[\n\,\(\) ]", "", text) + +def vc_fn2(sid, input_audio, vc_transform, auto_f0,cluster_ratio, slice_db, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,text2tts,tts_rate,tts_voice,F0_mean_pooling,enhancer_adaptive_key,cr_threshold): + #使用edge-tts把文字转成音频 + text2tts=text_clear(text2tts) + output_file=tts_func(text2tts,tts_rate,tts_voice) + + #调整采样率 + sr2=44100 + wav, sr = librosa.load(output_file) + wav2 = librosa.resample(wav, orig_sr=sr, target_sr=sr2) + save_path2= text2tts[0:10]+"_44k"+".wav" + wavfile.write(save_path2,sr2, + (wav2 * np.iinfo(np.int16).max).astype(np.int16) + ) + + #读取音频 + sample_rate, data=gr_pu.audio_from_file(save_path2) + vc_input=(sample_rate, data) + + a,b=vc_fn(sid, vc_input, vc_transform,auto_f0,cluster_ratio, slice_db, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,F0_mean_pooling,enhancer_adaptive_key,cr_threshold) + os.remove(output_file) + os.remove(save_path2) + return a,b + +def debug_change(): + global debug + debug = debug_button.value + +with gr.Blocks( + theme=gr.themes.Base( + primary_hue = gr.themes.colors.green, + font=["Source Sans Pro", "Arial", "sans-serif"], + font_mono=['JetBrains mono', "Consolas", 'Courier New'] + ), +) as app: + with gr.Tabs(): + with gr.TabItem("推理"): + gr.Markdown(value=""" + So-vits-svc 4.0 推理 webui + """) + with gr.Row(variant="panel"): + with gr.Column(): + gr.Markdown(value=""" + 模型设置 + """) + model_path = gr.File(label="选择模型文件") + config_path = gr.File(label="选择配置文件") + cluster_model_path = gr.File(label="选择聚类模型文件(没有可以不选)") + device = gr.Dropdown(label="推理设备,默认为自动选择CPU和GPU", choices=["Auto",*cuda.keys(),"CPU"], value="Auto") + enhance = gr.Checkbox(label="是否使用NSF_HIFIGAN增强,该选项对部分训练集少的模型有一定的音质增强效果,但是对训练好的模型有反面效果,默认关闭", value=False) + with gr.Column(): + gr.Markdown(value=""" + 左侧文件全部选择完毕后(全部文件模块显示download),点击“加载模型”进行解析: + """) + model_load_button = gr.Button(value="加载模型", variant="primary") + model_unload_button = gr.Button(value="卸载模型", variant="primary") + sid = gr.Dropdown(label="音色(说话人)") + sid_output = gr.Textbox(label="Output Message") + + + with gr.Row(variant="panel"): + with gr.Column(): + gr.Markdown(value=""" + 推理设置 + """) + auto_f0 = gr.Checkbox(label="自动f0预测,配合聚类模型f0预测效果更好,会导致变调功能失效(仅限转换语音,歌声勾选此项会究极跑调)", value=False) + F0_mean_pooling = gr.Checkbox(label="是否对F0使用均值滤波器(池化),对部分哑音有改善。注意,启动该选项会导致推理速度下降,默认关闭", value=False) + vc_transform = gr.Number(label="变调(整数,可以正负,半音数量,升高八度就是12)", value=0) + cluster_ratio = gr.Number(label="聚类模型混合比例,0-1之间,0即不启用聚类。使用聚类模型能提升音色相似度,但会导致咬字下降(如果使用建议0.5左右)", value=0) + slice_db = gr.Number(label="切片阈值", value=-40) + noise_scale = gr.Number(label="noise_scale 建议不要动,会影响音质,玄学参数", value=0.4) + with gr.Column(): + pad_seconds = gr.Number(label="推理音频pad秒数,由于未知原因开头结尾会有异响,pad一小段静音段后就不会出现", value=0.5) + cl_num = gr.Number(label="音频自动切片,0为不切片,单位为秒(s)", value=0) + lg_num = gr.Number(label="两端音频切片的交叉淡入长度,如果自动切片后出现人声不连贯可调整该数值,如果连贯建议采用默认值0,注意,该设置会影响推理速度,单位为秒/s", value=0) + lgr_num = gr.Number(label="自动音频切片后,需要舍弃每段切片的头尾。该参数设置交叉长度保留的比例,范围0-1,左开右闭", value=0.75) + enhancer_adaptive_key = gr.Number(label="使增强器适应更高的音域(单位为半音数)|默认为0", value=0) + cr_threshold = gr.Number(label="F0过滤阈值,只有启动f0_mean_pooling时有效. 数值范围从0-1. 降低该值可减少跑调概率,但会增加哑音", value=0.05) + with gr.Tabs(): + with gr.TabItem("音频转音频"): + vc_input3 = gr.Audio(label="选择音频") + vc_submit = gr.Button("音频转换", variant="primary") + with gr.TabItem("文字转音频"): + text2tts=gr.Textbox(label="在此输入要转译的文字。注意,使用该功能建议打开F0预测,不然会很怪") + tts_rate = gr.Number(label="tts语速", value=0) + tts_voice = gr.Radio(label="性别",choices=["男","女"], value="男") + vc_submit2 = gr.Button("文字转换", variant="primary") + with gr.Row(): + with gr.Column(): + vc_output1 = gr.Textbox(label="Output Message") + with gr.Column(): + vc_output2 = gr.Audio(label="Output Audio", interactive=False) + + with gr.TabItem("小工具/实验室特性"): + gr.Markdown(value=""" + So-vits-svc 4.0 小工具/实验室特性 + """) + with gr.Tabs(): + with gr.TabItem("静态声线融合"): + gr.Markdown(value=""" + 介绍:该功能可以将多个声音模型合成为一个声音模型(多个模型参数的凸组合或线性组合),从而制造出现实中不存在的声线 + 注意: + 1.该功能仅支持单说话人的模型 + 2.如果强行使用多说话人模型,需要保证多个模型的说话人数量相同,这样可以混合同一个SpaekerID下的声音 + 3.保证所有待混合模型的config.json中的model字段是相同的 + 4.输出的混合模型可以使用待合成模型的任意一个config.json,但聚类模型将不能使用 + 5.批量上传模型的时候最好把模型放到一个文件夹选中后一起上传 + 6.混合比例调整建议大小在0-100之间,也可以调为其他数字,但在线性组合模式下会出现未知的效果 + 7.混合完毕后,文件将会保存在项目根目录中,文件名为output.pth + 8.凸组合模式会将混合比例执行Softmax使混合比例相加为1,而线性组合模式不会 + + """) + mix_model_path = gr.Files(label="选择需要混合模型文件") + mix_model_upload_button = gr.UploadButton("选择/追加需要混合模型文件", file_count="multiple", variant="primary") + mix_model_output1 = gr.Textbox( + label="混合比例调整,单位/%", + interactive = True + ) + mix_mode = gr.Radio(choices=["凸组合", "线性组合"], label="融合模式",value="凸组合",interactive = True) + mix_submit = gr.Button("声线融合启动", variant="primary") + mix_model_output2 = gr.Textbox( + label="Output Message" + ) + mix_model_path.change(updata_mix_info,[mix_model_path],[mix_model_output1]) + mix_model_upload_button.upload(upload_mix_append_file, [mix_model_upload_button,mix_model_path], [mix_model_path,mix_model_output1]) + mix_submit.click(mix_submit_click, [mix_model_output1,mix_mode], [mix_model_output2]) + + + with gr.Tabs(): + with gr.Row(variant="panel"): + with gr.Column(): + gr.Markdown(value=""" + WebUI设置 + """) + debug_button = gr.Checkbox(label="Debug模式,如果向社区反馈BUG需要打开,打开后控制台可以显示具体错误提示", value=debug) + vc_submit.click(vc_fn, [sid, vc_input3, vc_transform,auto_f0,cluster_ratio, slice_db, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,F0_mean_pooling,enhancer_adaptive_key,cr_threshold], [vc_output1, vc_output2]) + vc_submit2.click(vc_fn2, [sid, vc_input3, vc_transform,auto_f0,cluster_ratio, slice_db, noise_scale,pad_seconds,cl_num,lg_num,lgr_num,text2tts,tts_rate,tts_voice,F0_mean_pooling,enhancer_adaptive_key,cr_threshold], [vc_output1, vc_output2]) + debug_button.change(debug_change,[],[]) + model_load_button.click(modelAnalysis,[model_path,config_path,cluster_model_path,device,enhance],[sid,sid_output]) + model_unload_button.click(modelUnload,[],[sid,sid_output]) + app.launch() + + + \ No newline at end of file