Difference between revisions of "Galaxy Data Import"
|Line 7:||Line 7:|
The Get Data > Upload File' tool
The Get Data > Upload File' tool shows all files under <code>/ufrc/apps/galaxy/incoming/''your@email''</code> listed in the upload interface. Simply click on the checkboxes in front of the files you want to upload and then click on the 'Execute' button and the upload should commence. Once you uploaded the files please remove them from <code>/ufrc/apps/galaxy/incoming/''your@email''</code>. The above approach should be much simpler and faster than using the Large Data Upload procedure through the Incoming data library and doesn't require any changes. Please give the system at least 15 minutes to fix permissions on the newly uploaded files if they are not readable by the galaxy user.
Revision as of 19:54, 14 August 2018
Small files residing on your local machine can be easily added to a Galaxy history through the "Get Data>Upload File" tool.
However, larger files may take too long to upload directly into galaxy and all files over 2gb in size cannot be uploaded via the web browser. Those files need to be transferred to the UFRC and put under '/ufrc/apps/galaxy/incoming/your@email' directory.
The Get Data > Upload File' tool shows all files under
/ufrc/apps/galaxy/incoming/your@email listed in the upload interface. Simply click on the checkboxes in front of the files you want to upload and then click on the 'Execute' button and the upload should commence. Once you uploaded the files please remove them from
/ufrc/apps/galaxy/incoming/your@email. The above approach should be much simpler and faster than using the Large Data Upload procedure through the Incoming data library and doesn't require any changes. Please give the system at least 15 minutes to fix permissions on the newly uploaded files if they are not readable by the galaxy user.
Note: The "Incoming" library must only be used to upload data, not for storage. Please delete the uploaded datasets once they've been imported into histories. All datasets and folders in the "Incoming" shared data library may be deleted after a period of 30 days if they weren't cleaned up by the owner.
Outside of Galaxy
If the simplified upload procedure is not working then proceed with using the Incoming data library. The first part of getting a large dataset into Galaxy is to make it available to the Galaxy
- Find out your Galaxy username. Click on the "User" menu and read the "Logged in as user@hostname" line.
Create your Galaxy incoming directory
If your Galaxy username is "email@example.com" then the incoming directory you need to create is
Copy data to the Galaxy incoming directory
- You can use either command-line or GUI tools like FileZilla to transfer your data to HiPerGator for upload into Galaxy.
- Copy your data directory to the HPC directory /scratch/galaxy/incoming/user@hostname.
For instance, if your Galaxy username is "firstname.lastname@example.org" then your data directory must be copied to
/email@example.com, so in the end the data files will be inside the
directory. Substitute your actual Galaxy username and the name of the directory you copied for "firstname.lastname@example.org" and "data_dir".
- Make sure the files are readable by setting the correct access mode
Set the 755 mode for the directory and 644 for the files either from within the software you used for transferring the files or by logging into HPC and running the following commands:
cd /email@example.com chmod 755 data_dir chmod 644 data_dir/*
- To copy your data you can use scp/sftp or ask Research Computing staff via HPC Support site to get the HPC windows file share access enabled for you, so you could access the "Galaxy" file share that points to the /scratch/lfs/galaxy/incoming/ directory.
- The username is your email address. If you don't remember what email address you used for HPC account registration it can always be looked up by clicking on the User item of the Galaxy's main menu.
- Your data files must be in a single sub-directory. For instance, if that sub-directory is called test then the full path to the directory with data files of a user firstname.lastname@example.org must be
This example is for users who have Linux or MacOS and have a terminal application open:
$ ls -l drwxr-xr-x 2 user staff 68 Oct 3 14:39 data1
$ cd data1 $ ls test.fastq
$ scp test.fastq email@example.com test.fastq 100% 1439MB 3201.3KB/s 00:00
$ ssh firstname.lastname@example.org password: *********** jdoe@gator1
$ mkdir -p /email@example.com/data1 $ mv test.fastq /firstname.lastname@example.org/data1 $ cd /email@example.com $ chmod 755 data1 $ chmod 644 data1/* $ exit
Inside the Galaxy
Create your personal incoming folder
Please note that at the moment the Galaxy admins must enable shared library access for each new user. If you don't see the options listed below please email firstname.lastname@example.org and request access after your logged into Galaxy at least once.
- Move the mouse pointer to the "Shared Data" menu. A menu will open. Click on the "Data Libraries" menu item.
- The list of shared data libraries will be shown in the main window. Click on the "Incoming" data library.
- Click on the "Add folder" button in the top right corner.
- Fill out the form to create a folder named after your galaxy user name (for example email@example.com).
Create a data sub-folder
- Click on the downward pointing triangular icon immediately to the right of your folder name to access the Folder Menu and select either "Add sub-folder" if you wanted to organize your data folders. If you miss this step and end up uploading your data into the main folder of the "Incoming Data" library please click on the triangular drop-down menu symbol on the right side of the dataset name and select "Move this dataset". Select your own folder as the destination and click "Move". Please upload your datasets into your own folder to keep the main data library folder clean.
- Fill out the form to create a sub-folder as shown above.
- To navigate the Folder Tree use the solid triangle icons on the left side of the folder names.
- Click on the Folder Menu of the created sub-folder and click on "Add datasets".
- After you clicked on the "Add datasets" you will be taken to the dataset upload dialog. As a minimum choose "Upload directory of files" in the drop down "Upload option:" menu. Then, choose the data directory name to upload from the "Server Directory" menu. The name reflects the directory you copied your dat into such as /scratch/lfs/galaxy/incoming/user@name/data_directory". In addition, you can use other options in the dataset upload dialog (Convert spaces to tabs, Genome, Message). If you want to restrict access to your dataset select the appropriate roles from the Restrict dataset access to specific roles area.
- Click on the "Upload to library" button at the bottom of the window.
- After the upload is finished you will have you data in your sub-folder of the Incoming data library. You will be able to open that folder and select the appropriate datasets then make sure "Import to current history" action is chosen in the menu underneath the datasets and click on the "Go" button. The datasets will appear in your current history. Now you can do your analyses.