.. _package-rst-dialog: ==================== Package rst.dialog ==================== *Not documented* Messages ======== .. container:: mess4ge-multi .. container:: mess4ge-graph .. digraph:: message_graph fontname="Arial"; fontsize=11; stylesheet="../_static/graphs.css"; node [fontsize=11,fontname="Arial"] edge [fontsize=11,fontname="Arial"] "12" [label=<
DialogManagerCommand
Commandcommand
ASCII-STRINGpattern_name
>,shape=box,style=filled,fillcolor="white"]; "13" [label=<
Command
RESET_INTERACTION0
RESET_PATTERN1
>,shape=box,style=filled,fillcolor="white"]; "6" [label=<
DialogActCollection
DialogActelement
>,shape=box,style=filled,fillcolor="white"]; "7" [label=<
DialogAct
Typetype
IncrementalUnitincremental_unit
SpeechHypothesesspeech_hypotheses
>,shape=box,style=filled,fillcolor="white"]; "9" [label=<
SpeechHypotheses
SpeechHypothesisbest_result
SpeechHypothesisfurther_results
BOOLfinal
>,shape=box,style=filled,fillcolor="white"]; "10" [label=<
SpeechHypothesis
Wordwords
FLOAT32confidence
Intervaltimestamp
ASCII-STRINGgrammar_tree
>,shape=box,style=filled,fillcolor="white"]; "11" [label=<
Word
ASCII-STRINGword
Intervaltimestamps
>,shape=box,style=filled,fillcolor="white"]; "8" [label=<
Type
GREET0
ACCEPT1
REJECT2
CONFIRM3
NEGATE4
INFO_REQUEST5
ACTION_REQUEST6
STATEMENT7
ANSWER8
GOODBYE9
OTHER100
>,shape=box,style=filled,fillcolor="white"]; "1" [label=<
IncrementalUnitCollection
IncrementalUnitelement
>,shape=box,style=filled,fillcolor="white"]; "2" [label=<
IncrementalUnit
Intervaltimestamps
OCTET-VECTORid
OCTET-VECTORsll_id
OCTET-VECTORgil_id
EditTypestate
>,shape=box,style=filled,fillcolor="white"]; "5" [label=<
EditType
ADD0
UPDATED1
REVOKE2
COMMIT3
>,shape=box,style=filled,fillcolor="white"]; "3" [label=<
Interval
Timestampbegin
Timestampend
>,shape=box,style=filled,fillcolor="white"]; "4" [label=<
Timestamp
UINT64time
>,shape=box,style=filled,fillcolor="white"]; "12" -> "13" []; "12":command -> "13" []; "6":element -> "7" []; "7" -> "8" []; "7":speech_hypotheses -> "9" []; "7":incremental_unit -> "2" []; "7":type -> "8" []; "9":further_results -> "10" []; "9":best_result -> "10" []; "10" -> "11" []; "10":timestamp -> "3" []; "10":words -> "11" []; "11":timestamps -> "3" []; "1":element -> "2" []; "2" -> "5" []; "2":state -> "5" []; "2":timestamps -> "3" []; "3":end -> "4" []; "3":begin -> "4" []; .. container:: mess4ge-list .. container:: messages * :ref:`IncrementalUnitCollection ` * :ref:`DialogActCollection ` * :ref:`DialogManagerCommand ` * :ref:`DialogAct ` * :ref:`SpeechHypotheses ` * :ref:`SpeechHypothesis ` * :ref:`IncrementalUnit ` .. container:: clearer clearer: should be made invisible via css .. _message-rst-dialog-incrementalunitcollection: Message IncrementalUnitCollection --------------------------------- .. container:: message-rst-dialog-incrementalunitcollection-multi .. container:: message-rst-dialog-incrementalunitcollection-documentation .. py:class:: rst.dialog.IncrementalUnitCollection Collection of :py:class:`IncrementalUnit ` instances. Auto-generated. .. py:attribute:: element :type: array of :py:class:`rst.dialog.IncrementalUnit` The individual elements of the collection. Constraints regarding the empty collection, sorting, duplicated entries etc. are use case specific. .. container:: message-rst-dialog-incrementalunitcollection-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/IncrementalUnitCollection.proto :lines: 12-22 :language: protobuf :emphasize-lines: 9-9 .. _message-rst-dialog-dialogactcollection: Message DialogActCollection --------------------------- .. container:: message-rst-dialog-dialogactcollection-multi .. container:: message-rst-dialog-dialogactcollection-documentation .. py:class:: rst.dialog.DialogActCollection Collection of :py:class:`DialogAct ` instances. Auto-generated. .. py:attribute:: element :type: array of :py:class:`rst.dialog.DialogAct` The individual elements of the collection. Constraints regarding the empty collection, sorting, duplicated entries etc. are use case specific. .. container:: message-rst-dialog-dialogactcollection-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/DialogActCollection.proto :lines: 12-22 :language: protobuf :emphasize-lines: 9-9 .. _message-rst-dialog-dialogmanagercommand: Message DialogManagerCommand ---------------------------- .. container:: message-rst-dialog-dialogmanagercommand-multi .. container:: message-rst-dialog-dialogmanagercommand-documentation .. py:class:: rst.dialog.DialogManagerCommand A description of a command for a dialog manager. .. codeauthor:: Birte Carlmeyer .. py:attribute:: command :type: :py:class:`rst.dialog.DialogManagerCommand.Command` The chosen command for the dialog manager .. py:attribute:: pattern_name :type: :py:class:`ASCII-STRING` An interaction pattern referenced for the current command. .. container:: message-rst-dialog-dialogmanagercommand-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/DialogManagerCommand.proto :lines: 10-41 :language: protobuf :emphasize-lines: 25-25,30-30 .. _message-rst-dialog-dialogmanagercommand-command: Message Command --------------- .. container:: message-rst-dialog-dialogmanagercommand-command-multi .. container:: message-rst-dialog-dialogmanagercommand-command-documentation .. py:class:: rst.dialog.DialogManagerCommand.Command Possible kinds of commands. .. py:attribute:: RESET_INTERACTION = 0 Reset the whole interaction. .. py:attribute:: RESET_PATTERN = 1 Reset a single interaction pattern. Requires the :py:attr:`pattern_name ` name to be set. .. container:: message-rst-dialog-dialogmanagercommand-command-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/DialogManagerCommand.proto :lines: 15-29 :language: protobuf :emphasize-lines: 6-6,13-13 .. _message-rst-dialog-dialogact: Message DialogAct ----------------- .. container:: message-rst-dialog-dialogact-multi .. container:: message-rst-dialog-dialogact-documentation .. py:class:: rst.dialog.DialogAct A description of a dialog act as a specialization of an incremental unit consisting an xml speech hypothesis as payload. .. codeauthor:: Birte Carlmeyer @create_collection .. py:attribute:: type :type: :py:class:`rst.dialog.DialogAct.Type` The type of the current dialog act. .. py:attribute:: incremental_unit :type: :py:class:`rst.dialog.IncrementalUnit` The basic information of the dialog act IU. .. py:attribute:: speech_hypotheses :type: :py:class:`rst.dialog.SpeechHypotheses` The underlying speech recognition result causing this dialog act. .. container:: message-rst-dialog-dialogact-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/DialogAct.proto :lines: 15-96 :language: protobuf :emphasize-lines: 70-70,75-75,80-80 .. _message-rst-dialog-dialogact-type: Message Type ------------ .. container:: message-rst-dialog-dialogact-type-multi .. container:: message-rst-dialog-dialogact-type-documentation .. py:class:: rst.dialog.DialogAct.Type Possible kinds of dialog act types. .. py:attribute:: GREET = 0 Conversation opening. .. py:attribute:: ACCEPT = 1 Affirmative answer. .. py:attribute:: REJECT = 2 Negative answer. .. py:attribute:: CONFIRM = 3 Confirmation .. py:attribute:: NEGATE = 4 Negation .. py:attribute:: INFO_REQUEST = 5 Speaker wants an information from addressee. .. py:attribute:: ACTION_REQUEST = 6 Speaker offers to perform an action. .. py:attribute:: STATEMENT = 7 A statement. .. py:attribute:: ANSWER = 8 An answer (not a yes/no answer). .. py:attribute:: GOODBYE = 9 Conversation closing. .. py:attribute:: OTHER = 100 The current dialog act doesn't match to any of the previous types. .. container:: message-rst-dialog-dialogact-type-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/DialogAct.proto :lines: 20-78 :language: protobuf :emphasize-lines: 6-6,11-11,16-16,21-21,26-26,31-31,36-36,41-41,46-46,51-51,57-57 .. _message-rst-dialog-speechhypotheses: Message SpeechHypotheses ------------------------ .. container:: message-rst-dialog-speechhypotheses-multi .. container:: message-rst-dialog-speechhypotheses-documentation .. py:class:: rst.dialog.SpeechHypotheses A set of potential speech hypotheses for a single utterance representing different interpretations. .. codeauthor:: Birte Carlmeyer .. codeauthor:: Soeren Klett .. py:attribute:: best_result :type: :py:class:`rst.dialog.SpeechHypothesis` The best speech recognition result. .. py:attribute:: further_results :type: array of :py:class:`rst.dialog.SpeechHypothesis` A list of potential other interpretations of the speech signal ordered by confidence. The first entry represents the hypothesis with the highest confidence. The :py:attr:`best_result ` is not included in this list. .. py:attribute:: final :type: :py:class:`BOOL` Indicates whether the current result might be superseded with further results due to incremental processing or not. A value of true indicates that no further hypotheses for the represented speech utterance will be produced in the future. .. container:: message-rst-dialog-speechhypotheses-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/SpeechHypotheses.proto :lines: 14-37 :language: protobuf :emphasize-lines: 6-6,14-14,22-22 .. _message-rst-dialog-speechhypothesis: Message SpeechHypothesis ------------------------ .. container:: message-rst-dialog-speechhypothesis-multi .. container:: message-rst-dialog-speechhypothesis-documentation .. py:class:: rst.dialog.SpeechHypothesis A hypothesis about a speech recognition result. .. codeauthor:: Birte Carlmeyer .. codeauthor:: Soeren Klett .. py:attribute:: words :type: array of :py:class:`rst.dialog.SpeechHypothesis.Word` List of word speech recognition results. .. py:attribute:: confidence :type: :py:class:`FLOAT32` **Constraint**: ``0 <= value <= 1`` Confidence for this speech hypothesis. .. py:attribute:: timestamp :type: :py:class:`rst.timing.Interval` Start and end time for this speech hypothesis. Since some speech recognizers may not provide detailed results for each word, this field may be used to indicate the time of the overall hypothesis. .. py:attribute:: grammar_tree :type: :py:class:`ASCII-STRING` The grammar tree of this speech hypothesis. .. container:: message-rst-dialog-speechhypothesis-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/SpeechHypothesis.proto :lines: 13-58 :language: protobuf :emphasize-lines: 26-26,32-32,39-39,44-44 .. _message-rst-dialog-speechhypothesis-word: Message Word ------------ .. container:: message-rst-dialog-speechhypothesis-word-multi .. container:: message-rst-dialog-speechhypothesis-word-documentation .. py:class:: rst.dialog.SpeechHypothesis.Word Speech recognition result for a single word. .. py:attribute:: word :type: :py:class:`ASCII-STRING` Speech recognition result for a single word. .. py:attribute:: timestamps :type: :py:class:`rst.timing.Interval` Start and end time for this word. If specified, this must be within the bounds of :py:attr:`timestamp ` .. container:: message-rst-dialog-speechhypothesis-word-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/SpeechHypothesis.proto :lines: 18-33 :language: protobuf :emphasize-lines: 6-6,14-14 .. _message-rst-dialog-incrementalunit: Message IncrementalUnit ----------------------- .. container:: message-rst-dialog-incrementalunit-multi .. container:: message-rst-dialog-incrementalunit-documentation .. py:class:: rst.dialog.IncrementalUnit A description of the basic information of an incremental unit (IU) of the IU-model of incremental dialogue processing. .. seealso:: A General, Abstract Model of Incremental Dialogue Processing http://wwwhomes.uni-bielefeld.de/dschlangen/inpro/abstractModel.html .. codeauthor:: Birte Carlmeyer @create_collection .. py:attribute:: timestamps :type: :py:class:`rst.timing.Interval` Start and end time of the incremental unit. .. py:attribute:: id :type: :py:class:`OCTET-VECTOR` A unique id for the incremental unit. .. py:attribute:: sll_id :type: array of :py:class:`OCTET-VECTOR` Optional id list of IU which have a same-level link. Same-level links (sll) connect IUs, which are produced by the same module and reflect their temporal order. .. py:attribute:: gil_id :type: array of :py:class:`OCTET-VECTOR` Optional id list of IU which have a grounded-in link. Grounded-in links (gil) represent on which IUs they depend, thus representing the possibility to build a hierarchical structure. Entries are sorted by time and nesting level of the created graph. .. py:attribute:: state :type: :py:class:`rst.dialog.IncrementalUnit.EditType` Edit type of the incremental unit. .. container:: message-rst-dialog-incrementalunit-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/IncrementalUnit.proto :lines: 17-78 :language: protobuf :emphasize-lines: 34-34,39-39,46-46,55-55,60-60 .. _message-rst-dialog-incrementalunit-edittype: Message EditType ---------------- .. container:: message-rst-dialog-incrementalunit-edittype-multi .. container:: message-rst-dialog-incrementalunit-edittype-documentation .. py:class:: rst.dialog.IncrementalUnit.EditType The incremental unit can be in different states. .. py:attribute:: ADD = 0 Indicates a new incremental unit. .. py:attribute:: UPDATED = 1 Replaces the last incremental unit. .. py:attribute:: REVOKE = 2 Revokes a previously added unit. .. py:attribute:: COMMIT = 3 The incremental unit has been finally committed and will not be changed any more. .. container:: message-rst-dialog-incrementalunit-edittype-source :download:`Download this file ` .. literalinclude:: //home/jenkins/workspace/rst-manual-0.14-merge-simulator/upstream/RST-0.14.2-Linux/share/rst0.14/proto/sandbox/rst/dialog/IncrementalUnit.proto :lines: 22-45 :language: protobuf :emphasize-lines: 6-6,11-11,16-16,22-22