The Survey tool
runs and performs extensive
analysis of your running serial program's executable target to help you choose
possible places to add parallelism.
While the Survey tool is running your target program:
-
Analysis data is collected as the program runs. Non-GUI application output appears in the Application Output pane. A log of the collection messages appears in the Collection Log pane.
-
When data collection completes, data finalization prepares the data for display.
-
After finalization completes, the data appears in the Survey Report window. When a target executes for a very short duration, it may not be possible for the Survey tool to collect sufficient data to provide a Survey Report. In this case, a message (Target executed too quickly or does not contain debug symbols) appears instead. Consider increasing the workload or data set of the target, check whether debug information was specified as a build option, or specify a different target (click the link for the Troubleshooting Survey Tool ... help topic listed below under See Also).
-
New information appears in the dashboard-like Summary window, including the collection times and links that allow you to view the application output and collection output messages.
During data collection, you can temporarily pause and later resume data collection. To manually skip uninteresting parts of your target while the target continues to run, you can:
-
Temporarily stop (pause) data collection. To do this, click the
button
under
1. Survey Target in the
Workflow Tab.
-
Resume data collection that you previously paused. To resume collection, click the
button under
1. Survey Target in the
Workflow Tab.
Instead of manually clicking the
and
buttons, you can add the Pause Collection and Resume
Collection annotations around uninteresting source code region(s). These
annotations are recognized by all three Intel Advisor tools.
If you get impatient, you can stop or cancel the collection by doing one of the following:
-
Stop data collection and retain the collected data. To do this, click the
button
under
1. Survey Target in the
Workflow Tab.
-
Cancel data collection and discard the collected data. To do this, click the
button
under
1. Survey Target in the
Workflow Tab.
- To interrupt data finalization, click the
button. The collected data
is retained.
Once data collection and analysis have completed, data appears in the Survey Report window. In addition to the Survey Report window, you can view details in the Survey source window.