## repository: https://code.ros.org/svn/ros-pkg
<<PackageHeader(smach_viewer)>>
<<TOC(4)>>
||[[smach_viewer|English]]||||[[cn/smach_viewer|简体中文]]||

== Usage ==

{{{
rosrun smach_viewer smach_viewer.py
}}}

This will start the GUI. Once you have one or more state machines running with an introspection server, they should show up in the GUI.

/!\ Your state machine needs to run an introspection server to allow the smach viewer to connect to it. See [[smach/Tutorials/Smach Viewer|this tutorial]] for more details.

{{attachment:smach/smach_viewer.png||width=100%}}

== Documentation ==

=== Graph view ===
The graph view shows all the states of the state machine, connected by their outcomes. Each node represents a state (or sub state machine), and each arc represents a state transition. When the outcome of the state is the same as the outcome of the state machine, there is no arc drawn to simplify the view. Clicking on "show implicit" will show all state transitions.

{{attachment:viewer1.png||width="750"}}


=== View depth ===
The "depth" box allows you to expand or collapse sub state machines. Depth 0 means you only show the top level state machine, depth 1 shows the first level of sub state machines, etc. Level -1 show all levels.

{{attachment:smach/Tutorials/Create a hierarchical state machine/sm_expanded.png||width="650"}}

=== Tree view ===
It is also possible to show a state machine as a tree. This view makes it clear that one state machine is a sub state machine of another state machine.

{{attachment:viewer2.png||width="600"}}

## AUTOGENERATED DON'T DELETE
## CategoryPackage