Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated File widget documentation #6966

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 16 additions & 17 deletions doc/visual-programming/source/widgets/data/file.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,19 @@ Reads attribute-value data from an input file.

- Data: dataset from the file

The **File** widget [reads the input data file](../../loading-your-data/index.md) (data table with data instances) and sends the dataset to its output channel. The history of most recently opened files is maintained in the widget. The widget also includes a directory with sample datasets that come pre-installed with Orange.

The widget reads data from Excel (**.xlsx**), simple tab-delimited (**.txt**), comma-separated files (**.csv**) or URLs. For other formats see Other Formats section below.
The **File** widget [reads the input data file](../../loading-your-data/index.md) (data table with data instances) and sends the dataset to its output channel. The history of most recently opened files is maintained in the widget. The widget can directly open a folder containing pre-installed sample datasets.

![](images/File-stamped.png)

1. Browse through previously opened data files, or load any of the sample ones.
1. Browse previously opened data files, or load any of the sample ones.
2. Browse for a data file.
3. Reloads currently selected data file.
3. Reload currently selected data file.
4. Insert data from URL addresses, including data from Google Sheets.
5. Information on the loaded dataset: dataset size, number and types of data features.
6. Additional information on the features in the dataset. Features can be edited by double-clicking on them. The user can change the attribute names, select the type of variable per each attribute (*Continuous*, *Nominal*, *String*, *Datetime*), and choose how to further define the attributes (as *Features*, *Targets* or *Meta*). The user can also decide to ignore an attribute.
7. Browse documentation datasets.
8. Produce a report.
5. Select file type to activate a specific reader.
6. Information on the loaded dataset: dataset size, number and types of data features.
7. Additional information on the features in the dataset. Features can be edited by double-clicking them. The user can change the attribute names, select the type of variable per each attribute (*Continuous*, *Nominal*, *String*, *Datetime*), and choose how to further define the attributes (as *Features*, *Targets* or *Meta*). The user can also decide to ignore an attribute.
8. Browse documentation datasets.
9. Produce a report.

Example
-------
Expand All @@ -32,7 +31,7 @@ Most Orange workflows would probably start with the **File** widget. In the sche

### Loading your data

- Orange can import any comma, .xlsx or tab-delimited data file or URL. Use the **File** widget and then, if needed, select class and meta attributes.
- The **File** widget can import any .xlsx, comma, or tab-delimited data file or URL. Use the **File** widget and, if needed, select class and meta attributes.
- To specify the domain and the type of the attribute, attribute names can be preceded with a label followed by a hash. Use c for class and m for meta attribute, i to ignore a column, and C, D, S for continuous, discrete and string attribute types. Examples: C#mpg, mS#name, i#dummy.
- Orange's native format is a tab-delimited text file with three header rows. The first row contains attribute names, the second the type (*continuous*, *discrete* or *string*), and the third the optional element (*class*, *meta* or *time*).

Expand All @@ -44,10 +43,10 @@ Read more on loading your data [here](../../loading-your-data/index.md).

Supported formats and the widgets to load them:

- distance matrix: [Distance File](../unsupervised/distancefile.md)
- predictive model: [Load Model](../model/loadmodel.md)
- network: Network File from Network add-on
- images: Import Images from Image Analytics add-on
- text/corpus: Corpus or Import Documents from Text add-on
- single cell data: Load Data from Single Cell add-on
- several spectroscopy files: Multifile from Spectroscopy add-on
- distance matrix: **[Distance File](../unsupervised/distancefile.md)**
- predictive model: **[Load Model](../model/loadmodel.md)**
- network: **Network File** from the _Network_ add-on
- images: **Import Images** from the _Image Analytics_ add-on
- text/corpus: **Corpus** or **Import Documents** from the _Text_ add-on
- single cell data: Load Data from the _Single Cell_ add-on
- several spectroscopy files: **Multifile** from the _Spectroscopy_ add-on
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading