// ABOUTME: Yasa2 vision encoder graph builder for ConvNeXt-based architecture. // ABOUTME: Implements patch embedding, ConvNeXt stages with GRN, and adaptive pooling. #include "models.h" static ggml_tensor * add_channel_bias( ggml_context * ctx0, ggml_tensor * x_whcb, ggml_tensor * b_c) { if (!b_c) { return x_whcb; } ggml_tensor * b4 = ggml_reshape_4d(ctx0, b_c, 1, 1, b_c->ne[0], 1); return ggml_add(ctx0, x_whcb, b4); } static ggml_tensor * mul_channel_weight( ggml_context * ctx0, ggml_tensor * x_whcb, ggml_tensor * w_c) { if (!w_c) { return x_whcb; } ggml_tensor * w4 = ggml_reshape_4d(ctx0, w_c, 1, 1, w_c->ne[0], 1); return ggml_mul(ctx0, x_whcb, w4); } ggml_tensor * clip_graph_yasa2::layer_norm_channels(ggml_tensor * inp, ggml_tensor * w, ggml_tensor * b, float eps) { // Match HF ConvNextLayerNorm(channels_first): // u = mean_c(x), s = mean_c((x-u)^2), x = (x-u)/sqrt(s+eps) // cast back to input dtype before affine. ggml_tensor * cur = ggml_permute(ctx0, inp, 2, 1, 0, 3); // [W,H,C,B] -> [C,H,W,B] cur = ggml_cont(ctx0, cur); ggml_tensor * u = ggml_mean(ctx0, cur); // [1,H,W,B] ggml_tensor * xm = ggml_sub(ctx0, cur, u); // [C,H,W,B] ggml_tensor * s = ggml_mul(ctx0, xm, xm); // [C,H,W,B] s = ggml_mean(ctx0, s); // [1,H,W,B] s = ggml_clamp(ctx0, s, eps, 1e30f); // avoid div-by-zero in no-alloc warmup s = ggml_sqrt(ctx0, s); // [1,H,W,B] ggml_tensor * xhat = ggml_div(ctx0, xm, s); // [C,H,W,B] xhat = ggml_permute(ctx0, xhat, 2, 1, 0, 3); // [W,H,C,B] xhat = ggml_cont(ctx0, xhat); xhat = mul_channel_weight(ctx0, xhat, w); xhat = add_channel_bias(ctx0, xhat, b); return xhat; } ggml_tensor * clip_graph_yasa2::convnext_grn(ggml_tensor * inp, ggml_tensor * w, ggml_tensor * b) { // Exact ConvNeXtV2 GRN: // Gx = ||x||_2 over spatial dims (W,H), Nx = Gx / (mean_c(Gx) + eps) // y = w * (x * Nx) + b + x const int64_t wdim = inp->ne[0]; const int64_t hdim = inp->ne[1]; const int64_t cdim = inp->ne[2]; const int64_t bdim = inp->ne[3]; // Keep GRN math in fp32 for stability; fp16/bf16 accumulation can drift. ggml_tensor * sq = ggml_mul(ctx0, inp, inp); ggml_tensor * sq_flat = ggml_reshape_4d(ctx0, sq, wdim * hdim, cdim, 1, bdim); // [WH,C,1,B] ggml_tensor * gx = ggml_sum_rows(ctx0, sq_flat); // [1,C,1,B] gx = ggml_sqrt(ctx0, gx); // [1,C,1,B] ggml_tensor * gx_ch_first = ggml_permute(ctx0, gx, 1, 0, 2, 3); // [C,1,1,B] gx_ch_first = ggml_cont(ctx0, gx_ch_first); ggml_tensor * gx_mean = ggml_mean(ctx0, gx_ch_first); // [1,1,1,B] gx_mean = ggml_clamp(ctx0, gx_mean, 1e-6f, 1e30f); // approx +eps, warmup-safe ggml_tensor * nx = ggml_div(ctx0, gx, gx_mean); // [1,C,1,B] nx = ggml_permute(ctx0, nx, 0, 2, 1, 3); // [1,1,C,B] nx = ggml_cont(ctx0, nx); ggml_tensor * xnx = ggml_mul(ctx0, inp, nx); xnx = mul_channel_weight(ctx0, xnx, w); xnx = add_channel_bias(ctx0, xnx, b); return ggml_add(ctx0, inp, xnx); } ggml_cgraph * clip_graph_yasa2::build() { ggml_tensor * cur = build_inp_raw(); // Patch embedding Conv2d(kernel=4, stride=4) cur = ggml_conv_2d(ctx0, model.yasa_patch_w, cur, patch_size, patch_size, 0, 0, 1, 1); cur = add_channel_bias(ctx0, cur, model.yasa_patch_b); ggml_set_name(cur, "yasa2_patch_conv_out"); cb(cur, "yasa2_patch_conv_out", -1); cur = layer_norm_channels(cur, model.yasa_patch_ln_w, model.yasa_patch_ln_b, eps); ggml_set_name(cur, "yasa2_patch_ln_out"); cb(cur, "yasa2_patch_ln_out", -1); // ConvNeXt stages for (size_t s = 0; s < model.yasa_stages.size(); ++s) { const auto & stage = model.yasa_stages[s]; if (stage.down_conv_w) { cur = layer_norm_channels(cur, stage.down_ln_w, stage.down_ln_b, eps); cur = ggml_conv_2d(ctx0, stage.down_conv_w, cur, 2, 2, 0, 0, 1, 1); cur = add_channel_bias(ctx0, cur, stage.down_conv_b); ggml_format_name(cur, "yasa2_stage%zu_down_out", s); } for (size_t bi = 0; bi < stage.blocks.size(); ++bi) { const auto & blk = stage.blocks[bi]; ggml_tensor * res = cur; ggml_tensor * x = ggml_conv_2d_dw(ctx0, blk.dw_w, cur, 1, 1, 3, 3, 1, 1); x = add_channel_bias(ctx0, x, blk.dw_b); x = layer_norm_channels(x, blk.ln_w, blk.ln_b, eps); // pwconv1/pwconv2 are HF Linear layers over channels; implement via matmul on tokens. const int64_t w = x->ne[0]; const int64_t h = x->ne[1]; const int64_t b = x->ne[3]; ggml_tensor * tok = ggml_reshape_3d(ctx0, x, w * h, x->ne[2], b); // [T,C,B] tok = ggml_permute(ctx0, tok, 1, 0, 2, 3); // [C,T,B] tok = ggml_cont(ctx0, tok); tok = ggml_mul_mat(ctx0, blk.pw1_w, tok); // [4C,T,B] if (blk.pw1_b) { ggml_tensor * b1 = ggml_reshape_3d(ctx0, blk.pw1_b, blk.pw1_b->ne[0], 1, 1); // [4C,1,1] tok = ggml_add(ctx0, tok, b1); } x = ggml_permute(ctx0, tok, 1, 0, 2, 3); // [T,4C,B] x = ggml_cont(ctx0, x); x = ggml_reshape_4d(ctx0, x, w, h, tok->ne[0], b); // [W,H,4C,B] x = ggml_gelu_erf(ctx0, x); x = convnext_grn(x, blk.grn_w, blk.grn_b); tok = ggml_reshape_3d(ctx0, x, w * h, x->ne[2], b); // [T,4C,B] tok = ggml_permute(ctx0, tok, 1, 0, 2, 3); // [4C,T,B] tok = ggml_cont(ctx0, tok); tok = ggml_mul_mat(ctx0, blk.pw2_w, tok); // [C,T,B] if (blk.pw2_b) { ggml_tensor * b2 = ggml_reshape_3d(ctx0, blk.pw2_b, blk.pw2_b->ne[0], 1, 1); // [C,1,1] tok = ggml_add(ctx0, tok, b2); } x = ggml_permute(ctx0, tok, 1, 0, 2, 3); // [T,C,B] x = ggml_cont(ctx0, x); x = ggml_reshape_4d(ctx0, x, w, h, tok->ne[0], b); // [W,H,C,B] cur = ggml_add(ctx0, res, x); ggml_format_name(cur, "yasa2_stage%zu_blk%zu_out", s, bi); } } // HF path adds vision position embeddings BEFORE adaptive pooling. const int64_t pre_w = cur->ne[0]; const int64_t pre_h = cur->ne[1]; ggml_tensor * tokens_pre = ggml_reshape_3d(ctx0, cur, pre_w * pre_h, cur->ne[2], cur->ne[3]); // [T,C,B] tokens_pre = ggml_permute(ctx0, tokens_pre, 1, 0, 2, 3); // [C,T,B] tokens_pre = ggml_cont(ctx0, tokens_pre); if (model.yasa_vision_pos_embed && tokens_pre->ne[1] == model.yasa_vision_pos_embed->ne[1]) { const int64_t n_ch = model.yasa_vision_pos_embed->ne[0]; const int64_t n_tokens = model.yasa_vision_pos_embed->ne[1]; ggml_tensor * pos = ggml_reshape_3d(ctx0, model.yasa_vision_pos_embed, (int) n_ch, (int) n_tokens, 1); tokens_pre = ggml_add(ctx0, tokens_pre, pos); } cur = ggml_permute(ctx0, tokens_pre, 1, 0, 2, 3); // [T,C,B] cur = ggml_cont(ctx0, cur); cur = ggml_reshape_4d(ctx0, cur, pre_w, pre_h, cur->ne[1], cur->ne[2]); // [W,H,C,B] // AdaptiveAvgPool2d target is 8x8 for real inputs, but warmup can use tiny images. const int pooled_w = std::min(8, (int) cur->ne[0]); const int pooled_h = std::min(8, (int) cur->ne[1]); const int kw = std::max(1, (int) cur->ne[0] / pooled_w); const int kh = std::max(1, (int) cur->ne[1] / pooled_h); cur = ggml_pool_2d(ctx0, cur, GGML_OP_POOL_AVG, kw, kh, kw, kh, 0, 0); // [W,H,C,B] -> [C,T,B] ggml_tensor * tokens = ggml_reshape_3d(ctx0, cur, cur->ne[0] * cur->ne[1], cur->ne[2], cur->ne[3]); tokens = ggml_permute(ctx0, tokens, 1, 0, 2, 3); tokens = ggml_cont(ctx0, tokens); cb(tokens, "yasa2_tokens", -1); GGML_ASSERT(model.mm_0_w && model.mm_2_w); ggml_tensor * embeddings = build_ffn( tokens, model.mm_0_w, model.mm_0_b, nullptr, nullptr, model.mm_2_w, model.mm_2_b, FFN_GELU_ERF, -1); cb(embeddings, "yasa2_emb", -1); ggml_build_forward_expand(gf, embeddings); return gf; }