Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start:plugins:attributeanalysis:attributeanalysis-usermanual [2021/01/11 15:52]
adminmar [Attribute Analysis Form]
start:plugins:attributeanalysis:attributeanalysis-usermanual [2021/11/04 14:27] (current)
adminmar
Line 6: Line 6:
 The plugin installer can be downloaded at: [[https://www.tomkod.com/product/attribute-analysis/]] \\  The plugin installer can be downloaded at: [[https://www.tomkod.com/product/attribute-analysis/]] \\ 
 A free trial is included, and yearly licenses can be purchased on the aforementioned page.\\  A free trial is included, and yearly licenses can be purchased on the aforementioned page.\\ 
-//Attribute Analysis// works for Rhino 5 ((Rhino 5.12 or later)), Rhino 6 ((Rhino 6.15 or later)), Rhino7((Tested up to Rhino 7.1)), and as standalone software ((windows7 and later)).+//Attribute Analysis// works with Rhino 6 ((Rhino 6.15 or higher)), Rhino7((Rhino 7.5 or higher)), and as standalone software ((windows7 and higher)). 
 +<WRAP center round important 80%> 
 +Please note that only the provided .exe installers offer the possibility to register an "Analysis" shortcut on a 3dm file's right-click. 
 + 
 +If you installed our plugin from Rhino's package manager, you'll have to do //Right-Click/OpenWith.../(Select the executable file from installation directory)// 
 +</WRAP>
  
 {{page>start:plugins:common#[Yak]&noindent&nofooter&nodate}} {{page>start:plugins:common#[Yak]&noindent&nofooter&nodate}}
Line 14: Line 19:
 {{page>start:plugins:common#[Toolbar]&noindent&nofooter&nodate}} {{page>start:plugins:common#[Toolbar]&noindent&nofooter&nodate}}
  
 +===== Generalities =====
 +The following rules will apply both when Attribute Analysis is performed from Rhino and from windows explorer:
 +  * Any object hidden in the model will be ignored. 
 +  * Any hidden belonging to a hidden layer will be ignored.
 +  * Only top-level objects will be considered. Typically, if an object is part of a block instance, its attributes won't be read - the block instance's attribute will be used instead.
 ===== Rhino commands ===== ===== Rhino commands =====
 ==== AttributeAnalysis_About ==== ==== AttributeAnalysis_About ====
Line 24: Line 34:
  
 ==== AttributeAnalysis ==== ==== AttributeAnalysis ====
-This command gives a fast analysis of the model's attributes. It is particularly usefull if you want to store the material statuses directly in the model. For example, a part could be marked as //"Draft", "Validated", "Ordered", "Assembled",// or //"Controled"//+This command gives a fast analysis of the model's attributes. It is particularly useful if you want to store the material statuses directly in the model. For example, a part could be marked as //"Draft", "Validated", "Ordered", "Assembled",// or //"Controlled"//
 === Walkthrough === === Walkthrough ===
   - Launch the command   - Launch the command
-  - Select an attribute((usertext)) from the list (Doublic-click) +  - Select an attribute((usertext)) from the list (Double-click) 
-  - The [[start:plugins:attributeanalysis:attributeanalysis-usermanual#attribute_analysis_form|attribute analysis form]] is shown and the model's objects are colored to match the keys. The stats are also added to the command line history.+  - The [[start:plugins:attributeanalysis:attributeanalysis-usermanual#attribute_analysis_form|attribute analysis form]] is shown and the model's objects are colored to match the keys. The stats are also added to the command line history. <wrap hi>From this window, the values can be edited, and a selection by user texts' value(s) can be performed.</wrap>
   - When the form is closed, the command ends, but the object's selection remains.   - When the form is closed, the command ends, but the object's selection remains.
 {{ :start:plugins:attributeanalysis:attributeanalysiscommand.gif?nolink |}} {{ :start:plugins:attributeanalysis:attributeanalysiscommand.gif?nolink |}}
 === Scripted mode === === Scripted mode ===
-No scripted mode available for this command.+No scripted mode is available for this command.
  
 ===== StandAlone mode ===== ===== StandAlone mode =====
-This plugin offer a standalone mode, to check your models attributes directly for windows explorer.+This plugin offers a standalone mode, to check your modelsattributes directly for windows explorer.
  
 <wrap em>Rhino is not needed, this will work regardless it is installed or not!!!</wrap> <wrap em>Rhino is not needed, this will work regardless it is installed or not!!!</wrap>
 ==== Walkthrough ==== ==== Walkthrough ====
-  - Right click on a rhino file +  - Right click to a 3dm file, then pick "AttributeAnalysis" ((Alternatively //Right click on a rhino file ♦ Select //"Open with.."// ♦ Use the program AttributeAnalysis.exe, available in the plugin's installation folder//)) {{ :start:plugins:attributeanalysis:ata-shellmenu.jpg?nolink |}}
-  - Select //"Open with.."// +
-  - Use the program AttributeAnalysis.exe, available in the plugin's installation folder+
   - Select an attribute((usertext)) from the list (Doublic-click)   - Select an attribute((usertext)) from the list (Doublic-click)
   - The [[start:plugins:attributeanalysis:attributeanalysis-usermanual#attribute_analysis_form|attribute analysis form]] is shown.   - The [[start:plugins:attributeanalysis:attributeanalysis-usermanual#attribute_analysis_form|attribute analysis form]] is shown.
   - When the //attribute analysis form// is closed, the attribute selection form is shown again. Close it to close the program.   - When the //attribute analysis form// is closed, the attribute selection form is shown again. Close it to close the program.
 {{ :start:plugins:attributeanalysis:attributeanalysisstandalone.gif?nolink |}} {{ :start:plugins:attributeanalysis:attributeanalysisstandalone.gif?nolink |}}
-=====  Attribute Analysis Form ===== +===== Custom settings / How to's ===== 
-This custom form is where the selected usertext'stats will be displayed:+=== Hide/show attribute keys from the list === 
 +Sometimes we use rhino's user keys for information not relevant for the AttributeAnalysis command. You can hide these attributes by adding them to the file **AA_AnalysisIgnoredAttributes.set**; editable with any text editor such as notepad.exe. Located inside the installation folder, it only consists of a semicolon-separated list of attribute keys that should be ignored, for example: 
 +<code> 
 +IgnoreThisAttributeName;ThisOneToo 
 +</code> 
 + 
 +===== Attribute Analysis Form ===== 
 +This custom form is where the selected user texts stats will be displayed:
 {{ :start:plugins:attributeanalysis:attributeanalysis_form_fixed.jpg?nolink |}} {{ :start:plugins:attributeanalysis:attributeanalysis_form_fixed.jpg?nolink |}}
 +
 +From v2.1.2, several new buttons are available to copy the results to the clipboard, or save it as a .jpg file:
 +{{ :start:plugins:attributeanalysis:ata-formexport.jpg?nolink |}}