98 lines
6.7 KiB
HTML
98 lines
6.7 KiB
HTML
<html><head><title>Arch Survey</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Arch Survey</h1></div>
|
|
|
|
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><table class="fcinfobox wikitable ct" >
|
|
<tr>
|
|
<td class="ctTitle">
|
|
<h3><span class="mw-headline" id="Arch_Survey"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Survey.png" class="image"><img alt="Arch Survey.png" src="32px-Arch_Survey.png" width="32" height="32" srcset="/wiki/images/thumb/1/14/Arch_Survey.png/48px-Arch_Survey.png 1.5x, /wiki/images/1/14/Arch_Survey.png 2x" /></a> Arch Survey</span></h3>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Menu location
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven">Arch → Survey
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Workbenches
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven"><a href="Arch_Module.html" title="Arch Module">Arch</a>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Default shortcut
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven">None
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">See also
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven"><a href="Macro_FCInfo.html" title="Macro FCInfo">FCInfo (macro)</a>
|
|
</td></tr>
|
|
<tr>
|
|
<td class="ctToc"><br /><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
|
<ul>
|
|
<li class="toclevel-1"><a href="#Arch_Survey"><span class="tocnumber">1</span> <span class="toctext">Arch Survey</span></a></li>
|
|
<li class="toclevel-1 tocsection-1"><a href="#Description"><span class="tocnumber">2</span> <span class="toctext">Description</span></a></li>
|
|
<li class="toclevel-1 tocsection-2"><a href="#How_to_use"><span class="tocnumber">3</span> <span class="toctext">How to use</span></a></li>
|
|
<li class="toclevel-1 tocsection-3"><a href="#Options"><span class="tocnumber">4</span> <span class="toctext">Options</span></a></li>
|
|
<li class="toclevel-1 tocsection-4"><a href="#Scripting"><span class="tocnumber">5</span> <span class="toctext">Scripting</span></a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
</td></tr></table>
|
|
<p><br />
|
|
</p>
|
|
<h2><span class="mw-headline" id="Description">Description</span></h2>
|
|
<p>The survey tool enters a special surveying mode, which allows you to quickly grab measures and information from a model, and transfer that information to other applications. Once you are in Survey mode, clicking on different subelements of 3D objects gathers the following information, depending on what you click:
|
|
</p>
|
|
<ul><li> If you click on an edge, you get its length</li>
|
|
<li> If you click on a vertex, you get its height (coordinate on the Z axis)</li>
|
|
<li> If you click on a face, you get its area</li>
|
|
<li> If you double-click anything, therefore select the whole object, you get its volume</li></ul>
|
|
<p>When such a piece of information is gathered, several things happen:
|
|
</p>
|
|
<ul><li> A label is placed on top of the element you clicked, that displays the value (with "a" for area, "l" for length, "z" for height, or "v" for volume)</li>
|
|
<li> The numeric value is copied to the clipboard, so you can paste it in another application</li>
|
|
<li> A line is printed on the FreeCAD output window. After you exit the survey mode, those lines can be copied and pasted in another application (the values are comma-separated, making it easy to convert to spreadsheet data)</li>
|
|
<li> The total length or area of the elements you clicked so far is also printed in the output window</li>
|
|
<li> Each length or area is also recorded in the task dialog</li></ul>
|
|
<p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Survey_example.jpg" class="image"><img alt="Arch Survey example.jpg" src="640px-Arch_Survey_example.jpg" width="640" height="457" srcset="/wiki/images/thumb/2/2c/Arch_Survey_example.jpg/960px-Arch_Survey_example.jpg 1.5x, /wiki/images/2/2c/Arch_Survey_example.jpg 2x" /></a>
|
|
</p><p>The above image shows what happens when running the survey mode.
|
|
</p>
|
|
<h2><span class="mw-headline" id="How_to_use">How to use</span></h2>
|
|
<ol><li> Press the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Survey.png" class="image"><img alt="Arch Survey.png" src="16px-Arch_Survey.png" width="16" height="16" srcset="/wiki/images/thumb/1/14/Arch_Survey.png/24px-Arch_Survey.png 1.5x, 32px-Arch_Survey.png 2x" /></a> <a class="mw-selflink selflink">Arch Survey</a></span> button</li>
|
|
<li> Click on vertices, edges, faces or double-click to select whole objects</li>
|
|
<li> Click outside any geometry (on the background of the 3D view) to remove existing labels, print a total line in the Task dialog, and restart counting lengths and areas from zero</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">ESC</span> or the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>Close</b></span> button to exit survey mode and remove all the labels.</li></ol>
|
|
<h2><span class="mw-headline" id="Options">Options</span></h2>
|
|
<ul><li> You can add a custom label to any line in the Task dialog by clicking that line, then adding a text in the description field, then press the <b>set description</b> button.</li>
|
|
<li> Once you are done, before closing, you can export the contents of the Task dialog by pressing the "export CSV" button. The resulting CSV file can then be opened in any spreadsheet application such as Excel or LibreOffice Calc. The values and units will be separated in the resulting CSV file, and the totals are written as SUM() functions.</li></ul>
|
|
<p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Arch_Survey_spreadsheet.jpg" class="image"><img alt="Arch Survey spreadsheet.jpg" src="Arch_Survey_spreadsheet.jpg" width="640" height="588" /></a>
|
|
</p>
|
|
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
|
|
<p>The Survey mode cannot be used directly from python scripts, but gathering the same information from any selected <a href="Part_Module.html" title="Part Module">Part</a>-based object is easy reproduced with the following script:
|
|
</p>
|
|
<pre>import FreeCADGui
|
|
selection = FreeCADGui.Selection.getSelectionEx()
|
|
for obj in selection:
|
|
for element in obj.SubObjects:
|
|
print "Area: ", element.Area
|
|
print "Length: ", element.Length
|
|
print "Volume: ", element.Volume
|
|
print "Center of Mass: ", element.CenterOfMass </pre>
|
|
</div>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div><div class="printfooter">
|
|
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Arch_Survey&oldid=236809">http://www.freecadweb.org/wiki/index.php?title=Arch_Survey&oldid=236809</a>"</div>
|
|
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
<div id="mw-navigation">
|
|
<h2>Navigation menu</h2>
|
|
|
|
</body></html> |