diff --git a/src/DynamoCoreWpf/Controls/Docs/NodeAutocompleteDocumentation.html b/src/DynamoCoreWpf/Controls/Docs/NodeAutocompleteDocumentation.html index f997311a1f9..bbe1486e69f 100644 --- a/src/DynamoCoreWpf/Controls/Docs/NodeAutocompleteDocumentation.html +++ b/src/DynamoCoreWpf/Controls/Docs/NodeAutocompleteDocumentation.html @@ -165,20 +165,55 @@

Recommended Nodes

The machine learning algorithm behind the Recommended Nodes method does not analyze user data. Instead, its recommendations are based on node use in a large set of sample graphs that the Dynamo team has selected.

-

Confidence ratings

+

Confidence level

- Each recommended node is shown with a confidence rating, which determines its order in the list, - with the highest-rated node at the top. This rating, ranging from 0% to 100%, represents the machine learning model’s - estimated probability that the given node is the right choice. When deciding which of the recommended nodes to place, - confidence ratings can help you pick the most feasible nodes.

- In the Node Autocomplete results, nodes below a 10% confidence threshold are initially hidden beneath an expandable header. - If you’d like to see the full list of nodes, click the Low Confidence header. In the Preferences panel, you can either disable this header, - displaying results of all confidence levels by default, or edit the percentage below which results are hidden. - This setting is only available when the Recommended Nodes method is selected.

- Example of using node autocomplete auto wire feature
- Example of using node autocomplete auto wire feature

- These confidence ratings are predictions, so they will never be perfectly accurate. However, as the algorithm improves over time, - the predictions should also become more and more helpful.

+ Each recommended node is shown with a confidence level represented as a percentage. Confidence level represents the machine learning model’s estimated probability that the given node is the right choice. Recommended nodes are ordered from highest to lowest percentage. When deciding which of the recommended nodes to place, confidence level can help you pick the most feasible nodes.

+ The confidence level percentages for all recommended nodes in the list add up to roughly 100%. The exact percentage total may differ based on user settings that control how many recommendations are shown, as well as any recommendations that have been omitted, such as when Dynamo cannot match a node with a recommendation.

+ In the Node Autocomplete results, nodes below a 10% confidence threshold are initially hidden beneath an expandable header. If you’d like to see the full list of nodes, click the Low Confidence header. In the Preferences panel, you can either disable this header, displaying results of all confidence levels by default, or edit the percentage below which results are hidden. This setting is only available when the Recommended Nodes method is selected. You can also select the total number of results shown.

+ Example of using node autocomplete auto wire feature

+ Example of using node autocomplete auto wire feature

+ Since there are many ways to build graphs, and these confidence levels are simply predictions, they will never be perfectly accurate or reach a 100% level of confidence. However, as the algorithm improves over time, the predictions should also become more and more helpful.

+

+

Recommended nodes with port options

+

+ Some recommended nodes give you the option to select which port you’d like to connect them to. This is indicated with a caret icon to the right of the node name. When you click the node, a menu will appear allowing you to select a port.

+ This happens when the suggested node has multiple ports that are feasible options. In the menu, each port’s confidence level is shown separately. Confidence level may be the same for each port, as in the example below, or it may differ. The percentage points for all port options are added up and shown in the main Autocomplete window as the confidence level for that node.

+ Example of using node autocomplete auto wire feature

+ In this example, Node Autocomplete has been triggered from the Point.ByCoordinates output port. The recommended node, Line.ByStartPointEndPoint, has two input ports:

+

+ Because of this, the ByStartPointEndPoint recommendation in the Node Autocomplete window includes a caret icon and the option to select either of the two ports. Both ports have a 7% confidence level, and each level is added up to form the 14% total confidence level for the node. When one of these ports is selected, Node Autocomplete will auto-wire the node to that port (more on the auto-wire mechanism below).

+

+

Package support

+

+ Packages extend Dynamo functionality by allowing you to access and share custom nodes. In addition to the out-of-the-box set of Dynamo nodes, including nodes from host programs such as Revit, Node Autocomplete may recommend nodes from the following packages:

+

+ Node Autocomplete will only recommend nodes from packages that you currently have installed. Likewise, it will only recommend nodes that depend on host programs if you are running Dynamo from that host program. However, Node Autocomplete may sometimes recommend custom nodes from packages with Python scripts that depend on Revit library imports, even if you are running Dynamo Core (Sandbox). This is because there is currently no way for Node Autocomplete to identify which host program a Python-based custom node depends on.

+ Only the latest version of these packages is supported. If you have an older version of a package installed, any nodes from that package that have been deprecated in a newer version will not be included in the recommendations. To take full advantage of Node Autocomplete’s package support, make sure you have the latest versions of these packages installed.

Node Type Match

diff --git a/src/DynamoCoreWpf/Controls/NodeAutoCompleteSearchControl.xaml b/src/DynamoCoreWpf/Controls/NodeAutoCompleteSearchControl.xaml index 119a5692521..82b1d223f18 100644 --- a/src/DynamoCoreWpf/Controls/NodeAutoCompleteSearchControl.xaml +++ b/src/DynamoCoreWpf/Controls/NodeAutoCompleteSearchControl.xaml @@ -29,6 +29,8 @@ Handler="OnMouseEnter" /> + + + + + + + + + + +