# /// script # requires-python = ">=3.10" # dependencies = [ # "tqdm", # "psutil", # "vapoursynth", # ] # /// #Originally by Trix #Contributors: R1chterScale, Yiss, Kosaka & others from AV1 Weeb edition from math import ceil, floor from pathlib import Path import json import os import subprocess import re import argparse import shutil import platform from tqdm import tqdm import psutil import vapoursynth as vs core = vs.core core.max_cache_size = 1024 IS_WINDOWS = platform.system() == 'Windows' NULL_DEVICE = 'NUL' if IS_WINDOWS else '/dev/null' if shutil.which("av1an") is None: raise FileNotFoundError("av1an not found, exiting") if shutil.which("turbo-metrics") is None: print("turbo-metrics not found, defaulting to vs-zip") ssimu2cpu = True default_skip = 3 else: ssimu2cpu = False default_skip = 1 def get_ranges(scenes: str) -> list[int]: """ Reads a scene file and returns a list of frame numbers for each scene change. :param scenes: path to scene file :type scenes: str :return: list of frame numbers :rtype: list[int] """ ranges = [0] with scenes.open("r") as file: content = json.load(file) for scene in content['scenes']: ranges.append(scene['end_frame']) return ranges parser = argparse.ArgumentParser() parser.add_argument("-s", "--stage", help = "Select stage: 1 = encode, 2 = calculate metrics, 3 = generate zones | Default: all", default=0) parser.add_argument("-i", "--input", required=True, help = "Video input filepath (original source file)") parser.add_argument("-t", "--temp", help = "The temporary directory for av1an to store files in | Default: video input filename") parser.add_argument("-q", "--quality", help = "Base quality (CRF) | Default: 30", default=30) parser.add_argument("-d", "--deviation", help = "Base deviation limit for CRF changes (used if max_positive_dev or max_negative_dev not set) | Default: 10", default=10) parser.add_argument("--max-positive-dev", help = "Maximum allowed positive CRF deviation | Default: None", type=float, default=None) parser.add_argument("--max-negative-dev", help = "Maximum allowed negative CRF deviation | Default: None", type=float, default=None) parser.add_argument("-p", "--preset", help = "Fast encode preset | Default: 8", default=8) parser.add_argument("-w", "--workers", help = "Number of av1an workers | Default: amount of physical cores", default=psutil.cpu_count(logical=False)) parser.add_argument("-S", "--skip", help = "SSIMU2 skip value, every nth frame's SSIMU2 is calculated | Default: 1 for turbo-metrics, 3 for vs-zip") parser.add_argument("-m", "--method", help = "Zones calculation method: 1 = SSIMU2, 2 = XPSNR, 3 = Multiplication, 4 = Lowest Result | Default: 1", default=1) parser.add_argument("-a", "--aggressive", action='store_true', help = "More aggressive boosting | Default: not active") parser.add_argument("-gpu", "--vship", action='store_true', help = "Leverage Vship (GPU) instead of vs-zip (CPU) | Default: not active") parser.add_argument("-v","--video_params", help="Custom encoder parameters for av1an") args = parser.parse_args() ranges = [] src_file = Path(args.input).resolve() output_dir = src_file.parent tmp_dir = Path(args.temp).resolve() if args.temp is not None else output_dir / src_file.stem output_file = tmp_dir / f"{src_file.stem}_fastpass.mkv" scenes_file = tmp_dir / "scenes.json" # Computation Parameters stage = int(args.stage) method = int(args.method) base_deviation = float(args.deviation) max_pos_dev = args.max_positive_dev max_neg_dev = args.max_negative_dev aggressive = args.aggressive skip = int(args.skip) if args.skip is not None else default_skip vship = args.vship # Encoding Parameters crf = float(args.quality) preset = args.preset workers = args.workers video_params = args.video_params def fast_pass( input_file: str, output_file: str, tmp_dir: str, preset: int, crf: float, workers: int,video_params: str ): """ Quick fast-pass using Av1an :param input_file: path to input file :type input_file: str :param output_file: path to output file :type output_file: str :param tmp_dir: path to temporary directory :type tmp_dir: str :param preset: encoder preset :type preset: int :param crf: target CRF :type crf: float :param workers: number of workers :type workers: int :param video_params: custom encoder params for av1an :type video_prams: str """ encoder_params = f'--preset {preset} --crf {crf:.2f} --lp 2 --keyint 0 --scm 0 --fast-decode 1 --color-primaries 1 --transfer-characteristics 1 --matrix-coefficients 1' if video_params: # Only append video_params if it exists and is not None encoder_params += f' {video_params}' fast_av1an_command = [ 'av1an', '-i', input_file, '--temp', tmp_dir, '-y', '--verbose', '--keep', '-m', 'lsmash', '-c', 'mkvmerge', '--min-scene-len', '24', '--scenes', scenes_file, '--sc-downscale-height', '720', '--set-thread-affinity', '2', '-e', 'svt-av1', '--force', '-v', encoder_params, '-w', str(workers), '-o', output_file ] try: subprocess.run(fast_av1an_command, text=True, check=True) except subprocess.CalledProcessError as e: print(f"Av1an encountered an error:\n{e}") exit(1) def turbo_metrics( source: str, distorted: str, every: int ) -> subprocess.CompletedProcess: """ Compare two files with SSIMULACRA2 using turbo-metrics. :param source: path to source file :type source: str :param distorted: path to distorted file :type distorted: str :param every: compare every X frames :type every: int :return: completed process :rtype: subprocess.CompletedProcess """ turbo_cmd = [ "turbo-metrics", "-m", "ssimulacra2", "--output", "csv", ] if every > 1: turbo_cmd.append("--every") turbo_cmd.append(str(every)) turbo_cmd.append(source) turbo_cmd.append(distorted) return subprocess.run( turbo_cmd, capture_output=True, text=True, ) def calculate_ssimu2(src_file, enc_file, ssimu2_txt_path, ranges, skip): if not ssimu2cpu: # Try turbo-metrics first if ssimu2cpu is False turbo_metrics_run = turbo_metrics(src_file, enc_file, skip) if turbo_metrics_run.returncode == 0: # If turbo-metrics succeeds with ssimu2_txt_path.open("w") as file: file.write(f"skip: {skip}\n") frame = 0 # for whatever reason, turbo-metrics in csv mode dumps the entire scores to stdout at the end even though it prints them live to stdout. # so we need to see if we've seen ``ssimulacra2`` before and if we have, ignore anything after the second one. ignore_end_barf = False for line in turbo_metrics_run.stdout.splitlines(): # set ignore_end_barf to true as this is the first "ssimulacra2" line if line == "ssimulacra2" and not ignore_end_barf: ignore_end_barf = True # break the loop as we've encountered the second "ssimulacra2" line so we don't get a dupe of the scores. elif line == "ssimulacra2" and ignore_end_barf: break # assume everything not "ssimulacra2" is a score. if line != "ssimulacra2": frame += 1 with ssimu2_txt_path.open("a") as file: file.write(f"{frame}: {float(line)}\n") return # Exit if turbo-metrics succeeded else: print(f"Turbo Metrics exited with code: {turbo_metrics_run.returncode}") print(turbo_metrics_run.stdout) print(turbo_metrics_run.stderr) print("Falling back to vs-zip") skip = skip if skip is not None else 3 # If ssimu2cpu is True or turbo-metrics failed, use vs-zip is_vpy = os.path.splitext(os.path.basename(src_file))[1] == ".vpy" vpy_vars = {} if is_vpy: exec(open(src_file).read(), globals(), vpy_vars) # in order for auto-boost to use a .vpy file as a source, the output clip should be a global variable named clip source_clip = core.lsmas.LWLibavSource(source=src_file, cache=0) if not is_vpy else vpy_vars["clip"] encoded_clip = core.lsmas.LWLibavSource(source=enc_file, cache=0) #source_clip = source_clip.resize.Bicubic(format=vs.RGBS, matrix_in_s='709').fmtc.transfer(transs="srgb", transd="linear", bits=32) #encoded_clip = encoded_clip.resize.Bicubic(format=vs.RGBS, matrix_in_s='709').fmtc.transfer(transs="srgb", transd="linear", bits=32) print(f"source: {len(source_clip)} frames") print(f"encode: {len(encoded_clip)} frames") with ssimu2_txt_path.open("w") as file: file.write(f"skip: {skip}\n") iter = 0 # smoothing : 0.0 -> 1.0 (Average -> Realtime) (Default: 0.3) with tqdm(total=floor(len(source_clip)), desc=f'Calculating SSIMULACRA 2 scores', unit=" frames", smoothing=0) as pbar: #for i in range(len(ranges) - 1): if skip > 1: cut_source_clip = source_clip.std.SelectEvery(cycle=skip, offsets=1) cut_encoded_clip = encoded_clip.std.SelectEvery(cycle=skip, offsets=1) else: cut_source_clip = source_clip #[ranges[i]:ranges[i+1]] cut_encoded_clip = encoded_clip #[ranges[i]:ranges[i+1]] if not vship: result = core.vszip.Metrics(cut_source_clip, cut_encoded_clip, mode=0) else: result = core.vship.SSIMULACRA2(cut_source_clip, cut_encoded_clip) for index, frame in enumerate(result.frames()): iter += 1 score = frame.props['_SSIMULACRA2'] with ssimu2_txt_path.open("a") as file: file.write(f"{iter}: {score}\n") pbar.update(skip) def calculate_xpsnr(src_file, enc_file, xpsnr_txt_path) -> None: if IS_WINDOWS: xpsnr_tmp_txt_path = Path(f"{src_file.stem}_xpsnr.log") src_file_dir = src_file.parent os.chdir(src_file_dir) else: xpsnr_tmp_txt_path = xpsnr_txt_path xpsnr_command = [ 'ffmpeg', '-i', src_file, '-i', enc_file, '-lavfi', f'xpsnr=stats_file={str(xpsnr_tmp_txt_path)}', '-f', 'null', NULL_DEVICE ] source_clip = core.lsmas.LWLibavSource(source=src_file, cache=0) encoded_clip = core.lsmas.LWLibavSource(source=enc_file, cache=0) print(f'source: {len(source_clip)} frames') print(f'encode: {len(encoded_clip)} frames') # smoothing : 0.0 -> 1.0 (Average -> Realtime) (Default: 0.3) with tqdm(total=floor(len(source_clip)), desc=f'Calculating XPSNR scores', unit=' frames', smoothing=0) as pbar: try: xpsnr_process = subprocess.Popen(xpsnr_command, stdout=subprocess.PIPE, stderr=subprocess.STDOUT,universal_newlines=True) for line in xpsnr_process.stdout: match = re.search(r'frame=\s*(\d+)', line) if match: current_frame_progress = int(match.group(1)) pbar.n = current_frame_progress pbar.refresh() except subprocess.CalledProcessError as e: print(f'XPSNR encountered an error:\n{e}') exit(-2) if IS_WINDOWS: shutil.move(xpsnr_tmp_txt_path, xpsnr_txt_path) def get_xpsnr(xpsnr_txt_path): count=0 skip = 1 sum_weighted = 0 values_weighted: list[int] = [] with xpsnr_txt_path.open("r") as file: for line in file: match = re.search(r"XPSNR [yY]: ([0-9]+\.[0-9]+|inf) XPSNR [uU]: ([0-9]+\.[0-9]+|inf) XPSNR [vV]: ([0-9]+\.[0-9]+|inf)", line) if match: Y = float(match.group(1)) if match.group(1) != 'inf' else 100.0 U = float(match.group(2)) if match.group(2) != 'inf' else 100.0 V = float(match.group(3)) if match.group(3) != 'inf' else 100.0 W = (4 * Y + U + V) / 6 sum_weighted += W values_weighted.append(W) count += 1 else: print(line) avg_weighted = sum_weighted / count for i in range(len(values_weighted)): values_weighted[i] /= avg_weighted return values_weighted, skip def get_ssimu2(ssimu2_txt_path): ssimu2_scores: list[int] = [] with ssimu2_txt_path.open("r") as file: skipmatch = re.search(r"skip: ([0-9]+)", file.readline()) if skipmatch: skip = int(skipmatch.group(1)) else: print("Skip value not detected in SSIMU2 file, exiting.") exit(-2) for line in file: match = re.search(r"([0-9]+): ([0-9]+\.[0-9]+)", line) if match: score = float(match.group(2)) ssimu2_scores.append(score) else: print(line) return ssimu2_scores, skip def calculate_std_dev(score_list: list[int]): """ Takes a list of metrics scores and returns the associated arithmetic mean, 5th percentile and 95th percentile scores. :param score_list: list of SSIMU2 scores :type score_list: list """ filtered_score_list = [score if score >= 0 else 0.0 for score in score_list] sorted_score_list = sorted(filtered_score_list) average = sum(filtered_score_list)/len(filtered_score_list) percentile_5 = sorted_score_list[len(filtered_score_list)//20] percentile_95 = sorted_score_list[int (len(filtered_score_list)//(20/19))] return (average, percentile_5, percentile_95) def generate_zones(ranges: list, percentile_5_total: list, average: int, crf: float, zones_txt_path: str, video_params: str, max_pos_dev: float | None, max_neg_dev: float | None, base_deviation: float): """ Appends a scene change to the ``zones_txt_path`` file in Av1an zones format. creates ``zones_txt_path`` if it does not exist. If it does exist, the line is appended to the end of the file. :param ranges: Scene changes list :type ranges: list :param percentile_5_total: List containing all 5th percentile scores :type percentile_5_total: list :param average: Full clip average score :type average: int :param crf: CRF setting to use for the zone :type crf: int :param zones_txt_path: Path to the zones.txt file :type zones_txt_path: str :param video_params: custom encoder params for av1an :type video_prams: str """ zones_iter = 0 # If neither max deviation is set, use base deviation for both if max_pos_dev is None and max_neg_dev is None: max_pos_dev = base_deviation max_neg_dev = base_deviation # If only one is set, use base deviation as the other limit elif max_pos_dev is None: max_pos_dev = base_deviation elif max_neg_dev is None: max_neg_dev = base_deviation for i in range(len(ranges)-1): zones_iter += 1 # Calculate CRF adjustment using aggressive or normal multiplier multiplier = 40 if aggressive else 20 adjustment = ceil((1.0 - (percentile_5_total[i] / average)) * multiplier * 4) / 4 new_crf = crf - adjustment # Apply deviation limits if adjustment < 0: # Positive deviation (increasing CRF) if max_pos_dev == 0: new_crf = crf # Never increase CRF if max_pos_dev is 0 elif abs(adjustment) > max_pos_dev: new_crf = crf + max_pos_dev else: # Negative deviation (decreasing CRF) if max_neg_dev == 0: new_crf = crf # Never decrease CRF if max_neg_dev is 0 elif abs(adjustment) > max_neg_dev: new_crf = crf - max_neg_dev print(f'Enc: [{ranges[i]}:{ranges[i+1]}]\n' f'Chunk 5th percentile: {percentile_5_total[i]}\n' f'CRF adjustment: {adjustment:.2f}\n' f'Final CRF: {new_crf:.2f}\n') zone_params = f"--crf {new_crf:.2f} --lp 2" if video_params: # Only append video_params if it exists and is not None zone_params += f' {video_params}' with zones_txt_path.open("w" if zones_iter == 1 else "a") as file: file.write(f"{ranges[i]} {ranges[i+1]} svt-av1 {zone_params}\n") def calculate_metrics(src_file, output_file, tmp_dir, ranges, skip, method): match method: case 1: ssimu2_txt_path = tmp_dir / f"{src_file.stem}_ssimu2.log" calculate_ssimu2(src_file, output_file, ssimu2_txt_path, ranges, skip) case 2: xpsnr_txt_path = tmp_dir / f"{src_file.stem}_xpsnr.log" calculate_xpsnr(src_file, output_file, xpsnr_txt_path) case 3 | 4: xpsnr_txt_path = tmp_dir / f"{src_file.stem}_xpsnr.log" ssimu2_txt_path = tmp_dir / f"{src_file.stem}_ssimu2.log" calculate_xpsnr(src_file, output_file, xpsnr_txt_path) calculate_ssimu2(src_file, output_file, ssimu2_txt_path, ranges, skip) def calculate_zones(tmp_dir, ranges, method, cq, video_params, max_pos_dev, max_neg_dev, base_deviation): match method: case 1 | 2: if method == 1: metric = 'ssimu2' metric_txt_path = tmp_dir / f'{src_file.stem}_{metric}.log' metric_scores, skip = get_ssimu2(metric_txt_path) else: metric = 'xpsnr' metric_txt_path = tmp_dir / f'{src_file.stem}_{metric}.log' metric_scores, skip = get_xpsnr(metric_txt_path) metric_zones_txt_path = tmp_dir / f'{metric}_zones.txt' metric_total_scores = [] metric_percentile_5_total = [] metric_iter = 0 for i in range(len(ranges) - 1): metric_chunk_scores = [] metric_frames = (ranges[i + 1] - ranges[i]) // skip for frames in range(metric_frames): metric_score = metric_scores[metric_iter] metric_chunk_scores.append(metric_score) metric_total_scores.append(metric_score) metric_iter += 1 metric_average, metric_percentile_5, metric_percentile_95 = calculate_std_dev(metric_chunk_scores) metric_percentile_5_total.append(metric_percentile_5) metric_average, metric_percentile_5, metric_percentile_95 = calculate_std_dev(metric_total_scores) print(f'{metric}') print(f'Median score: {metric_average}') print(f'5th Percentile: {metric_percentile_5}') print(f'95th Percentile: {metric_percentile_95}') generate_zones(ranges, metric_percentile_5_total, metric_average, cq, metric_zones_txt_path, video_params, max_pos_dev, max_neg_dev, base_deviation) case 3 | 4: if method == 3: method = 'multiplied' else: method = 'minimum' ssimu2_txt_path = tmp_dir / f"{src_file.stem}_ssimu2.log" ssimu2_scores, skip = get_ssimu2(ssimu2_txt_path) xpsnr_txt_path = tmp_dir / f"{src_file.stem}_xpsnr.log" xpsnr_scores, _ = get_xpsnr(xpsnr_txt_path) calculation_zones_txt_path = tmp_dir / f"{method}_zones.txt" calculation_total_scores: list[int] = [] calculation_percentile_5_total = [] calculation_iter = 0 if method == 'minimum': ssimu2_average, ssimu2_percentile_5, ssimu2_percentile_95 = calculate_std_dev(ssimu2_scores) for i in range(len(ranges)-1): calculation_chunk_scores: list[int] = [] ssimu2_frames = (ranges[i + 1] - ranges[i]) // skip for frames in range(ssimu2_frames): ssimu2_score = ssimu2_scores[calculation_iter] xpsnr_index = (skip * frames) + ranges[i] + 1 xpsnr_scores_averaged = 0 for avg_index in range(skip): xpsnr_scores_averaged += xpsnr_scores[xpsnr_index + avg_index - 1] xpsnr_scores_averaged /= skip if method == 'multiplied': calculation_score = xpsnr_scores_averaged * ssimu2_score elif method == 'minimum': xpsnr_scores_averaged *= ssimu2_average calculation_score = min(ssimu2_score, xpsnr_scores_averaged) calculation_chunk_scores.append(calculation_score) calculation_total_scores.append(calculation_score) calculation_iter += 1 calculation_average, calculation_percentile_5, calculation_percentile_95 = calculate_std_dev( calculation_chunk_scores) calculation_percentile_5_total.append(calculation_percentile_5) calculation_average, calculation_percentile_5, calculation_percentile_95 = calculate_std_dev( calculation_total_scores) print(f'Minimum:') print(f'Median score: {calculation_average}') print(f'5th Percentile: {calculation_percentile_5}') print(f'95th Percentile: {calculation_percentile_95}\n') generate_zones(ranges, calculation_percentile_5_total, calculation_average, cq, calculation_zones_txt_path, video_params, max_pos_dev, max_neg_dev, base_deviation) match stage: case 0: fast_pass(src_file, output_file, tmp_dir, preset, crf, workers, video_params) ranges = get_ranges(scenes_file) calculate_metrics(src_file, output_file, tmp_dir, ranges, skip, method) calculate_zones(tmp_dir, ranges, method, crf, video_params, max_pos_dev, max_neg_dev, base_deviation) case 1: fast_pass(src_file, output_file, tmp_dir, preset, crf, workers, video_params) case 2: calculate_metrics(src_file, output_file, tmp_dir, ranges, skip, method) case 3: ranges = get_ranges(scenes_file) calculate_zones(tmp_dir, ranges, method, crf, video_params, max_pos_dev, max_neg_dev, base_deviation) case _: print(f"Stage argument invalid, exiting.") exit(-2)