# This file provides evaluation utilities for DeepThinkVLA policies. # Author: Cheng Yin # Date: 2025-09 # Copyright (c) Cheng Yin. All rights reserved. # See LICENSE file in the project root for license information. """Utils for evaluating DeepThinkVLA policies.""" import json import os import time from typing import Any, Dict, List, Optional, Tuple, Union import numpy as np import torch from PIL import Image, ImageDraw, ImageFont import textwrap from transformers import GenerationConfig from torchvision import transforms from sft.modeling_deepthinkvla import DeepThinkVLA from dt_datasets.normalize import Unnormalize_Action from sft.constants import ACTION_PROPRIO_NORMALIZATION_TYPE, ACTION_MASK, NUM_ACTIONS_CHUNK, ACTION_DIM # Initialize important constants THINK_PREFIX = "First output the thinking process in tags and then output the final action in ." DEVICE = torch.device("cuda:0") if torch.cuda.is_available() else torch.device("cpu") DEEPTHINKVLA_IMAGE_SIZE = 224 # Standard image size expected by DeepThinkVLA # Configure NumPy print settings np.set_printoptions(formatter={"float": lambda x: "{0:0.3f}".format(x)}) def binarize_gripper_action(action: np.ndarray) -> np.ndarray: # Create a copy to avoid modifying the original normalized_action = action.copy() # Binarize to -1 or +1 normalized_action[..., -1] = np.sign(normalized_action[..., -1]) return normalized_action def compose_with_sidepanel(np_img, text, panel_width_px=1024, panel_ratio=0.32, margin=16, title="CoT", max_lines=None): H, W, C = np_img.shape if panel_width_px is None: panel_w = max(120, int(W * panel_ratio)) else: panel_w = int(panel_width_px) # 创建新画布(左图 + 右侧栏) out = Image.new("RGB", (W + panel_w, H), color=(255, 255, 255)) out.paste(Image.fromarray(np_img), (0, 0)) draw = ImageDraw.Draw(out) # 字体大小随图高自适应 try: base_font = ImageFont.truetype("DejaVuSans.ttf", size=max(14, H // 42)) title_font = ImageFont.truetype("DejaVuSans.ttf", size=max(16, H // 36)) except Exception: base_font = ImageFont.load_default() title_font = ImageFont.load_default() # 侧栏绘制起点 x0 = W + margin y0 = margin text_area_w = panel_w - 2 * margin # 标题 if title: draw.text((x0, y0), title, fill=(0, 0, 0), font=title_font) # 标题下划线 title_w = draw.textlength(title, font=title_font) underline_y = y0 + title_font.getbbox("Ay")[3] - title_font.getbbox("Ay")[1] + 6 draw.line((x0, underline_y, x0 + min(text_area_w, int(title_w)), underline_y), fill=(0, 0, 0), width=2) y0 = underline_y + margin # 自动换行 if text is None: text = "" paragraphs = text.split("\n") wrapped_lines = [] # 粗略估计行宽 -> 控制 wrap 宽度 sample = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" sample_w = draw.textlength(sample, font=base_font) or 1 avg_char_w = sample_w / len(sample) max_chars = max(8, int(text_area_w / max(avg_char_w, 1))) for p in paragraphs: wrapped = textwrap.wrap(p, width=max_chars) if p.strip() else [""] wrapped_lines.extend(wrapped) # 行高 line_h = int(base_font.getbbox("Ay")[3] - base_font.getbbox("Ay")[1]) + 4 # 侧栏可容纳的最大行数(若给了 max_lines 就用它;否则按高度自动算) if max_lines is None: max_lines = max(1, (H - y0 - margin) // line_h) # 截断并加省略号 display_lines = wrapped_lines[:max_lines] truncated = len(wrapped_lines) > max_lines if truncated and display_lines: display_lines[-1] = display_lines[-1].rstrip(" .") + " …" # 逐行写字 y = y0 for line in display_lines: draw.text((x0, y), line, fill=(0, 0, 0), font=base_font) y += line_h return np.asarray(out) def get_vla(cfg) -> torch.nn.Module: """ Load and initialize the VLA model from checkpoint. Args: cfg: Configuration object Returns: torch.nn.Module: The initialized VLA model """ # Load the model vla = DeepThinkVLA.from_pretrained( cfg.pretrained_checkpoint, torch_dtype=getattr(torch, cfg.compute_dtype), attn_implementation = 'sdpa', ) vla.eval() vla = vla.to(DEVICE) unomrmalize_action = _get_unomrmalize_action(cfg.pretrained_checkpoint) return vla, unomrmalize_action def _get_unomrmalize_action(checkpoint_path: str) -> None: dataset_statistics_path = os.path.join(checkpoint_path, "norm_stats.json") if os.path.isfile(dataset_statistics_path): with open(dataset_statistics_path, "r") as f: norm_stats = json.load(f) for key in norm_stats["action"].keys(): norm_stats["action"][key] = np.array(norm_stats["action"][key], dtype=np.float64) unomrmalize_action = Unnormalize_Action( normalization_type=ACTION_PROPRIO_NORMALIZATION_TYPE, stats=norm_stats["action"], action_mask=ACTION_MASK, ) return unomrmalize_action else: print( "WARNING: No local dataset_statistics.json file found for current checkpoint.\n" "You can ignore this if you are loading the base VLA (i.e. not fine-tuned) checkpoint." "Otherwise, you may run into errors when trying to call `predict_action()` due to an absent `unnorm_key`." ) raise NotImplementedError("No norm stats found!") def resize_image_for_policy(img: np.ndarray, resize_size: Union[int, Tuple[int, int]]) -> np.ndarray: assert isinstance(resize_size, (int, tuple)), "resize_size must be int or tuple" if isinstance(resize_size, int): resize_size = (resize_size, resize_size) img_pil = Image.fromarray(img) resize_trans = transforms.Resize(size=resize_size) resized_img = resize_trans(img_pil) return np.array(resized_img) def check_image_format(image: Any) -> None: """ Validate input image format. Args: image: Image to check Raises: AssertionError: If image format is invalid """ is_numpy_array = isinstance(image, np.ndarray) has_correct_shape = len(image.shape) == 3 and image.shape[-1] == 3 has_correct_dtype = image.dtype == np.uint8 assert is_numpy_array and has_correct_shape and has_correct_dtype, ( "Incorrect image format detected! Make sure that the input image is a " "numpy array with shape (H, W, 3) and dtype np.uint8!" ) def prepare_image_for_vla(image: np.ndarray) -> Image.Image: # Validate format check_image_format(image) # Resize if needed if image.shape != (DEEPTHINKVLA_IMAGE_SIZE, DEEPTHINKVLA_IMAGE_SIZE, 3): image = resize_image_for_policy(image, DEEPTHINKVLA_IMAGE_SIZE) # Convert to PIL image pil_image = Image.fromarray(image).convert("RGB") return pil_image def get_vla_action( cfg: Any, vla: torch.nn.Module, unomrmalize_action, processor: Any, obs: Dict[str, Any], task_label: str, ) -> List[np.ndarray]: with torch.inference_mode(): # Process images image = ( [ prepare_image_for_vla(obs["full_image"]), prepare_image_for_vla(obs["wrist_image"]), ] if cfg.num_images_in_input > 1 else [prepare_image_for_vla(obs["full_image"])] ) # Build VLA prompt if "cot" in cfg.pretrained_checkpoint: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + THINK_PREFIX + f"Task: {task_label.lower()};" else: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + f"Task: {task_label.lower()};" # Process primary image inputs = processor(text = [prompt], images = image, return_tensors="pt").to(DEVICE, dtype=torch.bfloat16) # Generate action # Standard VLA output (single-image inputs, discrete actions) if 'cot' in cfg.pretrained_checkpoint: kwargs = { "max_new_tokens": cfg.max_new_tokens, "do_sample": False, "pad_token_id": processor.tokenizer.pad_token_id, "bos_token_id" : processor.tokenizer.bos_token_id, "eos_token_id" : None, "use_cache" : True, "num_beams": 1, "temperature" : None, "top_p" : None, "top_k" : None, } generation_config = GenerationConfig(**kwargs) normalized_actions, input_cot_ids = vla.predict_cot_action( input_ids = inputs["input_ids"], pixel_values = inputs["pixel_values"], attention_mask = inputs["attention_mask"], generation_config = generation_config, ) actions = unomrmalize_action(torch.from_numpy(normalized_actions)).numpy() cot_text = processor.tokenizer.decode(input_cot_ids[0, inputs["input_ids"].shape[-1]:-1]) else: actions, _ = vla.predict_action(**inputs, unnorm_key=cfg.unnorm_key, do_sample=False) # Return action chunk as list of actions return [actions[i] for i in range(len(actions))], cot_text def get_vla_action_mask_cot( cfg: Any, vla: torch.nn.Module, unomrmalize_action, processor: Any, obs: Dict[str, Any], task_label: str, ) -> List[np.ndarray]: with torch.inference_mode(): # Process images image = ( [ prepare_image_for_vla(obs["full_image"]), prepare_image_for_vla(obs["wrist_image"]), ] if cfg.num_images_in_input > 1 else [prepare_image_for_vla(obs["full_image"])] ) # Build VLA prompt if "cot" in cfg.pretrained_checkpoint: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + THINK_PREFIX + f"Task: {task_label.lower()};" else: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + f"Task: {task_label.lower()};" # Process primary image inputs = processor(text = [prompt], images = image, return_tensors="pt").to(DEVICE, dtype=torch.bfloat16) # Generate action # Standard VLA output (single-image inputs, discrete actions) input_ids = torch.cat([inputs["input_ids"], torch.tensor([[257153, 257154, 257155]], device = inputs["input_ids"].device)], dim=-1) attention_mask = torch.cat([inputs["attention_mask"], torch.tensor([[1, 1, 1]], device = inputs["attention_mask"].device)], dim=-1) logits, action_start_idx = vla.prompt_cot_predict_action( input_cot_ids = input_ids, pixel_values = inputs["pixel_values"], attention_mask = attention_mask, ) start_indices = action_start_idx.unsqueeze(1) # [batch_size, 1] position_offsets = torch.arange(ACTION_DIM * NUM_ACTIONS_CHUNK, device=logits.device).unsqueeze(0) # [1, seq_length] seq_indices = start_indices + position_offsets # [batch_size, ACTION_DIM*NUM_ACTIONS_CHUNK] # Discrete token-based prediction predicted_action_token_ids = (vla.config.action_token_end_idx - vla.config.action_token_begin_idx) - ( logits[ torch.arange(logits.shape[0], device=logits.device).unsqueeze(-1), seq_indices, vla.config.action_token_begin_idx:vla.config.action_token_end_idx + 1 ] .argmax(dim=-1) .cpu() .numpy() ) discretized_actions = discretized_actions = np.clip(predicted_action_token_ids, a_min=0, a_max=vla.bin_centers.shape[0] - 1) normalized_actions = vla.bin_centers[discretized_actions] normalized_actions = normalized_actions.reshape(NUM_ACTIONS_CHUNK, ACTION_DIM) actions = unomrmalize_action(torch.from_numpy(normalized_actions)).numpy() cot_text = '' # Return action chunk as list of actions return [actions[i] for i in range(len(actions))], cot_text # def get_vla_action_mask_cot_random( # cfg: Any, # vla: torch.nn.Module, # unomrmalize_action, # processor: Any, # obs: Dict[str, Any], # task_label: str, # ) -> List[np.ndarray]: # with torch.inference_mode(): # # Process images # image = ( # [ # prepare_image_for_vla(obs["full_image"]), # prepare_image_for_vla(obs["wrist_image"]), # ] # if cfg.num_images_in_input > 1 # else [prepare_image_for_vla(obs["full_image"])] # ) # # Build VLA prompt # if "cot" in cfg.pretrained_checkpoint: # prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + THINK_PREFIX + f"Task: {task_label.lower()};" # else: # prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + f"Task: {task_label.lower()};" # # Process primary image # inputs = processor(text = [prompt], images = image, return_tensors="pt").to(DEVICE, dtype=torch.bfloat16) # # Generate action # # Standard VLA output (single-image inputs, discrete actions) # kwargs = { # "max_new_tokens": cfg.max_new_tokens, # "do_sample": False, # "pad_token_id": processor.tokenizer.pad_token_id, # "bos_token_id" : processor.tokenizer.bos_token_id, # "eos_token_id" : None, # "use_cache" : True, # "num_beams": 1, # "temperature" : None, # "top_p" : None, # "top_k" : None, # } # generation_config = GenerationConfig(**kwargs) # input_cot_ids = vla.generate( # input_ids = inputs["input_ids"], # pixel_values = inputs["pixel_values"], # attention_mask = inputs["attention_mask"], # generation_config = generation_config, # stopping_criteria=vla.stopping, # logits_processor=vla.proc, # ) # # orig_think_text = processor.tokenizer.decode(input_cot_ids[0, inputs["input_ids"].shape[-1]:]) # cot_ids_remove_pre_end = input_cot_ids[0, inputs["input_ids"].shape[-1]:][1:-2] # cot_ids_remove_pre_end_random_ids = torch.randperm(cot_ids_remove_pre_end.size(0)) # random_cot_ids = torch.cat([torch.tensor([257153],device=cot_ids_remove_pre_end.device), cot_ids_remove_pre_end[cot_ids_remove_pre_end_random_ids], torch.tensor([257154, 257155], device=cot_ids_remove_pre_end.device)], dim=0).unsqueeze(0) # random_think_text = processor.tokenizer.decode(random_cot_ids[0]) # random_input_cot_ids = torch.cat([inputs["input_ids"], random_cot_ids], dim=-1) # logits, action_start_idx = vla.prompt_cot_predict_action( # input_cot_ids = random_input_cot_ids, # pixel_values = inputs["pixel_values"], # attention_mask = torch.ones_like(random_input_cot_ids, device=random_input_cot_ids.device), # ) # start_indices = action_start_idx.unsqueeze(1) # [batch_size, 1] # position_offsets = torch.arange(ACTION_DIM * NUM_ACTIONS_CHUNK, device=logits.device).unsqueeze(0) # [1, seq_length] # seq_indices = start_indices + position_offsets # [batch_size, ACTION_DIM*NUM_ACTIONS_CHUNK] # # Discrete token-based prediction # predicted_action_token_ids = (vla.config.action_token_end_idx - vla.config.action_token_begin_idx) - ( # logits[ # torch.arange(logits.shape[0], device=logits.device).unsqueeze(-1), # seq_indices, # vla.config.action_token_begin_idx:vla.config.action_token_end_idx + 1 # ] # .argmax(dim=-1) # .cpu() # .numpy() # ) # discretized_actions = discretized_actions = np.clip(predicted_action_token_ids, a_min=0, a_max=vla.bin_centers.shape[0] - 1) # normalized_actions = vla.bin_centers[discretized_actions] # normalized_actions = normalized_actions.reshape(NUM_ACTIONS_CHUNK, ACTION_DIM) # actions = unomrmalize_action(torch.from_numpy(normalized_actions)).numpy() # # Return action chunk as list of actions # return [actions[i] for i in range(len(actions))], random_think_text def get_vla_action_mask_cot_random( cfg: Any, vla: torch.nn.Module, unomrmalize_action, processor: Any, obs: Dict[str, Any], task_label: str, ) -> List[np.ndarray]: with torch.inference_mode(): # Process images image = ( [ prepare_image_for_vla(obs["full_image"]), prepare_image_for_vla(obs["wrist_image"]), ] if cfg.num_images_in_input > 1 else [prepare_image_for_vla(obs["full_image"])] ) # Build VLA prompt if "cot" in cfg.pretrained_checkpoint: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + THINK_PREFIX + f"Task: {task_label.lower()};" else: prompt = processor.tokenizer.additional_special_tokens[0] * len(image) + f"Task: {task_label.lower()};" # Process primary image inputs = processor(text = [prompt], images = image, return_tensors="pt").to(DEVICE, dtype=torch.bfloat16) # Generate action # Standard VLA output (single-image inputs, discrete actions) input_cot_ids = torch.cat([inputs["input_ids"], torch.tensor([[257153]], device = inputs["input_ids"].device),torch.randint(0, 220000, (1,128), device = inputs["input_ids"].device), torch.tensor([[257154, 257155]], device = inputs["input_ids"].device)], dim=-1) attention_mask = torch.ones_like(input_cot_ids, device=input_cot_ids.device) logits, action_start_idx = vla.prompt_cot_predict_action( input_cot_ids = input_cot_ids, pixel_values = inputs["pixel_values"], attention_mask = attention_mask, ) start_indices = action_start_idx.unsqueeze(1) # [batch_size, 1] position_offsets = torch.arange(ACTION_DIM * NUM_ACTIONS_CHUNK, device=logits.device).unsqueeze(0) # [1, seq_length] seq_indices = start_indices + position_offsets # [batch_size, ACTION_DIM*NUM_ACTIONS_CHUNK] # Discrete token-based prediction predicted_action_token_ids = (vla.config.action_token_end_idx - vla.config.action_token_begin_idx) - ( logits[ torch.arange(logits.shape[0], device=logits.device).unsqueeze(-1), seq_indices, vla.config.action_token_begin_idx:vla.config.action_token_end_idx + 1 ] .argmax(dim=-1) .cpu() .numpy() ) discretized_actions = discretized_actions = np.clip(predicted_action_token_ids, a_min=0, a_max=vla.bin_centers.shape[0] - 1) normalized_actions = vla.bin_centers[discretized_actions] normalized_actions = normalized_actions.reshape(NUM_ACTIONS_CHUNK, ACTION_DIM) actions = unomrmalize_action(torch.from_numpy(normalized_actions)).numpy() cot_text = processor.tokenizer.decode(input_cot_ids[0, inputs["input_ids"].shape[-1]:-1]) # Return action chunk as list of actions return [actions[i] for i in range(len(actions))], cot_text