Source

orange / docs / widgets / rst / data / save.rst

Diff from to

docs/widgets/rst/data/save.rst

 ====
 
 .. image:: ../../../../Orange/OrangeWidgets/Data/icons/Save.svg
+   :alt: Save widget icon
+   :class: widget-category-data widget-icon
 
 Saves data to a file.
 
 -------
 
 Inputs:
-   - Examples (ExampleTable)
-      Attribute-valued data set.
+   - :obj:`Data`
+        Attribute-valued data set.
 
 Outputs:
    - (None)
 Description
 -----------
 
-.. image:: images/Save.png
+Save widget considers a data set provided on the input channel and
+saves it to a data file with the specified name. The widget remembers
+a history of the most recent file names. It can save into
+tab-delimited and comma-separated files, as well as the C4.5's format
+and Weka's .arrf files.
 
-Takes a data set provided at the input channel and saves it to a
-data file with the specified name. The widget remembers a history of the most recent file names.
-It can save into tab-delimited and comma-separated files, as well as the
-C4.5's format and Weka's .arrf files.
+By design, the widget does not save the data every time it receives a
+new signal on the input as this would constantly (and, mostly,
+inadvertently) overwrite the file. Instead, the data is saved only
+after a new file name is set or the user pushes :obj:`Save` button.
 
-The widget does not save the data every time it receives a new signal on
-the input as this would constantly (and, mostly, inadvertently) overwrite
-the file. Instead the data is saved after a new file name is set or the
-user pushes :obj:`Save current data`.
+.. image:: images/Save-stamped.png
+   :alt: File widget with loaded Iris data set
+   :align: right
+
+.. rst-class:: stamp-list
+
+    1. Selected from the file names and locations from the past
+       saves.
+    #. Specify a new data file to save to.
+    #. Save the data to a chosen data file.
+
+.. container:: clearer
+
+    .. image :: images/spacer.png
+
 
 Example
 -------
 
-The schema below can be used to train the naive Bayesian classifier on the data loaded
-from a file, use the classifier on data from another file and save the misclassified examples
-(or the correctly classified, depending on what we select in the Confusion Matrix) into a file.
+In the workflow below we load the data into a :ref:`Scatter Plot`
+widget, where we select a subset of the data instances and push them
+to Save widget to store them in a data file.
 
 .. image:: images/Save-Example.png
    :alt: Schema with Save widget