Managing Data Files and Folders¶
The Data window contains both input data files that are used in analyses and output data files that are returned as the result of completed analyses. Input data files can be uploaded or imported to your personal workspace from your desktop or from URL, as well as made available by other users in the Community Data folder and shared with others.
This section discusses how to organize and maneuver data files and folders in your Data window, including viewing and changing the file’s info-type.
For information on using data files in your analyses, see Submitting an Analysis.
You can access and manage data from outside the DE as well. For more information, see Downloading and Uploading Data.
Opening the Data Window¶
Click the Data icon to open the Data window
Window Icons¶
Help: Click to open the FAQs page for the current window. | |
Layout: Resizes the window layout to half of the available available desktop space and positions it either to the left (Snap Left) or right side (Snap Right) of the window. | |
Minimize, Maximize, or close the active window. |
Using the Data list¶
- Click in the search field, or paste the path, to search for a file or folder.
- Click a folder in the Navigation list to displays its contents (files and subfolders) in the middle column.
- Click a checkbox in the middle pane to view details about the item in the Details section in the right column.
The navigation list in the left pane is where you navigate through data files and folders in your personal workspace.
Personal folder | Click your username folder to view the list of data items you own. |
Community Data | View the list of data items that have been shared by other CyVerse account users. |
Shared With Me | Click the shared with me folder (does not show if no one has shared any items with you) to view data items that have been shared with you by other users. |
Trash | Click the Trash folder to view the list of deleted data items, empty the Trash folder to permanently delete all items in the folder, or delete selected items. |
Saved filters | If you saved any search filters, the Saved filters folder is displayed below the Trash folder. |
Favorites | The list of your favorite files and folders. |
Understanding inaccessible data items¶
Data items that are inaccessible are displayed in red italicized font.
This may be due to special characters (’ or ~) in the path or name, or system-level items, such as your iplant/home/shared folder or your home directory. These data items cannot be opened, renamed, moved, deleted, or accessed in any way. For more information, see Using Special Characters in the DE.
Sorting, adding, and hiding columns in the Data list¶
You can sort on any column in the Data list, and hide or show columns to customize the look of your Data list.
- Hover over the column header until a down arrow appears on the right side of the column, and then click the down arrow:
Click the setting to use
- To sort the column, click either Sort Ascending or Sort Descending.
- To hide or show a column, point to Columns, and then select or clear the checkbox for the column.
Tip
Need to view the path?
Show the Path column to help you determine which file or folder to use in search results.
Using the Data actions icons¶
Create a Shared Path Folder Link (folders only) or Share the item via Public Link (files only) | |
Share the item Via the Discovery Environment | |
Netadata | Add or edit metadata or select a metadate template |
Add or retract comments about a file or folder |
Viewing Details¶
Click the checkbox for a file or folder in the middle column to view information about it in the Details section on the right side of the Data window. The options that are available depend upon whether a file or a folder is selected.
File Details | Folder Details |
---|---|
Details Option | Description | File | Folder |
---|---|---|---|
Last Modified | Date the item was last modified by the owner. | ||
Date Submitted | Date the owner shared it publicly with other CyVerse users. | ||
Permissions | Permission level you have been granted for the item. | ||
Share | Displays whether the file or folder has been shared. If you are the owner, allows you to access the file or folder to share or change sharing permissions. | ||
Size | Size of the file. | ||
Type | File type for the file. | ||
Info-Type | Info-type for the file. | ||
md5 Checksum | Useful for comparing files and verifying the integrity of the downloaded file. | ||
Send to | CoGe, Ensemble, or Newick files only. Allows you to send a genome file to CoGe or Ensembl, or a Newick file to the Tree Viewer. These commands are also available in the share menu. | ||
File(s)/Folder(s) | Number of files and subfolders contained in the folder. | ||
Tags | Add or delete a tag for a file or folder, or enter a description about the tag or data item. |
Basic process¶
To begin, you need the data files you want to use in your analysis. You can use any file in your personal, Community Data, or Shared With Me folder, or you can upload or import a data file to your personal folder. Once the data file is in your workspace folder or in the Community Data folder, you can:
- Use the file in an analysis.
- View the outputs of a completed analysis.
- Download data files, output files, and folders.
- Add or view metadata in files and folders.
- Add tags and tag descriptions to files and folders.
Tip
It is also possible to manage data outside of the Discovery Environment using other tools, as documented in Downloading and Uploading Data.
Managing Data Files and Folders Table of contents¶
- Uploading data items
- Importing data items
- Useful information
- Using Special Characters in the DE
- About downloading files and folders
- Searching for Data Items
- Search options
- File and folder names
- Including or excluding specific words in the file or folder name (advanced search)
- Metadata attributes and value (advanced search)
- File size (advanced search)
- Date (advanced search)
- File owner or shared recipients (advanced search)
- Tags
- Simple tag (Data window)
- Multiple tags (advanced search)
- Including trash items in the query (advanced search)
- Using saved search filters
- Using the Data Edit menu to edit files and folders
- Editing the Contents of a File
- Moving a Data File or Folder
- Renaming a Data File or Folder
- Viewing and Customizing Data Files
- Viewing, adding, and retracting data comments
- Deleting Files and Folders (Trash)
- Using Data Favorites
- Sharing Data Files and Folders
- Sharing and Unsharing Data Files and Folders in the DE
- Sharing a file or folder
- Step 1: Share the file or folder
- Step 2: Select the recipients
- Step 3: Changing the permission level
- Unsharing a file or folder in the Data window
- Sharing Data Files Via Public Links
- Creating a public link in the Data window
- Managing your public links in the Manage Links window
- Creating Shared Path Folder Links
- Accessing Shared Files and Folders
- Problems?
- Unsharing Files and Folders
- Changing and Viewing Data Permission Levels in the DE
- Changing the permission level for a data item in the DE
- Viewing the permission level for a data item in the DE
- Viewing Genome Files in the Genome Browser, CoGe, and Tree Viewer
- Viewing Genome Files in CoGe
- Viewing Genome Files in a Genome Browser
- Viewing Newick Files in the Tree Viewer
- About Reference Genomes
- Using Metadata in the DE
- Adding and editing metadata in the DE
- Copying metadata to a different file or folder you own
- Saving metadata from any file or folder to a separate file
- Importing iRODS (additional) metadata to the CyVerse metadata database in the DE
- Using metadata templates
- Applying a metadata template
- Downloading a metadata template
- Adding bulk metadata to multiple files or folders
- Searching for metadata in files and folders
- Using Data Tags and Tag Descriptions
- Opening New Data Windows
- Creating New Files and Folders
Fix or improve this documentation
- Search for an answer: CyVerse Learning Center
- Ask us for help: click on the lower right-hand side of the page
- Report an issue or submit a change: Github Repo Link
- Send feedback: Tutorials@CyVerse.org
- Live chat/help: Click on the on the bottom-right of the page for questions on documentation