StructurePlot

StructurePlot วาดโครงสร้างทั้งหมดให้พอดีกับความกว้างของกล่องที่อยู่ ทั้งชิ้นส่วน จุดหมุน จุดรองรับ แรงกระทำ แรงปฏิกิริยา แผนภาพ N, V และ M และรูปร่างที่เสียรูป ส่งตัวคำนวณ หรือ โมเดลข้อมูลธรรมดา ที่สร้างจากตัวคำนวณให้ แล้วบอกว่าจะวาดอะไร

Vue
<StructurePlot :solver="solver" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />

props ทุกตัวพร้อมชนิดและค่าเริ่มต้นอยู่ในหน้า API ของคอมโพเนนต์

ภาพนี้คือ StructurePlot ที่เปิด nodeLabels และ dimensions ตั้ง hover ไว้ และใช้รูปแบบตัวเลขของเว็บไซต์นี้ซึ่งแสดงเลขนัยสำคัญสี่หลัก ลองสลับดูผลลัพธ์แต่ละอย่าง และชี้ที่ชิ้นส่วนเพื่ออ่านค่า

โครงข้อแข็งพอร์ทัล: ฐานเสาเป็นหมุด แรง 10 kN/m บนคาน และ 15 kN ที่ B9.231−50.7729.236 m4 m15 kNq = 10 kN/m2.3082012.6940ABCD
โครงข้อแข็งพอร์ทัล: ฐานเสาเป็นหมุด แรง 10 kN/m บนคาน และ 15 kN ที่ Bเปิดใน EduBeam

เลเยอร์

ภาพประกอบด้วยเลเยอร์ ซึ่งวาดตามลำดับที่กำหนดไว้ตายตัว ไม่ว่าจะระบุไว้ในลำดับใด

เลเยอร์วาด
membersชิ้นส่วน โดยแสดงจุดหมุนเป็นวงกลมเล็ก ๆ
supportsสัญลักษณ์ของจุดรองรับทุกจุด โดยหมุนตามมุมสำหรับจุดรองรับแบบเอียง
loadsแรงกระทำที่โหนดและบนชิ้นส่วน อุณหภูมิ และการทรุดตัวของจุดรองรับ พร้อมค่า
reactionsแรงปฏิกิริยาเป็นลูกศรตรงและลูกศรโค้งพร้อมค่า หรือเมื่อใช้ reactionLabels: 'names' จะวาดเป็น ตัวไม่ทราบค่าที่มีชื่อกำกับ แบบในโจทย์
nodesโหนดทุกโหนดเป็นวงกลมเล็ก ๆ
nodeLabelsชื่อโหนด
dimensionsเส้นบอกขนาดต่อเนื่องแบบในโจทย์แบบฝึกหัด: ระยะทุกช่วงระหว่างโหนดและแรงกระทำเป็นจุดอยู่ใต้โครงสร้าง ความสูงแต่ละชั้นอยู่ทางขวา และขนาดรวมอยู่ในบรรทัดที่สอง
N, V, Mแผนภาพแรงตามแนวแกน แรงเฉือน และโมเมนต์ดัด
wรูปร่างที่เสียรูป

ถ้าไม่ระบุ layers ภาพจะวาดชิ้นส่วน จุดรองรับ แรงกระทำ และแรงปฏิกิริยา บวกผลลัพธ์หนึ่งอย่างที่เลือกตามชนิดของโครงสร้าง: M สำหรับคานและโครงข้อแข็ง N สำหรับโครงถัก และ w เมื่อไม่มีชิ้นส่วนใดรับแรงเลย เช่น คานที่ขยายตัวได้อิสระภายใต้แรงกระทำเนื่องจากอุณหภูมิ

แผนภาพเป็นแบบเดียวกับในแอป EduBeam: N และ V แรเงาด้วยเส้นขวางชิ้นส่วน และ M วาดไว้ทางด้านรับแรงดึง โมเมนต์บวกของคานจึงอยู่ใต้คาน ถ้าใส่ :moment-on-tension-side="false" จะวาด M ทางด้านรับแรงอัดแทน สำหรับโครงถัก แรงในชิ้นส่วนแต่ละชิ้นแสดงเพียงครั้งเดียว เขียนไปตามชิ้นส่วนและใช้สีตามเครื่องหมาย

ภาพที่ค่อย ๆ ประกอบขึ้น

reserve ระบุเลเยอร์ที่ต้องเว้นที่ไว้ขณะยังซ่อนอยู่ ภาพจะจัดวางเลเยอร์ที่จองไว้ทั้งหมดตั้งแต่แรก เมื่อเปิดเลเยอร์ใด เลเยอร์นั้นจะค่อย ๆ ปรากฏขึ้นในตำแหน่งที่ควรอยู่ โดยส่วนอื่นไม่ขยับเลย

Vue
<script setup lang="ts">
import type { PlotLayer } from '@edubeam/plot'

const stages: PlotLayer[][] = [
  ['nodes', 'nodeLabels', 'dimensions'],
  ['nodeLabels', 'members', 'supports'],
  ['nodeLabels', 'members', 'supports', 'loads'],
  ['members', 'supports', 'loads', 'reactions'],
  ['members', 'supports', 'reactions', 'M'],
]
const all = [...new Set(stages.flat())]
// `frame` คือตัวคำนวณที่คำนวณแล้ว และ `step` คือขั้นปัจจุบัน คอมโพเนนต์ฉบับเต็มอยู่ในหน้าสไลด์และเอกสารประกอบการสอน
</script>

<template>
  <StructurePlot :solver="frame" :layers="stages[step]" :reserve="all" />
</template>

เมื่อเปิด animate ซึ่งเปิดไว้เป็นค่าเริ่มต้น เลเยอร์จะค่อย ๆ ปรากฏ และเส้นของชิ้นส่วนจะค่อย ๆ ลากจากปลายหนึ่งไปอีกปลาย ภายใต้ prefers-reduced-motion จะไม่มีภาพเคลื่อนไหวเลย หน้า สไลด์และเอกสารประกอบการสอน นำภาพนี้ไปใส่ในชุดสไลด์

ค่าในแผนภาพ

ค่าแต่ละค่าเขียนไว้ถัดจากปลายของออร์ดิเนต (ordinate: ระยะที่วัดตั้งฉากจากแกนชิ้นส่วนถึงเส้นแผนภาพ) ที่ค่านั้นกำกับ แบบเดียวกับที่ตำรากำกับค่าในแผนภาพ ได้แก่ ปลายชิ้นส่วนทุกปลายที่ค่าไม่เป็นศูนย์ ค่าสุดขีดระหว่างปลาย ค่าทั้งสองค่าที่ตำแหน่งที่แผนภาพกระโดด และค่าที่มุมโครงแบบแข็งเกร็งเพียงครั้งเดียว ค่าเหล่านี้เป็นตัวเลขเปล่าในหน่วยที่แสดงผล (kN สำหรับ N และ V, kNm สำหรับ M) และแรงปฏิกิริยาก็เช่นกัน เหมือนในแอป EduBeam หน่วยเขียนกำกับเฉพาะค่าที่โจทย์กำหนดให้ ได้แก่ แรงกระทำ การทรุดตัวของจุดรองรับ และการเปลี่ยนแปลงอุณหภูมิ

ป้ายค่าที่จะทับป้ายอื่น ชิ้นส่วน หรือลูกศร จะลองตำแหน่งอื่นที่ปลายเดียวกัน และถ้าไม่มีที่ว่างเลยก็จะไม่แสดง ตัวเลขสองตัวจึงไม่มีวันวางทับกัน ค่าของแรงกระทำและแรงปฏิกิริยาวางก่อน ตัวเลขของแผนภาพจึงไม่ดันค่าเหล่านี้ออกไป แต่แรงในชิ้นส่วนโครงถักแสดงเสมอ ป้ายจะเลื่อนไปตามชิ้นส่วน สลับข้าง และถ้าจำเป็นจริง ๆ ก็ย่อขนาดลง

result-label-mode="axis" หมุนค่าให้เขียนไปตามแนวออร์ดิเนต แบบที่แอป EduBeam เขียน ถ้าผู้อ่านสลับระหว่างสองแบบได้ ให้ใส่ :reserve-label-modes="['horizontal', 'axis']" ภาพจะได้ไม่ขยับเมื่อสลับ

แรงปฏิกิริยาเป็นตัวไม่ทราบค่า

โจทย์แบบฝึกหัดถามหาแรงปฏิกิริยา จึงควรแสดงแรงปฏิกิริยาโดยไม่บอกค่า reaction-labels="names" วาดลูกศรในทุกทิศทางที่จุดรองรับยึดไว้ โดยชี้ไปทางที่นับเป็นบวก ได้แก่ ตามแกน x ของโหนด (ไปทางขวา ถ้าจุดรองรับไม่ได้เอียง) ชี้ขึ้น และทวนเข็มนาฬิกาสำหรับโมเมนต์ที่จุดรองรับแบบยึดแน่น ลูกศรแต่ละอันตั้งชื่อตามโหนด เช่น Ax, Az, MA เป็นตัวเอียงและมีตัวห้อยจริง เครื่องหมายของคำตอบทุกค่าจึงกำหนดไว้บนรูป แรงปฏิกิริยาที่กระทำในทิศตรงข้ามมีค่าเป็นลบ

Vue
<StructurePlot
  :model="model"
  :layers="['members', 'supports', 'loads', 'reactions', 'nodeLabels', 'dimensions']"
  reaction-labels="names"
/>

ด้านบน คานปลายยึดแน่น–ปลายรองรับธรรมดาในรูปแบบโจทย์: ยึดแน่นที่ A ล้อเลื่อนที่ B แรง 40 kN ที่กึ่งกลางช่วง เส้นบอกขนาดต่อเนื่อง 3 m และ 3 m รวม 6 m และแรงปฏิกิริยาวาดเป็นลูกศรที่มีชื่อ A_x, A_z, M_A และ B_z ด้านล่าง คานเดียวกันที่ใช้ป้ายแรงปฏิกิริยาแบบค่าเริ่มต้น: 27.5 และ 12.5 ชี้ขึ้น โมเมนต์ที่จุดยึดแน่น 45 และโมเมนต์ดัดตั้งแต่ −45 ที่ผนังถึง 37.5 ใต้แรงกระทำ

ชื่อไม่ต้องอาศัยผลลัพธ์ โมเดลที่ยังไม่ได้คำนวณจึงวาดเป็นโจทย์ได้ สำหรับเฉลย ให้ปล่อย reactionLabels เป็น 'values' ชื่อกับค่าใช้พื้นที่ต่างกัน (แรงปฏิกิริยาแนวนอนที่เป็นศูนย์มีชื่ออยู่ในโจทย์ แต่ไม่มีลูกศรในเฉลย) ภาพที่สลับไปมาระหว่างสองแบบจึงควรเว้นที่ให้ทั้งคู่ด้วย :reserve-reaction-labels="['names', 'values']" แล้วภาพจะอยู่กับที่ มีแต่ป้ายที่เปลี่ยน การ์ดโจทย์ในหน้า โจทย์และข้อสอบ สลับระหว่างสองแบบด้วย prop answers เหมือนที่หน้า ฝึกทำโจทย์ ของเว็บไซต์นี้ทำเมื่อนักศึกษาขอดูเฉลย

ภาพย่อ

compact วาดสำหรับช่องขนาดราว 400 × 200 px: สัญลักษณ์เล็กลง ข้อความขนาด 11.5 px ค่าไม่เกินสองค่าต่อชิ้นส่วน และแรงแผ่กระจายกำกับด้วยขนาดของแรงเพียงอย่างเดียว ไม่มี q =

Vue
<StructurePlot v-for="t in tiles" :key="t.title" :solver="t.solver" compact :height="200" :title="t.title" />

ภาพในหน้า ตัวอย่าง ของเว็บไซต์นี้วาดด้วยวิธีนี้

ขนาด

ภาพวัดขนาดกล่องที่อยู่แล้วจัดวางตามความกว้างนั้นเป็นพิกเซลจริง ถ้าไม่ระบุ height ความสูงจะเป็นไปตามภาพที่วาด แต่ไม่เกิน maxHeight ซึ่งมีค่าเริ่มต้นเป็น ก่อนที่จะวัดได้ เช่น ตอนเรนเดอร์บนเซิร์ฟเวอร์ ภาพจะใช้ width ซึ่งมีค่าเริ่มต้นเป็น 640 px

Propค่าเริ่มต้นกำหนด
width640, compact 400ความกว้างที่ใช้จัดวางจนกว่าจะวัดกล่องได้, px
heightfollows the drawingความสูงคงที่, px
maxHeight, compact noneขีดจำกัดบนของความสูงอัตโนมัติ
padding6ระยะว่างรอบภาพ, px
fontSize13, compact 11.5ขนาดตัวอักษร, px
diagramSize48, compact 26ความยาวของออร์ดิเนตที่ยาวที่สุด, px
deformedSize30, compact 18การกระจัดที่มากที่สุดของรูปร่างที่เสียรูป, px

หลายภาพในมาตราส่วนเดียวกัน

แต่ละภาพปรับขนาดแผนภาพตามค่าที่มากที่สุดของตัวเอง โมเมนต์ 20 kNm จึงดูใหญ่เท่ากับ 80 kNm ถ้าต้องการเปรียบเทียบ ให้กำหนดมาตราส่วนเป็นพิกเซลต่อหน่วย SI ด้วย diagramScale

Vue
<script setup lang="ts">
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams' // จากหน้าเริ่มต้นใช้งาน: (span m, q kN/m) => ตัวคำนวณที่คำนวณแล้ว

const spans = [4, 6, 8].map((L) => ({ L, solver: simpleBeam(L, 10) }))
// 0.5 px ต่อ kNm (0.5e-3 px ต่อ N·m): 80 kNm ของช่วง 8 m วาดลึก 40 px ส่วน 20 kNm ของช่วง 4 m วาดลึก 10 px
const scale = { M: 0.5e-3 }
</script>

<template>
  <figure v-for="s in spans" :key="s.L">
    <StructurePlot :solver="s.solver" :layers="['members', 'supports', 'M']" :diagram-scale="scale" />
    <figcaption>L = {{ s.L }} m</figcaption>
  </figure>
</template>

หน่วยและตัวเลข

ภายในไลบรารีเก็บค่าเป็นหน่วย SI และแปลงหน่วยเฉพาะตอนแสดงผล ค่าเริ่มต้นคือ kN, kNm, kN/m, m, mm, mrad และ K เปลี่ยนหน่วยใดก็ได้ด้วยสัญลักษณ์และตัวคูณ โดยค่าที่แสดง = ค่า SI × scale

Vue
<StructurePlot :solver="solver" :units="{ force: { symbol: 'N', scale: 1 } }" />

ตัวเลขทุกตัวจัดรูปแบบด้วย Intl.NumberFormat ค่าเริ่มต้นเป็นรูปแบบภาษาอังกฤษที่มีทศนิยมไม่เกินหนึ่งตำแหน่ง ส่งรูปแบบของคุณเองเข้าไปให้ตรงกับภาษาของหน้าเว็บ

Vue
<StructurePlot :solver="solver" :number-format="new Intl.NumberFormat('cs', { maximumFractionDigits: 2 })" />

เครื่องหมายลบเป็นเครื่องหมายลบจริง (−) และค่าที่ปัดแล้วเป็นศูนย์จะไม่แสดงเป็น −0 ชื่อหน่วยมี force, moment, distributed, length, displacement, rotation และ temperature ไลบรารี export KN_UNITS และ SI_UNITS ไว้เป็นจุดตั้งต้น

การอ่านค่า

เมื่อเปิด hover ภาพจะอ่านผลลัพธ์ที่แสดงอยู่ ณ จุดบนชิ้นส่วนที่อยู่ใต้ตัวชี้ (pointer) และทำเครื่องหมายค่าแต่ละค่าไว้ตรงที่วาด ได้แก่ จุดที่ปลายออร์ดิเนตของแผนภาพที่แสดงอยู่ (ทั้งสองปลายตรงตำแหน่งที่แผนภาพกระโดด) หรือบนรูปร่างที่เสียรูป และแสดงค่าในป้าย เช่น M = 54 kNm หรือทั้งสองข้างของตำแหน่งที่กระโดด V = 13.3 → −6.7 kN ตัวชี้จับชิ้นส่วนได้จากทุกตำแหน่งบนแผนภาพของชิ้นส่วนนั้น ไม่ใช่เฉพาะบนตัวชิ้นส่วน ภาพยังส่งค่าออกมาเป็นข้อมูลผ่านอีเวนต์ด้วย

Vue
<script setup lang="ts">
import { ref } from 'vue'
import { StructurePlot, type Readout } from '@edubeam/plot'
import { portalFrame } from './frame' // จากหน้าสไลด์และเอกสารประกอบการสอน: () => ตัวคำนวณที่คำนวณแล้ว

const frame = portalFrame()
const reading = ref<Readout | null>(null)
</script>

<template>
  <StructurePlot :solver="frame" :layers="['members', 'supports', 'M']" hover @readout="reading = $event" />
  <p v-if="reading">
    Member {{ reading.member }}, {{ reading.x.toFixed(2) }} m from its start:
    M = {{ (reading.values.M.left / 1e3).toFixed(1) }} kNm
  </p>
</template>

ค่าที่อ่านได้ (readout) คือ { member, x, px, py, values, u } ได้แก่ ชิ้นส่วน ตำแหน่งตามชิ้นส่วนเป็นเมตร จุดบนหน้าจอเป็น px ค่า { left, right } ของ N, V, M และ w แต่ละตัวในหน่วย SI และการกระจัดตามแนวแกน u เมื่อตัวชี้ออกจากภาพ ค่าจะเป็น null ภาพที่โต้ตอบได้ในเว็บไซต์นี้ใช้ hover ลองชี้ที่ภาพใดภาพหนึ่งดู

ถ้าไม่เปิด hover ภาพจะไม่ติด event listener ใด ๆ เลย หน้าเว็บจึงเลื่อนผ่านภาพได้ตามปกติ และการแตะภาพที่อยู่ในลิงก์จะเปิดลิงก์นั้น เมื่อเปิด hover ภาพจะฟังเฉพาะ pointer event และยังให้เลื่อนในแนวดิ่งและจีบนิ้วซูมบนหน้าจอสัมผัสได้

การเข้าถึง

ภาพแต่ละภาพเป็น <svg role="img"> ที่ตั้งชื่อตาม prop title หรือตามคำบรรยายสิ่งที่แสดง เช่น “Structure with its loads, reactions, bending moment” เลเยอร์ที่จองไว้แต่ซ่อนอยู่เป็น aria-hidden