Qiao-MCP — Bridge Engineering (桥梁工程)

Configure a concrete-check analysis setting group (配置混凝土检算分析设置). ⚠️ UNITS (单位): parameters in this tool use qtmodel's NATIVE units — **mm for lengths and MPa for stresses**, NOT the SI (m/Pa) used elsewhere in this server. qtmodel does not document these units; they are inferred from its defaults (e.g. protective_thickness=30.0 means 30 mm, fatigue_limit_steel_bar=145.0 means 145 MPa). Pass values accordingly. 本工具参数沿用 qtmodel 原生单位（长度 mm、应力 MPa），与本服务器其余 工具的 SI 约定不同；qtmodel 未标注单位，此结论由其默认值推断。 Use get_check_data("<kind>_setting") to read current values first. 建议先用 get_check_data 读取当前值，再按需覆盖。 Args: kind: Setting group (设置类别): "normal_section_bearing" (正截面承载力): normal_section_bearing_calculation_type: 1=同比例变化 2=轴力不变 3=My不变 4=Mz不变 5=轴力与My不变 6=轴力与Mz不变 7=My与Mz不变 "oblique_shear_bearing" (斜截面抗剪承载力): reinforcement_height_multiple, is_consider_as_simple_support, shear_strength_material_factor, oblique_section_shear_direction_type: 1=竖向(z) 2=横向(y) 3=双向 "limit_state" (极限状态法): cal_fatigue, fatigue_limit_steel_bar (MPa), fatigue_limit_prestress (MPa), is_consider_as_simple_support, is_consider_construction_load "normal_stress" (正应力): aashto2020_normal_stress_rebar_type: 1=直钢筋/无交叉焊缝焊接钢丝网 2=高应力区带交叉焊缝的直焊接钢丝网, tendon_allowable_stress_amplitude (MPa), flange_web_slenderness_ratio, construction_stage_concrete_tensile_limit (MPa), service_combination3_concrete_tension_limit (MPa) "crack_width" (裂缝宽度): highway_environment_category_type (1~7 公路环境类别), railway_environment_category_type (1~6 铁路环境类别), railway_limit_environment_category_type (1~11 铁路限值环境类别), crack_setting_type: 1=0 2=0.10 3=0.15 4=0.20 5=0.25 6=禁止使用, clear_protective_thickness (mm), protective_thickness (mm), steel_bar_type: 1=带肋钢筋 2=光圆钢筋…

Create a single frame element (beam/truss/cable) with named parameters (创建单个梁/杆/索单元，参数具名). This is the preferred way to create individual elements — all parameters have explicit names and inline documentation. Args: node_i: Start node ID (I端节点编号) node_j: End node ID (J端节点编号) mat_id: Material ID — use get_materials to find valid IDs (材料编号) sec_id: Section ID — use get_section_list to find valid IDs (截面编号) element_id: Element ID, -1 = auto-assign next available ID (单元编号，-1表示自动分配) beta_angle: Beta angle in degrees, controls local axis orientation (贝塔角，度) ele_type: Element type (单元类型): 1=Beam(梁), 2=Truss(杆), 3=Cable(索) initial_type: Initial strain/force type (初始应变类型): 0=None, 1=Strain, 2=Force initial_value: Initial strain or force value (初始应变或内力值) Example: create_beam_element(node_i=1, node_j=2, mat_id=1, sec_id=1)

Batch-create frame elements chaining nodes along a girder (批量创建沿主梁方向连接相邻节点的梁单元). PREFERRED: pass node_ids — the exact ID sequence reported by create_nodes_linear. Elements chain them in the order given: node_ids[0]→[1], [1]→[2], … （首选：直接传 create_nodes_linear 回报的编号序列，按给定顺序连接） Do NOT assume node IDs are consecutive. The backend assigns numbering in an order that is NOT predictable from the request — measured on qtmodel 2.6.3, one batch came back [1104,1103,1102,1101,1100] (reversed) and another [1201,1200,1204,1203,1202] (neither ascending nor reversed). Chaining by ID arithmetic on such a batch silently produces folded-back geometry: elements of wrong length and direction that the solver accepts without error, yielding a model that computes the wrong bridge. （后端编号顺序不可预测，按编号递推会静默建出折返几何，求解器不会报错） Node coordinates are checked before writing: if the chain is not geometrically monotonic, the call fails instead of building a bad model. Args: mat_id: Material ID for all elements (所有梁单元的材料编号) sec_id: Section ID for all elements (所有梁单元的截面编号) node_ids: Node IDs in girder order, as reported by create_nodes_linear (节点编号序列，按主梁走向排列). Creates len(node_ids)-1 elements. node_id_start: LEGACY fallback, only when node_ids is omitted — assumes IDs run consecutively from here (旧式用法，假设编号连续) count: Number of elements, only with node_id_start (单元数量) element_id_start: ID assigned to the first element, then auto-incremented (第一个单元的编号，后续自动递增) beta_angle: Beta angle in degrees, same for all elements (贝塔角，度) ele_type: 1=Beam(梁), 2=Truss(杆), 3=Cable(索) Examples: # Preferred — chain the IDs create_nodes_linear actually returned: create_beam_elements_linear(mat_id=1, sec_id=1, node_ids=[5, 501, 500, 502]) # Legacy — only safe when the nodes are known to be consecutive: create_beam_elements_linear(mat_id=1, sec_id=1, node_id_sta…

Create a boundary condition group (创建边界组). Boundary groups collect supports/links to be activated or deactivated together during construction stages (施工阶段中统一控制边界条件激活状态). Args: name: Boundary group name (边界组名称)

One-step creation of a continuous beam bridge model (一键创建连续梁桥模型). Creates a multi-span continuous beam with fixed supports at piers and appropriate end conditions. 创建多跨连续梁桥，中间支座为固定支承，端部为活动支承。 Args: spans: List of span lengths in meters (各跨跨径列表，单位m), e.g. [30.0, 50.0, 30.0] means 3-span (3跨均匀布置) num_elements_per_span: Elements per span (每跨单元划分数) material_name: Material name (材料名，须已创建) section_name: Section name (截面名，须已创建) self_weight_case: Self-weight load case name (自重工况名)

Create elements from a raw data array (通过原始数组创建单元). For beam elements, prefer `create_beam_element` or `create_beam_elements_linear` which have named parameters and are easier to use correctly. Args: element_data: Element data list. Each item format: - Beam/Truss: [id, type(1=beam,2=truss), matId, secId, beta, nodeI, nodeJ, initType, initVal] - Cable: [id, 3, matId, secId, beta, nodeI, nodeJ, tensionType, tensionVal] - Plate: [id, 4, matId, thicknessId, beta, nodeI, nodeJ, nodeK, nodeL, plateType] 单元数据列表。梁=1, 杆=2, 索=3, 板=4

Create a line-width cross-section (创建线宽截面). Args: name: Section name (截面名称) sec_lines: List of line segments with thickness. Format: [[y1, z1, y2, z2, thickness], ...]

Create a moving live load case (创建活载工况). FINAL STEP of the moving load workflow. The analysis engine finds the worst-case vehicle positions for envelope results (分析引擎自动计算最不利车辆位置得到包络效应). Args: name: Load case name (活载工况名) influence_plane: Influence plane name (影响面名称) span: Bridge span in meters (跨度，单位m) sub_cases: Sub-case list, each item [vehicle_name, factor, [lane names...]] (子工况信息 [[车辆名, 系数, [车道名...]], ...]) Example: create_live_load_case(name="活载工况1", influence_plane="影响面1", span=100, sub_cases=[["公路I级", 1.0, ["车道1", "车道2"]]])

Create a load case (创建荷载工况). A load case must exist before loads can be applied to it. In QiaoTong, creating a load case named "自重" is sufficient for self-weight — the software applies it automatically (see server instructions for details). Args: name: Load case name (工况名称, e.g. "自重", "SW", "恒荷") case_type: Load case type (荷载工况类型): "施工阶段荷载" (default) | "恒载" | "活载" | "制动力" | "风荷载" "体系温度荷载" | "梯度温度荷载" "长轨伸缩挠曲力荷载" | "脱轨荷载" | "长轨断轨力荷载" "船舶撞击荷载" | "汽车撞击荷载" | "用户定义荷载"

Create a load group (创建荷载组). Every load in QiaoTong must belong to a load group. Create this before creating a load case or applying loads. 每个荷载必须属于某个荷载组，迅建荷载工况之前先建荷载组。 Args: name: Load group name (荷载组名称, e.g. "默认荷载组")

Create a material in the bridge model (创建材料). Args: name: Material name (材料名称) mat_type: Material type (材料类型): 1=Concrete(混凝土), 2=Steel(钢材), 3=Prestress(预应力), 4=Rebar(钢筋), 5=Custom(自定义), 6=Composite(组合) standard: Code standard index, starts from 1 (规范序号，从1开始) database: Material database name, e.g. 'C50', 'Q345' (数据库名称) data_info: Custom material properties [E, γ, ν, α] for mat_type=5 自定义材料参数 [弹性模量, 容重, 泊松比, 热膨胀系数]

Create nodes in the bridge model from an explicit coordinate list (创建节点). Prefer `create_nodes_linear` when nodes are evenly spaced along a line — it is far more concise for typical bridge models. Args: node_data: List of node coordinates. Format: [[x,y,z], ...] or [[id,x,y,z], ...] 节点坐标列表，格式: [[x,y,z],...] 或 [[id,x,y,z],...] intersected: Whether to split elements at intersection points (是否交叉分割, 默认关) is_merged: Whether to merge duplicate nodes at the same position (是否合并重合节点) merge_error: Merge tolerance in model units, default 1e-3 (合并容差，默认1mm) numbering_type: Node numbering strategy: 1=sequential (编号方式: 1=顺序编号) start_id: Starting node ID when auto-numbering (起始节点编号)

Create evenly-spaced nodes along a straight line — the preferred way to model a bridge girder (等间距直线批量创建节点). Instead of listing 101 coordinates for a 100m span at 1m intervals, just specify the count, starting point, and spacing in each direction. Args: count: Number of nodes to create (节点数量) start_x: X coordinate of the first node (起点X坐标) start_y: Y coordinate of the first node (起点Y坐标) start_z: Z coordinate of the first node (起点Z坐标) spacing_x: X increment between nodes, m (相邻节点X方向间距) spacing_y: Y increment between nodes (相邻节点Y方向间距) spacing_z: Z increment between nodes (相邻节点Z方向间距) start_id: Requested ID of the first node (期望的起始节点编号). HONORED ONLY when the model has no conflicting IDs — the backend assigns its own numbering when start_id is taken. The returned message reports the IDs actually assigned; always trust those, not start_id. （编号可能被后端改派，请以返回消息中的实际编号为准） is_merged: Whether to merge duplicate nodes (是否合并重合节点). When merging occurs, fewer nodes are created than requested. merge_error: Merge tolerance, default 1e-3 (合并容差) Examples: # 100m simply-supported beam, 101 nodes at 1m pitch along X axis: create_nodes_linear(count=101, start_x=0, spacing_x=1.0) # Two-span 50m+50m continuous beam, start x from 0: create_nodes_linear(count=101, start_x=0, spacing_x=1.0)

Create a custom polygon cross-section (创建任意多边形截面). Args: name: Section name (截面名称) loop_segments: Dictionary of loops. Keys should be 'main' for outer loop and 'sub1'... for inner hollow loops. Example: `{"main": [[y1,z1], [y2,z2], ...]}`

Create a cross-section (创建截面) — one tool for all parametric section types. Args: name: Section name (截面名称) sec_type: Section type, Chinese enum (截面类型，中文枚举)。 sec_info layout per type (各类型 sec_info 参数顺序): ─ 基本形状 ─ "矩形": [宽, 高] "圆形": [直径] "圆管": [直径, 壁厚] "箱型": [宽, 高, 底宽, 腹板厚, 顶板厚, 底板厚] "T形": [宽, 高, 腹板厚, 顶板厚] "倒T形": [宽, 高, 腹板厚, 底板厚] "I字形": [顶宽, 底宽, 高, 腹板厚, 顶板厚, 底板厚] "马蹄T形": [宽, 高, 腹板厚, 翼缘厚, 腹板底渐变高, 顶倒角宽, 顶倒角高, 底倒角宽, 底倒角高] "实腹八边形": [宽, 高, 倒角高, 倒角宽] "空腹八边形": [宽, 高, 腹板厚, 顶板厚, 底板厚, 倒角宽, 倒角高] "内八角形": [宽, 高, 腹板厚, 顶板厚, 底板厚, 倒角宽, 倒角高] "实腹圆端形": [宽, 高] "空腹圆端形": [宽, 高, 壁厚] ─ 混凝土/组合 ─ "I字型混凝土": [顶宽, 底宽, 高, 腹板厚, 顶板厚, 底板厚, 顶倒角宽, 顶倒角高, 底倒角宽, 底倒角高] "钢管砼": [直径, 壁厚] "钢箱砼": [宽, 高, 底宽, 腹板厚, 顶板厚, 底板厚] "混凝土箱梁": 顶板/腹板/底板参数列表，配合 box_num/box_height/symmetry/chamfer_info "工字组合梁" | "箱形组合梁" | "自定义组合梁": sec_info + mat_combine(材料组合比) ─ 钢结构带肋 ─ "带肋H截面": [高, 宽, 左右腹板厚, 横腹板厚, 腹板肋高, 腹板肋厚] "钢工字型带肋": [顶宽, 底宽, 腹板高, 顶板厚, 底板厚, 腹板厚, 顶缘肋距, 肋数, 肋距, 肋高, 肋厚] "带肋钢箱": [宽, 高, 腹板厚, 顶板厚, 底板厚, 顶底板肋高, 顶底板肋厚, 腹板肋高, 腹板肋厚, 顶底板肋距, 腹板肋距, 腹板肋数, 顶底板肋数] "钢桁箱梁3": [高, 宽, 顶悬臂肋高, 底悬臂肋高, 腹板厚, 顶板厚, 底板厚, 顶板肋高, 顶板肋厚, 底板肋高, 底板肋厚, 腹板肋高, 腹板肋厚] "钢桁箱梁1": [高, 宽, 左悬臂宽, 右悬臂宽, 底悬臂高, 腹板厚, 顶板厚, 底板厚, 顶板肋高, 顶板肋厚, 底板肋高, 底板肋厚, 顶缘腹板肋距, 腹板肋数, 腹板肋距, 腹板肋高, 腹板肋厚, 左腹板肋位置, 右腹板肋位置, 左悬臂肋距, 左悬臂肋高, 左悬臂肋厚, 左悬臂肋顶距, 左悬臂肋底距, 左悬臂肋倒角, 右悬臂肋距, 右悬臂肋高, 右悬臂肋厚, 右悬臂肋顶距, 右悬臂肋底距, 右悬臂肋倒角] (32项) "钢桁箱梁2": [高, 宽, 左上悬臂宽, 右上悬臂宽, 左下悬臂宽, 右下悬臂宽, 腹板厚, 顶板厚, 底板厚, 顶板肋高, 顶板肋厚, 底板肋高, 底板肋厚, 顶缘腹板肋距, 腹板肋数, 腹板肋距, 腹板肋高, 腹板肋厚, 左腹板肋位置, 右腹板肋位置, 左上悬臂肋距, 左上悬臂肋高, 左上悬臂肋厚, 左上悬臂肋顶距, 左上悬臂肋底距, 左上悬臂肋倒角, 右上悬臂肋距,…

Create a section directly from its pre-calculated properties (通过截面特性直接创建截面). Args: name: Section name (截面名称) area: Cross-sectional area (横截面面积 Area) ix: Torsional constant (扭转惯性矩 Ixx) iy: Moment of inertia about y-axis (抗弯惯性矩 Iyy) iz: Moment of inertia about z-axis (抗弯惯性矩 Izz) sec_property: Full list of properties (up to 29). If not provided, a basic list is auto-generated with Area, Ix, Iy, Iz.

One-step creation of a simple beam bridge model (一键创建简支梁桥模型). Creates nodes, beam elements, supports, and a self-weight load case in a single step. The bridge lies along the X-axis. 一键完成节点、梁单元、支承和自重工况的建立，桥梁沿X轴布置。 Args: span: Span length in meters (跨径，单位m) num_elements: Number of beam elements (梁单元划分数量), min 2 material_name: Material name (material must already exist) (材料名，须已创建) section_name: Section name (section must already exist) (截面名，须已创建) section_width: Section width in m for auto-creating a rectangle section (矩形截面宽度，单位m，若截面不存在则自动创建) section_height: Section height in m (矩形截面高度，单位m) self_weight_case: Self-weight load case name (自重工况名)

Create a structure group and optionally assign elements to it (创建结构组). Structure groups are used to control which elements are active during each construction stage (施工阶段分析中控制单元激活状态). Args: name: Structure group name (结构组名称) element_ids: Element IDs to add, int list or range string like '1to20' (单元编号列表或范围字符串，如 '1to20')

Create a tapered section from two existing sections (根据两个已存截面创建渐变截面). Args: name: Tapered section name (渐变截面名称) begin_id: Start section ID (起始截面编号) end_id: End section ID (终止截面编号) shear_consider: Consider shear deformation (是否考虑剪切变形), default True sec_normalize: Normalize section (截面归一化), default False

Create a 2D tendon defined by profile control points (创建2D钢束/平弯钢束). The tendon profile lies in the X-Z plane; each control point is [x, z, r] where r is the fillet radius (0 for sharp points). 钢束线形位于XZ平面，控制点为 [x, z, r]，r为圆弧半径（0为折点）。 Args: name: Tendon name (钢束名称) property_name: Tendon property name, must exist (钢束特性名，须已创建) control_points: Profile control points [[x, z, r], ...] (控制点信息 [[x, z, 半径r], ...]) point_insert: Insertion point [x, y, z] for straight positioning (直线定位时的插入点坐标 [x, y, z]) num: Number of tendons (根数) line_type: Point type (线型): 1=导线点(guide), 2=折线点(polyline) position_type: Positioning (定位方式): 1=straight(直线), 2=track line(轨迹线) symmetry: Symmetry point (对称点): 0=left end(左端), 1=right end(右端), 2=asymmetric(不对称) group_name: Tendon group name (钢束组名) Example: create_tendon_2d(name="T1", property_name="15-10", control_points=[[0, -0.5, 0], [20, -1.2, 8], [40, -0.5, 0]], point_insert=[0, 0, 0])

Create a tendon property definition (创建钢束特性). Args: name: Tendon property name (钢束特性名) material_name: Prestress steel material name, must exist (钢材材料名，须已通过 create_material 创建) tendon_type: Tendon type (钢束类型): 0=pre-tension(先张), 1=post-tension(后张), 2=external(体外) duct_type: Duct type (孔道类型): 1=金属波纹管, 2=塑料波纹管, 3=铁皮管, 4=钢管, 5=抽芯成型 steel_type: Steel type (钢材类型): 1=钢绞线(strand), 2=螺纹钢筋(threaded bar) area: Tendon area in m² (钢束面积), e.g. 0.00139 for 10Φ15.2 strands duct_diameter: Duct diameter in m (孔道直径) friction: Friction coefficient μ (摩阻系数), typically 0.20~0.30 deviation: Wobble coefficient k (偏差系数), typically 0.0015 anchorage_slip: Anchorage slip at each end in m (锚固滑移，两端相同), typ. 0.006 steel_detail: Advanced override, raw qtmodel steel_detail list (高级用法：直接给出原始 steel_detail 列表，覆盖上述四个参数； 钢绞线=[面积,孔道直径,摩阻,偏差]， 螺纹钢筋=[直径,面积,孔道直径,摩阻,偏差,张拉方式])

Toggle the display of node and element IDs (开关节点和单元编号显示). Args: node_id: True to show node IDs, False to hide (显示节点号) element_id: True to show element IDs, False to hide (显示单元号)

Locate nodes/elements by coordinates or attributes (按坐标或属性定位节点/单元). Args: by: Search mode (查找方式): "node_at_point" (按坐标找节点, 需 x/y/z, 可选 tolerance), "elements_at_point" (按坐标找单元, 需 x/y/z, 可选 tolerance), "elements_by_material" (按材料名找单元, 需 name), "elements_by_section" (按截面号找单元, 需 index), "element_type" (查单元类型, 需 ids), "element_weight" (查单元重量, 需 ids), "span_supports" (跨径支承信息, 需 span_info_name), "span_elements" (跨径单元信息, 需 span_info_name) x, y, z: Coordinates for point search (坐标) tolerance: Search tolerance (容差) name: Material name (材料名) index: Section ID (截面号) ids: Element IDs (单元编号) span_info_name: Span info name (跨径信息名) limit: Max items per page (单页条数上限) offset: Pagination offset (翻页偏移)

Get analysis results from the bridge model (获取分析结果). Args: result_type: Type of result to retrieve (结果类型): 'deformation' (变形), 'force' (内力), 'stress' (应力), 'reaction' (反力) ids: Node/Element IDs to query (查询的节点/单元编号) stage_id: Construction stage (施工阶段): -1=operation(运营), 0=envelope(包络), n=stage n (第n阶段) case_name: Load case name for operation stage (运营阶段荷载工况名). For stage_id=-1, the tool automatically adds "ST:" prefix if missing. (运营阶段查询时工具会自动添加 "ST:" 前缀) limit: Max items per page, default 100 (单页条数上限) offset: Pagination offset (翻页偏移) Returns: Deformation results (变形): List of dicts with keys {node_id, dx, dy, dz, rx, ry, rz} (lowercase, in meters/radians) Force results (内力): List of dicts with keys {element_id, force_i: {Fx, Fy, Fz, Mx, My, Mz}, force_j: {...}} (nested structure, forces in kN, moments in kN·m) Stress/Reaction: Similar nested dict structures

Query concrete-check data by kind (按类型查询混凝土检算数据). Read-only. Requires a check case to be open/imported first. 只读工具；需先创建或打开检算工况。列表结果分页返回。 Args: kind: What to query (查询类型): ── 结果 Results ── "stress" (应力信息, 可选 stress_type/name), "solve_status" (检算求解状态) ── 工况 Case ── "case" (检算工况, 可选 name), "basic_info" (检算基本信息), "materials" (材料信息), "load_table" (荷载表, 可选 combine_type/name), "section_property" (截面特性), "element_table" (单元表) ── 配筋 Reinforcement ── "reinforcement" (配筋数据), "stirrups" (箍筋定义), "shear_stirrup" (单元抗剪箍筋, 可选 element_id), "torsion_stirrup" (单元抗扭箍筋, 可选 element_id), "vertical_prestress" (竖向预应力), "tendon_section" (钢束截面) ── 分析设置 Analysis settings ── "normal_section_bearing_setting" (正截面承载力), "oblique_shear_bearing_setting" (斜截面抗剪承载力), "limit_state_setting" (极限状态法), "normal_stress_setting" (正应力), "crack_width_setting" (裂缝宽度), "moment_curvature_setting" (弯矩曲率), "bearing_curve_setting" (承载力曲线) element_id: Element ID for stirrup queries; omit for all (单元号，省略则查全部) stress_type: Stress combination type for kind="stress" (应力组合类型): 非 AASHTO: 1=标准值组合, 2=频遇组合, 3=准永久值组合, 4=主力组合, 5=主加附组合, 6=施工组合, 7=主加特殊组合, 8=恒载作用, 9=预应力作用, 10~13=使用组合Ⅰ~Ⅳ, 14=永久作用组合 AASHTO 2020: 1~4=使用组合Ⅰ~Ⅳ, 5=永久作用组合, 6=施工组合 combine_type: Combination type for kind="load_table" (荷载表组合类型) name: Explicit display name; overrides stress_type/combine_type when set (指定组合显示名，非空时优先于类型序号) limit: Max items per page, default 100, max 500 (单页条数上限) offset: Pagination offset (分页偏移)

Get moving load analysis results (获取移动荷载分析结果). Returns envelope (maximum and minimum) results for specified elements. 返回指定单元的移动荷载包络结果（最大值和最小值）。 Args: case_name: Live load case name (活载工况名) result_type: Result type (结果类型): 'force'(内力), 'stress'(应力), 'deformation'(变形) element_ids: Element or node IDs to query (查询的单元或节点编号)

Query model data by kind (按类型查询模型数据) — the single read tool for entities, loads, groups and stages. List results are paginated. Args: kind: What to query (查询类型): ── 实体 Entities ── "nodes" (节点, 可选 ids), "elements" (单元, 可选 ids), "materials" (材料), "sections" (截面列表), "section_detail" (截面详情, 需 sec_id, 可选 position 0=起端 1=末端), "section_shape" (截面形状, 需 sec_id), "section_property" (截面特性, 需 sec_id), "thickness" (板厚), "boundaries" (全部边界条件), "node_local_axis" (节点局部坐标), "constraint_equations" (约束方程), "effective_widths" (有效宽度), "reinforcement" (配筋数据) ── 组 Groups ── "structure_groups" (结构组名列表), "group_elements" (结构组内单元, 需 name), "group_nodes" (结构组内节点, 需 name) ── 荷载 Loads ── "load_cases" (荷载工况名), "nodal_force_loads" (节点力), "nodal_displacement_loads" (节点位移/沉降), "beam_element_loads" (梁单元荷载), "plate_element_loads" (板单元荷载), "initial_tension_loads" (初拉力), "cable_length_loads" (索长荷载), "pre_stress_loads" (预应力荷载), "node_masses" (节点质量), "tendon_properties" (钢束特性), "deviation_parameters" (制造偏差参数), "deviation_loads" (制造偏差荷载) ── 施工阶段 Stages ── "stages" (施工阶段名), "stage_elements" (阶段内单元, 需 stage_id), "stage_nodes" (阶段内节点, 需 stage_id), "stage_groups" (阶段内组, 需 stage_id) ids: Entity IDs for nodes/elements, int/list/range string "1to10" (编号) name: Group name, for group_elements/group_nodes (结构组名) sec_id: Section ID, for section_detail/section_shape/section_property (截面号) position: Tapered section end, for section_detail (变截面位置 0起/1末) stage_id: Stage ID, for stage_* kinds (施工阶段号) limit: Max items per page, default 100, max 500 (单页条数上限) offset: Skip count for pagination (翻页偏移)

Get a summary of the current bridge model (获取当前桥梁模型概要信息). Returns counts of all model entities: nodes, elements, materials, sections, construction stages, load cases, etc. 返回所有模型实体的数量统计。

Get special post-analysis results (专项分析结果查询) — beyond the basic deformation/force/stress/reaction of get_analysis_results. Args: kind: Result kind (结果类型): "vibration_modal" (自振振型, 需 mode), "buckling_modal" (屈曲振型, 需 mode), "period_vibration" (周期与振型汇总), "buckling_eigenvalue" (屈曲特征值), "self_concurrent_reaction" (自并发反力, 需 node_id + case_name), "all_concurrent_reaction" (全并发反力, 需 node_id + case_name), "concurrent_force" (并发内力, 需 ids + case_name), "elastic_link_force" (弹性连接内力, 需 ids), "constraint_equation_force" (约束方程内力, 需 ids), "cable_element_length" (索单元无应力长度, 需 ids) ids: Element/link IDs (单元/连接编号) case_name: Load case name (荷载工况名) node_id: Node ID for concurrent reactions (并发反力节点号) mode: Mode number for modal results (振型阶数) stage_id: Construction stage (施工阶段号, -1=运营) result_kind: Result kind flag (结果种类) envelop_type: Envelope type (包络类型) increment_type: Increment type (增量类型) limit: Max items per page (单页条数上限) offset: Pagination offset (翻页偏移)

Get tendon geometry and prestress loss results (获取钢束信息与损失结果). Args: tendon_name: Specific tendon name, or empty string for all tendons (钢束名称，空字符串则返回所有钢束)

Get all tendon length results (获取所有钢束长度结果).

Get tendon prestress loss results (获取预应力损失结果). Args: name: Tendon name (钢束名) stage_id: Construction stage ID (施工阶段编号)

Get tendon position/coordinate results (获取钢束坐标结果). Args: name: Tendon name (钢束名)

Initialize a new empty model (初始化全新模型). WARNING: This will CLEAR the current model data in the active bridge software! (警告：此操作将清空桥通软件中的当前模型！) Use this ONLY when starting a brand new project, NOT when modifying an existing one. (仅在从零开始新建桥梁时使用，修改现有模型时绝对不要调用此工具) CRITICAL LLM INSTRUCTION: Do NOT call this tool autonomously to fix your own mistakes. You MUST explicitly ask the USER for permission before calling this tool. (严重的指令：大模型绝对不可为了修复自己的建型错误而自行调用此工具清空模型！必须先向用户询问并获得许可！) Args: confirm: Must be set to true to execute (必须设为true以确认操作)

List members of a structure/boundary/load group (查看分组的成员信息). Args: group_type: Type of group (分组类型): 'structure', 'boundary', 'load' name: Group name (分组名称)

Discover qtmodel API methods and their real signatures (检索 qtmodel API 方法及签名). Use this to find long-tail methods NOT covered by the curated tools, then invoke them with call_qtmodel_api. ALWAYS discover the real signature here before calling — do not guess parameter names. （先用本工具查到真实签名，再用 call_qtmodel_api 调用，切勿臆测参数名。） Args: api_object: Which database to inspect (数据库对象): "mdb" (建模), "odb" (结果/查询), "cdb" (检算) pattern: Case-insensitive substring filter on method name (方法名关键字过滤，如 "tendon"、"spectrum")

Open or save a concrete check case file (打开或保存混凝土检算工况文件). Args: action: "open" (打开) or "save" (保存) name: Check case name; for "open", resolves to the default check data directory when file_path is empty (工况名称) file_path: Full path to the case file. For "open" it takes priority over name; for "save" a non-empty value means save-as (工况文件完整路径；保存时非空表示另存为)

Update or remove a stirrup definition (修改或删除检算箍筋定义). Use add_check_stirrup to create one. Lengths are in METERS (SI), converted internally. 新增请用 add_check_stirrup；长度入参为米，内部换算。 Args: action: "update" (修改) or "remove" (删除) stirrup_id: Stirrup definition ID (箍筋定义编号); <=0 means match by name name: Stirrup definition name (箍筋定义名称) stirrup_type: 1=普通箍筋 (normal), 2=螺旋式箍筋 (spiral) material_id: Rebar material ID (钢筋材料号) limbs_number: Limbs, for normal stirrups (普通箍筋肢数) loops_number: Loops, for spiral stirrups (螺旋式箍筋环数) diameter: Stirrup diameter in meters (箍筋直径, 单位 m) spacing: Stirrup spacing in meters (箍筋间距, 单位 m) core_diameter: Spiral core diameter in meters (螺旋箍筋核心直径, 单位 m)

Merge nodes that are at (nearly) the same coordinates (合并重合节点). This is equivalent to the "Merge Nodes" operation in the GUI. Useful after building a model to remove accidental duplicate nodes. 相当于界面上的"合并节点"功能，用于消除重叠节点。 Args: ids: Node ID(s) to check. Supports int, list, or range string. Leave empty to check ALL nodes. (节点编号，留空则检查全部节点) tolerance: Merge distance tolerance in model units, default 0.0001m (合并容许误差，默认 0.0001m) Example: merge_nodes() # Merge all overlapping nodes in the model

Merge all construction stages into a final operation stage (合并为运营阶段). This finalizes the construction stage analysis by creating an operation stage that accumulates all previous stage results. 通过合并所有施工阶段创建运营阶段，作为施工阶段分析的最终状态。 Args: name: Name for the merged operation stage (运营阶段名称)

Move nodes by an offset (平移节点). Args: ids: Node ID(s) to move. Supports int, list, or range string '1to10'. (节点编号，支持整数、列表或范围字符串) offset_x: X-direction offset in model units (X方向偏移量) offset_y: Y-direction offset in model units (Y方向偏移量) offset_z: Z-direction offset in model units (Z方向偏移量) Example: move_nodes("1to10", offset_z=-0.5) # Move nodes 1-10 down by 0.5m

Open an existing model file (打开模型文件). Args: file_path: Absolute or relative path to the .qtb file (要打开的文件路径)

Generate an analysis result contour plot (生成分析结果云图). By default returns the plot image itself for direct viewing. 默认直接返回云图图像内容，可在客户端预览。 Args: result_type: Result type (结果类型): 'displacement'(位移), 'reaction'(反力), 'beam_force'(梁内力), 'beam_stress'(梁应力), 'truss_force'(杆内力), 'truss_stress'(杆应力), 'plate_force'(板内力), 'plate_stress'(板应力), 'modal'(振型) stage_id: Construction stage ID (施工阶段ID): -1=operation(运营), 0=envelope(包络), n=stage n (第n阶段) case_name: Load case name for operation stage (运营阶段荷载工况名) component: Result component to display (显示分量), e.g. 'uy'(竖向位移), 'mz'(弯矩), 'fx'(轴力), 'sz'(正应力) Leave empty to use default component. file_path: Output file path (.png). Empty = default directory. 输出路径，为空则保存到默认目录 return_image: Return the PNG as viewable image content; if False, return only the saved path (是否直接返回图像内容，否则仅返回路径)

Remove a specific boundary condition (删除指定边界条件). Args: remove_id: Node or element ID to remove boundary from (节点号/单元号/从节点号，取决于边界类型) kind: Boundary type to remove (边界类型), English token or Chinese: "support" (一般支承), "elastic_support" (弹性支承), "general_elastic_support" (一般弹性支承), "elastic_link" (一般弹性连接), "tension_elastic_link" (受拉弹性连接), "compression_elastic_link" (受压弹性连接), "rigid_elastic_link" (刚性弹性连接), "master_slave" (主从约束), "beam_constraint" (梁端约束), "constraint_equation" (约束方程) group_name: Boundary group name (边界组名) extra_name: Extra identifier (额外标识): for elastic links: "I" or "J" end (弹性连接时为I/J端); for constraint equations: the equation name (约束方程时为方程名)

Remove a construction stage (删除施工阶段). Args: name: Name of the stage to remove. If empty, removes all stages. (要删除的施工阶段名称。如果为空，则删除所有施工阶段)

Delete elements from the model (删除单元). Args: ids: Element ID(s) to delete. Supports int, list, or range string '1to10'. Leave empty to delete ALL elements. (单元编号，留空则删除全部单元) remove_free_nodes: Also delete nodes that become free after element deletion (是否同时删除孤立节点，默认不删除) confirm_delete_all: MUST be set to true if ids is empty (deleting all elements). (如果要删除所有单元，必须设为 true) CRITICAL LLM INSTRUCTION: Do NOT delete all elements autonomously to fix your own mistakes. You MUST explicitly ask the USER for permission before calling this tool with empty ids. (大模型绝对不可为了修复自己的错误而自行清空所有单元！必须先向用户询问并获得许可！) Example: remove_elements(ids="11to20")

Remove nodes and/or elements from an existing structure group (从结构组中移除节点和/或单元). Args: group_name: Name of the structure group (结构组名称) node_ids: Node ID(s) to remove. Supports int, list, or range string. (要移除的节点编号) element_ids: Element ID(s) to remove. Supports int, list, or range string. (要移除的单元编号)

Delete nodes from the model (删除节点). Args: ids: Node ID(s) to delete. Supports int, list, or range string '1to10'. Leave empty to delete ALL nodes. (节点编号，留空则删除全部节点) confirm_delete_all: MUST be set to true if ids is empty (deleting all nodes). (如果要删除所有节点，必须设为 true) CRITICAL LLM INSTRUCTION: Do NOT delete all nodes autonomously to fix your own mistakes. You MUST explicitly ask the USER for permission before calling this tool with empty ids. (大模型绝对不可为了修复自己的错误而自行清空所有节点！必须先向用户询问并获得许可！) Example: remove_nodes(ids=[5, 6, 7]) # Delete specific nodes

Delete one or more sections from the model (删除截面). Args: ids: Section ID(s) to delete. Supports int, list, or range string '3to5'. (截面编号，支持整数、列表或范围字符串)

Remove a structure group (删除结构组). If no name is provided, removes all structure groups. Args: name: Name of the structure group to remove, leave empty to remove all (待删除的结构组名称，不填则删除全部)