Files Overview

You can add, store, rename, and move files within a PHC project. The File Service FAQ provides more details on files in PHC.

Add a File

1. On the left side of PHC, click the Files tab.

2. Click Add File to open the dialog box.

3. Navigate to the desired file and click Open.

4. Confirm that the file appears in the list of All Files.

   Note: PHC will not upload a file with the same name as an existing file.

   

Renaming a File

Files can be renamed. Besides being able to customize the name, renaming allows the user to place the file in a folder.

To rename a file:

1. Hover your cursor over the file name until the purple toolbar appears.

2. Click the rename icon .

   

3. In the window that opens, the existing file name is displayed. Simply click in the textbox and edit the name.

4. Click Save.

Folders

Files can be organized into folders. When a file is added, it comes in at the root level.

Placing a File into a Folder

1. Hover your cursor over the file name until the purple toolbar appears.

2. Click the rename icon .

   

3. In the window that opens, the existing file name is displayed. Simply click in the text box and edit the name using the following format: folder_name/file_name. The folder name can be a new name or it can be the name of an existing folder. In the example below, we created a new folder by adding "winter_hack/" in front of the file name.

   

4. Click Save.

   The image below shows our new folder was successfully created and our file is located inside of it.

   

You can go several levels deep with folders, simply by adding more folder_name/ before the existing folder path. In the example below, we typed in the file name test/winter-hack/20200217-winter-hackTCGA-A1-A0SB-variant(1).

Moving a File out of a Folder and back to the Root Level

1. Follow the steps for renaming a file and rename it with a leading /, such as /file_name.
2. Click Save.

note

While there is no way to delete a folder, empty directories will disappear within a day.

Access

You can interact with Files in the PHC with the following methods:

• Add File button in PHC Web Console - Add a file to PHC with the Add File button in the PHC web console.
• SFTP upload to a Project in PHC Web Console - Create a location in a project that allows the transfer of files into a project over SFTP in the PHC web console.
• Transfer Amazon S3 Files with PHC Web Console - Configure direct S3 to S3 transfers in PHC.
• LifeOmic Files API - Use the HTTPS API to upload data with TLS.
• LifeOmic CLI - Use a command-line interface to upload data through the API.
• PHC SDK for Python - Use Python to upload data through the API.