CATIA V5×Codexでテトラポッドを作る①
前回はCodexが作成したマクロを使い、CATIA V5で4穴プレートを作りましたが今回は、テトラポッドの基準になる正四面体を作り、辺の長さと重心を確認してみます。
正四面体の生成に加え、辺長を90 mmから95 mmへ変更し、6辺と体積、重心が追従することを確認しました。保存したCATPartを開き直した後も、同じ結果が得られています。
「その①」では、この基準形状までを扱います。4本の脚の作成は次の段階です。
辺長90 mmの正四面体。面の接合とクローズドサーフェスでソリッド化
正四面体と重心の作成工程
1.4穴プレートの次は、立体の基準と重心
4穴プレートでは、幅を変えたときに穴中心の端距離を保てるかを調べました。今回は、辺長という1つのパラメーターから、立体全体がどのように更新されるかを確かめます。
確認項目は、6辺が等しいこと、体積が理論値と一致すること、重心が正しい位置にあることです。これらを確認しておけば、次に重心から4頂点へ向かう方向を、脚の配置に使えます。
使用環境はCATIA PLM Express V5-6R2023です。Codexがコードを作成し、Windows PowerShellからCATIAのAutomation APIを通じて実行しました。
2.参考チュートリアルと、今回の作り方
参考にしたのは、3D楽の「テトラポッドを作ってみよう その1:正四面体」です。続く「その2」では、この基準を使って脚を配置していきます。
今回は、元記事の目的を数式とAPIで実装しました。元記事のスケッチ操作を、順番どおりに自動操作した実験ではありません。
| 項目 | 元チュートリアルの考え方 | 今回の実装 |
|---|---|---|
| 頂点の配置 | 平面図と側面図のスケッチ、寸法の参照 | 辺長から座標を数式で設定 |
| 三角面 | フィルと円形パターン | 4面を個別にフィルで作成 |
| ソリッド化 | 接合とクローズドサーフェス | 底面を含む4面を接合してソリッド化 |
| 重心 | 慣性測定から重心点を作成 | 理論式の参照点を置き、実ソリッドの重心を別に測定 |
今回確かめるのは、この構成で正しい基準形状ができ、辺長変更にも追従するかという点です。
3.辺長から4頂点と重心の位置を決める
底面をXY平面上に置き、底面の正三角形の中心を原点とします。辺長をLとすると、今回の4頂点は次の座標です。単位はmmです。
| 頂点 | X | Y | Z |
|---|---|---|---|
| A | −L/2 | −L/(2√3) | 0 |
| B | L/2 | −L/(2√3) | 0 |
| C | 0 | L/√3 | 0 |
| D | 0 | 0 | L√(2/3) |
モデルには、辺長を管理する名前付きパラメーターEdgeLengthを作成しました。頂点の座標をこのパラメーターの式に結び付けています。
理論上の高さと体積、重心位置は次の式で求められます。
高さ h = L × √(2/3)
体積 V = L³ / (6√2)
重心 G = (0, 0, h/4)
重心の高さh/4は、底面から測った位置です。頂点Dから測った距離と混同しないようにします。
今回の座標系の概念図。重心Gは底面から高さhの1/4の位置にあります。
4.6本の直線から面を作り、ソリッド化する
4頂点を6本の直線で結び、各三角形の境界を作成します。それぞれをフィルで面にし、4面を接合してからクローズドサーフェスでソリッドにしました。
処理の流れは、次のとおりです。
4頂点を結ぶ6本の直線。辺長パラメーターに連動する頂点を基準に作成
- 新規PartとEdgeLengthを作成
- 数式に連動する4頂点を作成
- 6本の辺を作成
- 底面を含む4枚の三角面を作成
- 面を接合してソリッド化
- 重心の参照点CentroidReferenceを配置
- 実際のソリッドを測定して結果を保存
今回のモデル作成コードは初版で実行できました。ただし、これは今回のコード1件の結果です。
実行にはCATIA.SystemService.Evaluateを使用しました。Tetrahedron.CATScriptの先頭の言語宣言を除いたモデル作成コードを渡しています。CATIAのマクロ画面から、このCATScriptを直接実行する経路はまだ確認していません。
5.6辺・体積・重心を照合する
見た目だけで判断せず、CATIAから辺の長さと実ソリッドの体積・重心を取得しました。
辺長90 mmの正四面体では、6辺はすべて90 mmとなり、体積は約85,913.473914 mm³でした。測定した重心は、X・Yが数値誤差の範囲で0、Zが約18.371173 mmです。いずれも理論値と一致しました。
| 辺長 | 6辺の実測 | 体積 mm³ | 重心Z mm |
|---|---|---|---|
| 90 mm | すべて90 mm | 85,913.473914 | 18.371173 |
| 95 mm | すべて95 mm | 101,042.612753 | 19.391794 |
CentroidReferenceは、理論式で配置した点です。その点を置いただけで「重心が正しい」と判断せず、CATIAのSPAWorkbenchで取得した実ソリッドの重心と理論値を照合しました。
6.辺長を90→95 mmへ変更し、保存後にも確認
寸法変更では、既存モデルのEdgeLengthをAPIから90 mmから95 mmへ変更して更新しました。コードを書き直して新しいモデルを生成したわけではありません。
変更後も6辺は等しく、体積と重心は新しい辺長から計算した理論値と一致しました。90 mmと95 mmのモデルをそれぞれ保存し、いったん閉じてから開き直して再測定しています。
辺長95 mmの状態をCATIAで表示。
保存後の検査では、辺長・重心の差0.001 mm未満、体積差0.001 mm³未満を今回の判定基準としました。これは実験の照合基準であり、製造公差ではありません。
7.今回はここまで。次は4本の脚へ
今回確認できたのは、正四面体の生成、理論値との照合、既存モデルの辺長変更、保存・再読込です。
8.今回のモデル作成コードと実行方法
今回の実験で使用したコードです。辺長に連動する4頂点から6本の稜線と4枚の三角面を作り、面を結合してソリッド化します。重心の参照点も数式で配置します。テトラポッドの4本の脚は含みません。
検証環境はCATIA PLM Express V5-6R2023です。確認した実行経路は、Windows PowerShellからCATIAのSystemService.Evaluateを呼び出す方法です。CATIAのマクロ画面からCATScriptを直接再生する方法は未検証です。
実行前の準備
- CATIAを起動し、作業中のファイルを保存します。
- 下記の2つのコードを、それぞれTetrahedron.CATScriptとRun-Pilot.ps1という名前で同じフォルダーに保存します。拡張子が.txtにならないよう確認してください。掲載コードは英数字のみです。
- そのフォルダーでWindows PowerShellを開き、次のコマンドを実行します。PowerShell 7ではなく、Windows PowerShell 5.1を使用します。
|
1 |
powershell.exe -NoProfile -File ".\Run-Pilot.ps1" |
新しいPartを作成し、辺長90 mmと95 mmの測定・保存を行います。同じフォルダーにrun-日時という出力フォルダーが作られ、CATPartとverification.jsonが保存されます。最後に辺長90 mmの基準モデルを保存します。処理中はCATIAで別の操作を行わないでください。
モデル作成コード:Tetrahedron.CATScript
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 |
Language="VBSCRIPT" ' Pilot: mathematical reference geometry, not an exact replay of tutorial sketches. ' Surface Fill -> Join -> CloseSurface; all coordinates depend on EdgeLength. Sub CATMain() Dim doc, part, factory, hb, edgeLength, pts(3), edges(5), faces(3) Dim a, b, i, p, formula, join, solid, center Set doc = CATIA.Documents.Add("Part") Set part = doc.Part Set factory = part.HybridShapeFactory Set hb = part.HybridBodies.Add() hb.Name = "TetraReference" Set edgeLength = part.Parameters.CreateDimension("EdgeLength", "LENGTH", 0) edgeLength.ValuateFromString "90mm" Set pts(0) = MakePoint(part, factory, hb, "VertexA", -45, -90 / (2*Sqr(3)), 0, "-EdgeLength / 2", "-EdgeLength / (2 * sqrt(3))", "") Set pts(1) = MakePoint(part, factory, hb, "VertexB", 45, -90 / (2*Sqr(3)), 0, "EdgeLength / 2", "-EdgeLength / (2 * sqrt(3))", "") Set pts(2) = MakePoint(part, factory, hb, "VertexC", 0, 90 / Sqr(3), 0, "", "EdgeLength / sqrt(3)", "") Set pts(3) = MakePoint(part, factory, hb, "VertexD", 0, 0, 90*Sqr(2/3), "", "", "EdgeLength * sqrt(2.0 / 3.0)") a = Array(0, 1, 2, 0, 1, 2) b = Array(1, 2, 0, 3, 3, 3) For i = 0 To 5 Set edges(i) = factory.AddNewLinePtPt(part.CreateReferenceFromObject(pts(a(i))), part.CreateReferenceFromObject(pts(b(i)))) edges(i).Name = "Edge" & CStr(i+1) hb.AppendHybridShape edges(i) Next Set faces(0) = MakeFace(part, factory, hb, edges(0), edges(1), edges(2), "FaceABC") Set faces(1) = MakeFace(part, factory, hb, edges(0), edges(4), edges(3), "FaceABD") Set faces(2) = MakeFace(part, factory, hb, edges(1), edges(5), edges(4), "FaceBCD") Set faces(3) = MakeFace(part, factory, hb, edges(2), edges(3), edges(5), "FaceCAD") part.Update Set join = factory.AddNewJoin(part.CreateReferenceFromObject(faces(0)), part.CreateReferenceFromObject(faces(1))) join.AddElement part.CreateReferenceFromObject(faces(2)) join.AddElement part.CreateReferenceFromObject(faces(3)) join.Name = "TetraSkin" hb.AppendHybridShape join part.Update part.InWorkObject = part.MainBody Set solid = part.ShapeFactory.AddNewCloseSurface(part.CreateReferenceFromObject(join)) solid.Name = "TetraSolid" part.Update Set center = MakePoint(part, factory, hb, "CentroidReference", 0, 0, 90*Sqr(2/3)/4, "", "", "EdgeLength * sqrt(2.0 / 3.0) / 4") For i = 0 To 5 factory.GSMVisibility part.CreateReferenceFromObject(edges(i)), 0 Next For i = 0 To 3 factory.GSMVisibility part.CreateReferenceFromObject(faces(i)), 0 Next factory.GSMVisibility part.CreateReferenceFromObject(join), 0 part.InWorkObject = solid part.Update CATIA.ActiveWindow.ActiveViewer.Reframe End Sub Function MakePoint(part, factory, hb, label, x, y, z, fx, fy, fz) Dim point, relation Set point = factory.AddNewPointCoord(x,y,z) point.Name = label hb.AppendHybridShape point If fx <> "" Then Set relation = part.Relations.CreateFormula(label & "X", "", point.X, fx) If fy <> "" Then Set relation = part.Relations.CreateFormula(label & "Y", "", point.Y, fy) If fz <> "" Then Set relation = part.Relations.CreateFormula(label & "Z", "", point.Z, fz) Set MakePoint = point End Function Function MakeFace(part, factory, hb, e1, e2, e3, label) Dim fill Set fill = factory.AddNewFill() fill.AddBound part.CreateReferenceFromObject(e1) fill.AddBound part.CreateReferenceFromObject(e2) fill.AddBound part.CreateReferenceFromObject(e3) fill.Name = label hb.AppendHybridShape fill Set MakeFace = fill End Function Function InspectTetra() Dim doc, part, hb, spa, lengths(5), i, measurement, xyz(2) Set doc = CATIA.ActiveDocument Set part = doc.Part Set hb = part.HybridBodies.Item("TetraReference") Set spa = doc.GetWorkbench("SPAWorkbench") For i = 0 To 5 Set measurement = spa.GetMeasurable(part.CreateReferenceFromObject(hb.HybridShapes.Item("Edge" & CStr(i+1)))) lengths(i) = measurement.Length Next Set measurement = spa.GetMeasurable(part.CreateReferenceFromObject(part.MainBody)) measurement.GetCOG xyz InspectTetra = Array(lengths(0),lengths(1),lengths(2),lengths(3),lengths(4),lengths(5),measurement.Volume,xyz(0),xyz(1),xyz(2)) End Function |
実行・測定・保存用:Run-Pilot.ps1
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
$ErrorActionPreference='Stop' $app=[Runtime.InteropServices.Marshal]::GetActiveObject('CATIA.Application') $source=[IO.File]::ReadAllText((Join-Path $PSScriptRoot 'Tetrahedron.CATScript')) $source=$source.Substring($source.IndexOf("`n")+1) $runDir=Join-Path $PSScriptRoot ('run-'+(Get-Date -Format 'yyyyMMdd-HHmmss-fff')) [IO.Directory]::CreateDirectory($runDir) | Out-Null [IO.File]::WriteAllText((Join-Path $runDir 'executed.vbs'),$source) try { $app.SystemService.Evaluate($source,0,'CATMain',@()) | Out-Null $doc=$app.ActiveDocument $part=$doc.Part $reports=@() foreach($size in @(90,95)){ $part.Parameters.Item('EdgeLength').ValuateFromString(($size.ToString()+'mm')) $part.Update() $values=@($app.SystemService.Evaluate($source,0,'InspectTetra',@())) $expectedVolume=[Math]::Pow($size,3)/(6*[Math]::Sqrt(2)) $expectedZ=$size*[Math]::Sqrt(2/3)/4 $report=[ordered]@{edgeLengthMm=$size;measuredEdgesRaw=@($values[0..5]);volumeMm3=([double]$values[6]*1e9);expectedVolumeMm3=$expectedVolume;measuredCentroidRaw=@($values[7..9]);expectedCentroidMm=@(0,0,$expectedZ)} $reports+=$report $doc.SaveAs((Join-Path $runDir ('tetra-'+$size+'.CATPart'))) if($size -eq 90){$app.ActiveWindow.ActiveViewer.CaptureToFile(4,(Join-Path $runDir 'tetra-90.bmp'))} } $reports | ConvertTo-Json -Depth 6 | Set-Content (Join-Path $runDir 'verification.json') -Encoding UTF8 $reports | ConvertTo-Json -Depth 6 $part.Parameters.Item('EdgeLength').ValuateFromString('90mm') $part.Update() $doc.SaveAs((Join-Path $runDir 'tetra-reference.CATPart')) Write-Output "Saved run: $runDir" }catch{ $_ | Out-String | Set-Content (Join-Path $runDir 'error.txt') -Encoding UTF8 Write-Output "Failed run: $runDir" throw } |
実行結果の読み方
verification.jsonのmeasuredEdgesRawは6本の稜線の長さ(mm)、volumeMm3は体積(mm³)、measuredCentroidRawは実ソリッドの重心座標(mm)です。辺長90 mmの体積は約85,913.473914 mm³、重心Zは約18.371173 mm、辺長95 mmでは約101,042.612753 mm³と約19.391794 mmになります。
CentroidReferenceは理論式で配置した参照点です。実ソリッドの重心はSPAWorkbenchで別に測定し、理論値と照合しています。この実行用コードはモデルを作って測定・保存するもので、保存後の再読込検証は別の検証処理で行いました。
PowerShellの実行ポリシーで停止した場合は、表示されたエラーと組織・PCの設定を確認してください。今回の予備実験1件で動作を確認したコードであり、すべてのCATIA環境での動作を保証するものではありません。