Files
hm 50921994aa
ci / ubuntu-latest / clang (push) Failing after 1m31s
ci / ubuntu-latest / gcc (push) Failing after 32s
ci / macos-latest / apple-clang (push) Canceled after 0s
ci / windows-latest / mingw (push) Canceled after 0s
ci / windows-latest / msvc (push) Canceled after 0s
Phase6:真实语料验证收官——planeGCS 官方回归 11 场景回放 100% + 全库 API 改名 gcs→vdcs
- r1:全库标识符 gcs→vdcs(目录/文件 git mv、命名空间/C ABI/CMake target/文档,
  五轮正则 12000+ 处;204/204 编译零警告)
- c3:FreeCAD SketcherTests TestSketcherSolver 11 语义类场景 JSON 转换写盘
  tests/corpus/scenes/(LGPL 上游数值派生逐件标注)
- c4:回放器 vdcs_corpus_replay 联调 11/11,4 项修正——DistanceX/Y 参数序
  (引擎残差 xb−xa−v)、add_axis 轴向反转、TangentAtPoint 放宽 Arc2D、
  场景 04 断言语义对齐原测试(ExpressionEngine 清空等价由单测覆盖)
- c5:ctest 41/41 全绿;33 号真实语料验证报告(转换映射定案 + 引擎语义
  确认清单);07 对标矩阵 v1.3(词表 29→31 补 CircleDistance/
  CircleLineDistance 保侧距离族);31 号进度 P6 收官
2026-09-05 14:43:36 +08:00

124 lines
5.1 KiB
C++
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//===--------------------------------------------------------------===//
// VDCS - 几何约束求解引擎
// File: examples/sketch_tutorial.cpp
// Description: 2D 草图求解综合教程(P1-S3-06)
// 覆盖:混合实体建模 / 几何+尺寸约束 / DOF 分析 /
// 结构化诊断 / 尺寸驱动重解 / JSON 序列化往返
//===--------------------------------------------------------------===//
#include <cmath>
#include <iostream>
#include "vdcs/core/diagnostic.h"
#include "vdcs/core/dof_analyzer.h"
#include "vdcs/vdcs.h"
namespace {
double CircleCenterDistance(const vdcs::Model& model, vdcs::Uid a, vdcs::Uid b) {
const auto* ca = static_cast<const vdcs::Circle2D*>(model.FindEntity(a));
const auto* cb = static_cast<const vdcs::Circle2D*>(model.FindEntity(b));
return std::sqrt((cb->Cx() - ca->Cx()) * (cb->Cx() - ca->Cx()) +
(cb->Cy() - ca->Cy()) * (cb->Cy() - ca->Cy()));
}
void PrintDiagnostics(const vdcs::SolveResult& result) {
std::cout << " status = " << vdcs::SolveDiagnostics::ToString(result.status)
<< ", mobility = " << result.mobility
<< ", fully_constrained = " << result.fully_constrained << "\n";
for (const auto& d : result.diagnostics) {
std::cout << " [" << vdcs::SolveDiagnostics::ToString(d.level) << "] "
<< vdcs::SolveDiagnostics::ToString(d.code) << ": "
<< d.message << "\n";
}
}
} // namespace
int main() {
// === 草图:基圆 c1 固定,从动圆 c2 与其外切,点 p 沿 c1 滑动 ===
// c2 仅受「外切 + 半径」约束 → 圆心可绕 c1 旋转(1 DOF)
// p 受「点在圆上」约束 → 沿 c1 滑动(1 DOF)
// 有意欠约束:演示欠定系统的近最小范数解 + kUnderConstrained 诊断
vdcs::Model model;
const auto c1 = model.AddCircle2D("base", 0.0, 0.0, 4.0);
const auto c2 = model.AddCircle2D("follower", 8.0, 0.0, 2.0);
const auto p = model.AddPoint2D("slider", 4.0, 0.0);
auto r_add = [&](auto&& result, const char* what) {
if (!result.Ok()) {
std::cerr << "建模失败: " << what << ": "
<< result.Err().Message() << "\n";
std::exit(1);
}
};
r_add(c1, "circle base");
r_add(c2, "circle follower");
r_add(p, "point slider");
r_add(model.AddFixed2D("fix_base", c1.Value()), "fix base");
r_add(model.AddRadius2D("r_follower", c2.Value(), 2.0), "radius");
r_add(model.AddTangent2D("tangent", c1.Value(), c2.Value(),
/*external=*/true),
"tangent");
r_add(model.AddPointOnCurve2D("p_on_base", p.Value(), c1.Value()),
"point on curve");
std::cout << "== 初始 ==\n";
std::cout << "|c1 c2| = " << CircleCenterDistance(model, c1.Value(), c2.Value())
<< "(外切要求 6.0)\n";
std::cout << "mobility = " << model.Mobility() << "\n";
// === 求解(规模路由:小模型自动走稠密 Newton)===
auto report = model.Solve(vdcs::SolveOptions{});
if (!report.Ok()) {
std::cerr << "求解失败: " << report.Err().Message() << "\n";
return 1;
}
std::cout << "\n== 求解 ==\n";
std::cout << "converged = " << report.Value().converged
<< ", iterations = " << report.Value().iterations
<< ", residual = " << report.Value().residual_norm << "\n";
std::cout << "|c1 c2| = "
<< CircleCenterDistance(model, c1.Value(), c2.Value())
<< "(外切要求 6.0)\n";
// === DOF 分析 + 结构化诊断(P-09)===
auto dof = vdcs::DofAnalyzer::Analyze(model);
auto result = vdcs::SolveDiagnostics::Build(report.Value(), dof);
std::cout << "\n== 诊断 ==\n";
PrintDiagnostics(result);
// === 尺寸驱动:半径 2.0 → 3.0,重解 ===
vdcs::Uid radius_uid = vdcs::kInvalidUid;
for (const auto& c : model.Constraints()) {
if (dynamic_cast<const vdcs::Radius2D*>(c.get()) != nullptr) {
radius_uid = c->Id();
break;
}
}
static_cast<vdcs::Radius2D*>(model.FindConstraint(radius_uid))
->SetValue(3.0);
auto driven = model.Solve(vdcs::SolveOptions{});
if (!driven.Ok() || !driven.Value().converged) {
std::cerr << "尺寸驱动重解失败\n";
return 1;
}
std::cout << "\n== 尺寸驱动(半径 2.0 → 3.0)==\n";
std::cout << "iterations = " << driven.Value().iterations << "\n";
std::cout << "|c1 c2| = "
<< CircleCenterDistance(model, c1.Value(), c2.Value())
<< "(外切要求 7.0)\n";
// === JSON 序列化往返 ===
auto save = vdcs::SaveModelJson(model, "sketch_tutorial.json");
auto loaded = vdcs::LoadModelJson("sketch_tutorial.json");
if (!save.Ok() || !loaded.Ok()) {
std::cerr << "序列化失败\n";
return 1;
}
auto reload = loaded.Value().Solve(vdcs::SolveOptions{});
std::cout << "\n== JSON 往返 ==\n";
std::cout << "已保存 sketch_tutorial.json;重载求解 converged = "
<< (reload.Ok() && reload.Value().converged) << "\n";
return 0;
}