This repository has been archived on 2026-10-11. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
HiNC-2025-win-desktop-Deploy/App/wwwroot/HiAPI-docsite/manual/setup/spindle-capability.html
T
2026-09-09 17:35:23 +08:00

222 lines
13 KiB
HTML
Raw 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.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Spindle Capability | HiAPI-C# 2025 </title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="Spindle Capability | HiAPI-C# 2025 ">
<link rel="icon" href="../../img/HiAPI.favicon.ico">
<link rel="stylesheet" href="../../public/docfx.min.css">
<link rel="stylesheet" href="../../public/main.css">
<meta name="docfx:navrel" content="../../toc.html">
<meta name="docfx:tocrel" content="toc.html">
<meta name="docfx:rel" content="../../">
<meta name="loc:inThisArticle" content="In this article">
<meta name="loc:searchResultsCount" content="{count} results for &quot;{query}&quot;">
<meta name="loc:searchNoResults" content="No results for &quot;{query}&quot;">
<meta name="loc:tocFilter" content="Filter by title">
<meta name="loc:nextArticle" content="Next">
<meta name="loc:prevArticle" content="Previous">
<meta name="loc:themeLight" content="Light">
<meta name="loc:themeDark" content="Dark">
<meta name="loc:themeAuto" content="Auto">
<meta name="loc:changeTheme" content="Change theme">
<meta name="loc:copy" content="Copy">
<meta name="loc:downloadPdf" content="Download PDF">
<script type="module" src="./../../public/docfx.min.js"></script>
<script>
const theme = localStorage.getItem('theme') || 'auto'
document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
</script>
</head>
<body class="tex2jax_ignore" data-layout="" data-yaml-mime="">
<header class="bg-body border-bottom">
<nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
<div class="container-xxl flex-nowrap">
<a class="navbar-brand" href="../../index.html">
<img id="logo" class="svg" src="../../img/HiAPI.logo.png" alt="">
</a>
<button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation">
<i class="bi bi-three-dots"></i>
</button>
<div class="collapse navbar-collapse" id="navpanel">
<div id="navbar">
<form class="search" role="search" id="search">
<i class="bi bi-search"></i>
<input class="form-control" id="search-query" type="search" disabled placeholder="Search" autocomplete="off" aria-label="Search">
</form>
</div>
</div>
</div>
</nav>
</header>
<main class="container-xxl">
<div class="toc-offcanvas">
<div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
<button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<nav class="toc" id="toc"></nav>
</div>
</div>
</div>
<div class="content">
<div class="actionbar">
<button class="btn btn-lg border-0 d-md-none" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
<i class="bi bi-list"></i>
</button>
<nav id="breadcrumb"></nav>
</div>
<article data-uid="">
<h1 id="spindle-capability">Spindle Capability</h1>
<p>Describing the machine's spindle: how much power and torque it delivers at each speed, for how long,
and how hot it may get. You fill it in from the machine builder's spindle data sheet, and every spindle
number a run reports is measured against it. What the curves mean physically is
<a class="xref" href="../../technique/machine-capability/spindle-capability.html">Spindle Capability</a>; this page is where you enter them.</p>
<h2 id="where-it-is">Where it is</h2>
<p>The General Setup page, at <code>/general-setup</code>, reached from the menu bar's <strong>Page</strong> dropdown. Select the
<strong>Spindle Capability</strong> branch of the Control Tree (<code>/general-setup?tree=equipment/spindle</code>) — the
equipment item straight after Machine Tool. The tree and the selected node's editor share the left
dock; this branch also fills the page's middle <strong>content column</strong> with a power and a torque chart,
which stay mounted as you walk its six nodes. Until a project is open the branch is inert: the root
reports <em>No spindle capability attached to this project.</em> and points at the <strong>Object Management</strong>
(<code>⋮</code>) menu's <strong>Load</strong>, and each child shows <em>No spindle capability attached. Load one on the Spindle
Capability item.</em> in place of its fields. The selection rides in the address bar as the <code>?tree=</code> value
the paths below quote; what those ids do and do not promise across versions is
<a href="../basics/finding-your-way.html">Finding Your Way</a>.</p>
<h2 id="what-each-child-asks-for">What each child asks for</h2>
<p>The root node carries the ⋮ menu first, then the <strong>Name</strong> and the <strong>Note</strong>; the five children carry the
values, and each edit lands on the project's equipment as you make it.</p>
<table>
<thead>
<tr>
<th>Node</th>
<th>What to enter</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Thermal / Energy</strong><br><code>.../thermal</code></td>
<td><strong>Energy Efficiency</strong>, the output / input power ratio between 0 and 1; and the <strong>Working Temperature Upper Boundary</strong> in °C, the housing temperature the spindle is rated to work up to.</td>
</tr>
<tr>
<td><strong>Gear Shift</strong><br><code>.../gear-shift</code></td>
<td>Whether the spindle has a gear-shift mechanism (L/H), and the <strong>Gear Shift Spindle Speed</strong> in rpm at which it changes range. Leaving the box clear states a single-range spindle; the speed field stays disabled.</td>
</tr>
<tr>
<td><strong>Dry-Run Coefficients</strong><br><code>.../dry-run</code></td>
<td>The <strong>Friction Power Coefficient</strong> (mW/rpm) and the <strong>Windage Power Coefficient</strong> (pW/rpm³), the spindle's dry-run idle power — the two terms and where each dominates are <a class="xref" href="../../technique/machine-capability/spindle-capability.html">Spindle Capability</a>.</td>
</tr>
<tr>
<td><strong>Power Contours</strong><br><code>.../power</code></td>
<td>One kW-against-rpm curve per duty rating.</td>
</tr>
<tr>
<td><strong>Torque Contours</strong><br><code>.../torque</code></td>
<td>The same curves, in Nm.</td>
</tr>
</tbody>
</table>
<h2 id="entering-a-contour">Entering a contour</h2>
<ol>
<li>Select <strong>Power Contours</strong> or <strong>Torque Contours</strong>. <strong>Add</strong> asks for a workable duration in minutes,
pre-filled with 60 — clear the field for the continuous curve — and starts the new curve as a copy
of the selected one.</li>
<li>Pick the curve to edit in the <strong>Contour</strong> selector, which names each by its duration and the
unlimited one <strong>Continuous</strong>; its pencil button re-opens that duration, its delete button removes
the curve, and a chip click on the chart selects one just as the selector does.</li>
<li>The table below is the curve itself: one row per spindle speed and value, an insert button that
clones a row, a double-click that removes one, and a chart that redraws on every edit.</li>
</ol>
<p>The delete button beside the pencil removes the whole selected curve. It is disabled while only one
curve is left, so an axis that has curves cannot be emptied from here.</p>
<p><strong>Power Contours</strong> selected on a demo project, at <code>/general-setup?tree=equipment/spindle/power</code>. The
tree shows the branch's five children; the middle column carries the pair of charts, which stay put
as you walk between those children; and the panel under the tree is the editor for one curve —
<strong>Power contours (2)</strong> with its <strong>Add</strong> button, the <strong>Contour</strong> selector reading <em>360 min</em>, and the
four rows of that curve. The chart legends carry one chip per curve, <em>360 min</em> and <em>Cont.</em>, and a
click on a chip moves the editor to that curve.</p>
<p><img src="spindle-capability-img/power-contours.en.png" alt="The Spindle Capability branch expanded with Power Contours selected: the power and torque charts in the middle column, each with a 360 min and a Cont. legend chip, and the contour editor below the tree showing the Contour selector and a four-row spindle-speed and power table"></p>
<h2 id="where-the-numbers-come-from">Where the numbers come from</h2>
<p>The machine's or spindle's spec sheet, as the speed–power–torque diagram with the duty ratings printed
on it; which printed rating becomes which curve is
<a class="xref" href="../../technique/machine-capability/spindle-capability.html">Spindle Capability</a>, which shows the mapping against a real datasheet
chart. The default energy efficiency of 0.4 is the conversion HiNC's power figures were validated at, in
<a class="xref" href="../../technique/machine-capability/spindle-power-evaluation.html">Spindle Power Evaluation</a>; what to ask the machine owner for is
<a class="xref" href="../../workflows/project-data-checklist.html">Project Data Checklist</a>.</p>
<p><strong>The two dry-run coefficients are the ones a datasheet almost never prints.</strong> Their defaults —
4.82 mW/rpm of friction and 90 pW/rpm³ of windage — are estimated from published measurements of
comparable spindles rather than measured on yours, and they are a reasonable place to leave the
field unless you have run the spindle empty and measured its idle draw.</p>
<p>Leaving the branch alone is a choice rather than a blank: a project never given a capability carries a
stand-in — the <strong>TMV-720A-STD-8000RPM</strong> spindle, the same curves as one of the three shipped files, so
its name is what the root node shows: 15-minute, 60-minute and continuous curves on each axis, topping
out at 8000 rpm, with 0.4 efficiency and a 65 °C ceiling. That is fine for light cuts in small or soft
stock. Near the machine's limit it is the wrong envelope, and everything measured against it inherits
the error — the spindle torque, power and temperature ratios the run charts, and the feed the optimizer
assigns under the spindle safety factors, which are
<a class="xref" href="../../technique/machine-capability/machine-condition.html">Machine Condition and Safety Factors</a>.</p>
<h2 id="loading-and-saving">Loading and saving</h2>
<p>The root node's ⋮ menu is the branch's whole file surface. The capability is stored in the project, so
one already carrying the right spindle needs no file at all; <strong>Copy</strong>, <strong>Paste</strong> and <strong>XML Mode</strong> move
it as XML, and an XML <strong>Apply</strong> installs exactly as a Load does.</p>
<ul>
<li><strong>Load</strong> browses the server for a <code>.SpindleCapability</code> or <code>.xml</code> file — the project or
administrator directory, the latter carrying the shipped resource library where three ready-made
capabilities are installed. It replaces the capability outright; the branch and the charts reload
onto the new one.</li>
<li><strong>Save As</strong> writes the current capability out, offered as <code>SpindleCapability.xml</code> in the project
folder: how a spindle you have tuned becomes reusable in the next project.</li>
</ul>
<h2 id="see-also">See Also</h2>
<ul>
<li><a class="xref" href="../../technique/machine-capability/spindle-capability.html">Spindle Capability</a> — what these curves mean, and how the run's spindle ratios and temperature come out of them</li>
<li><a class="xref" href="../../workflows/project-data-checklist.html">Project Data Checklist</a> — the data to collect from the machine owner before filling this branch in</li>
<li><a href="machine-tool.html">Machine Tool</a> — the machine whose spindle this describes</li>
<li><a href="index.html">Setup</a> — the rest of the pre-simulation configuration</li>
</ul>
</article>
<div class="contribution d-print-none">
</div>
<div class="next-article d-print-none border-top" id="nextArticle"></div>
</div>
<div class="affix">
<nav id="affix"></nav>
</div>
</main>
<div class="container-xxl search-results" id="search-results"></div>
<footer class="border-top text-secondary">
<div class="container-xxl">
<div class="flex-fill">
<span> Copyright © 2025 <a href='https://superhightech.com.tw'>Tech Coordinate</a>. All rights reserved. <a href='https://superhightech.com.tw'>超級高科技股份有限公司</a> © 2025 版權所有 </span>
</div>
</div>
</footer>
</body>
</html>