PGP and Tranche

From OpenWetWare
Jump to navigationJump to search

About        Projects        Publications        PersonalGenomes@Home        Public Data        FAQ        Updates (12/23)


People

Tranche

In order to increase the utility of project data and make more of it available to the public, the Personal Genome Project (PGP) has launched PersonalGenomes@Home. This effort uses ProteomeCommons.org's Tranche Network for persistent storage. The Tranche Project is a free and open source file sharing tool that enables collections of computers to easily share and cite scientific data sets. Designed and built with scientists and researchers in mind, Tranche essentially solves the data sharing problem in a secure and scalable fashion.

Tranche User Account

To apply for a user account fill out the form for a ProteomeCommons User Account. Pending applications are reviewed each business day.

System Requirements

Java Runtime Environment 5.0 or later; See System Requirements

Tranche User Guide and Instructions for Up- and Downloads

A detailed user guide can be found Tranche User Guide here.

There are three ways to add or get data from the network:

  1. GUI: Go to the Tranche homepage and click "Launch Tranche". (Requires Java 5+ with Web Start)
  2. Command-line tools: See below
  3. Java API: For custom tools development

The most popular of the three is the GUI, as it is easy to use. The command-line tools are useful for automating tasks or working in headless environments, and the API is useful when integrating Tranche in a software project or for creating a custom tool

Tranche up- and downloads can be run over the command line using the upload tool and the download tool.

wget --no-check-certificate https://proteomecommons.org/tranche/files/CommandLineAddFileTool.zip  
wget --no-check-certificate https://proteomecommons.org/tranche/files/CommandLineGetFileTool.zip   

In order to use these tools you also need a login, which you can get at ProteomeCommons.org.

Download each tool, unzip the file, go into unzipped directory, type java -jar NAME.jar --help to obtain usage information. (If java is not in your system path, add it to your path or type the full path /path/to/java -jar NAME.jar --help.

For usage information java -jar Tranche-Downloader.jar --help
Download a project with a certain hash: java -jar Tranche-Downloader.jar HASH

For usage information: java -jar Tranche-Uploader.jar --help
Upload a file:
java -Xmx521m -jar Tranche-Uploader.jar -u USER.zip.encrypted -p PASSWORD -c true -t "MY TITLE" -d "MY DESCRIPTION" /home/DataForUpload

There is the option to download/upload encrypted data:
java -jar Tranche-Downloader.jar -e supersecret HASH
java -jar Tranche-Uploader.jar -u FILE.zip.encrypted -p supersecret /home/DataForDownpload

Example scripts are provided: download script and upload script.

To get notified about changes and upgrades one can join the automated tool group for command-line tools and API.

Download PGP Data from Tranche

The public PGP data are now available on Tranche.

You have two options when downloading using the command-line tool:

1. To download using the project hash and the path information:

  java -Xmx512m -jar Tranche-Downloader.jar -r 'PATH' PROJECT_HASH 

Where PROJECT_HASH is:

  EpLF5/WBxrqUdPs3iiHA+fxbEqAX5v3drCtt9oEzY6Dzk2r+KeTpaNJxV01LHzcqoFpT4xJP5BisPvIvs8c8rx2XEzgAAAAAAmRoJA==

2. To download using the hash for the individual run (recommended):

  java -Xmx512m -jar Tranche-Downloader.jar RUN_HASH 

Where RUN_HASH can be found in the table below. This second method is recommended because it will likely be faster, as option #2 will not need to load the entire project's information.

The following are available on Tranche. Each of these paths contain directories Cn.1 n=1..36, which each contain the raw images s_lane_tile_[acgt].tif.gz, where the lane is specified in the path by L00lane (e.g. L001), and tile=1..100.


Path Hash
PGP/PGP_1/PGP_1_FC00037/PGP_1_FC_00037_L003/ Uid6OqEDTBVN2TJ77YkMxT2ni9ZkNORsZxJkBD3xs4sQiM7/ltL429u91riEC/SimhUPZrn3FJ9/vN1zUnF4ThxqqfUAAAAAACGNgg==
PGP/PGP_2/PGP_2_FC00037/PGP_2_FC_00037_L002/ sGH85bSuWIstQ12wsH1S3g4bWbupI0NG3B2VBuZmjvDfW54LzEwHYa8d1qdfq8HvDR97Bwp00T+bJvRlnI1vCysgsEwAAAAAACGNgg==
PGP/PGP_3/PGP_3_FC00035/PGP_3_FC_00035_L003/ A+T1fSJ49iUep9eYn7Tggvtohej6AOXZG9Tdiby8P0D293kKFv4AfrlAHf5dmEflWgs3IrIgmK18nrWxRWVrmuX1lO4AAAAAACGNgg==
PGP/PGP_5/PGP_5_FC00044/PGP_5_FC_00044_L002/ KVP7qsEI5ej7vH+MZGbhbhy+CCe5s7z7EUgEAXpnmtQKQS7BHUXlnGAJvKx0Z5U+S3hNRMyD0SaA0WHCzr/h/+FALvkAAAAAACGNgg==
PGP/PGP_7/PGP_7_FC00044/PGP_7_FC_00044_L004/ wJCEGtX4InEVeMAUes8WjgVar+CtjTxi79ptB+TRxJOILXbRjHBdrIvVyQ1XOucn3Wt6scVJG5L8S9l5851eWD+3BF8AAAAAACGNgg==
PGP/PGP_8/PGP_8_FC00037/PGP_8_FC_00037_L001/ /hCd4NlLnXbAmZDFgh6RdMfWk13Wp+IUEXt0sTVvd6ecm4VSLYWzj8yGQB44b5hl0QdxZA+PHfJBuS+VNv+3cMOxnhMAAAAAACGNgg==
PGP/PGP_8/PGP_8_FC00051/PGP_8_FC_00051_L002/ bzEgXZaqsGsYxyPRWGTdVbuwpONcu2QMqpSS85PeiOrQhSEKccmAHKHrT7nU5vsLUVyXqjLGzCUS2AnFVUvkXY8xf70AAAAAACGOrA==
PGP/PGP_8/PGP_8_FC00051/PGP_8_FC_00051_L006/ BYSZDtW8LiCaIg8qgRZsdeJQK+X7n556/CD84ro77wj3rp9MLQib4H/oiPSYjfnTih3CZwTDtJeJ41toR0GVWzDvJW8AAAAAACGOGA==
PGP/PGP_9/PGP_9_FC00043/PGP_9_FC_00043_L003/ vI7IzPUUfTDv2PzCm/6Ks7yiLiFJEc+IikrDZXQNmSwivAvDb0fMyKARuBYazYi5SCN/C8aAIXGqsuvKkTQYkfdvzWgAAAAAACGNgg==
PGP/PGP_9/PGP_9_FC00051/PGP_9_FC_00051_L003/ rIfl/1sK7hJWfFi5CYnhqNwZDSfZdRDUSOoTov6bD8+ovDJgA6MgaM0Lo3svZHM4DwkG4xDCG0k+dUbk5W3gI3X/iksAAAAAACGNgg==
PGP/PGP_9/PGP_9_FC00051/PGP_9_FC_00051_L007/ Qk+/y0bHvqdaBukutHqul6XPLQnbxGAxS5gwIPvzfgGeX79CNUe6nLa1K0ncdSn0Bu81n/NitPwMUvPMocaROhKHL3MAAAAAACGNgg==
PGP/PGP_10/PGP_10_FC00041/PGP_10_FC_00041_L003/ 3ZvbBigaeOnOMrJmT/vcBMo95pgNz86RXrB8UJypMStaaannHRQSnnkj3H9ojZ1VFiYO8V3ZFGdPDcOkPgzTigr4WE0AAAAAACI2RQ==
PGP/CONTROL/CONTROL_FC00035/CONTROL_FC_00035_L001/ g1BoTW5DmYTlAsG7U1hi85sXfM7+xtaIDQlEXO2ThqCwZRpgrnKp1MHRFsI2Xrv6xOEcDUcP7Z4pdUWb6ByGBk/cJ58AAAAAACLfCA==
PGP/CONTROL/CONTROL_FC00037/CONTROL_FC_00037_L008/ 1XxXtiy1EhKpWLD+1TEdPP6aXk9+WkAocknP7ZeL35I4EKgwqMeTvjDjttWNerzPjYzhgvA8yAc9CEDzEg4bYUswq+MAAAAAACLfCA==
PGP/CONTROL/CONTROL_FC00041/CONTROL_FC_00041_L001/ jxPfUwussDZ7oaZALVawVzvMM/PVIOCSFhLtYwC/S21jDBFnPuA2bdTDQLEjG6SyvH5DDFk6uPEfd79liQ9wslsjyqsAAAAAACLfpg==
PGP/CONTROL/CONTROL_FC00043/CONTROL_FC_00043_L001/ fA06Jlb13pvjiE3+LDYEhto3qjNFHdPKi9NPp5ncLaJyKbawEm15WDR2Q2J1N9vEYGCZZTCpvloRQcegjKODG6ySXOMAAAAAACLfCA==
PGP/CONTROL/CONTROL_FC00044/CONTROL_FC_00044_L001/ DP45LxBWNFtcLVsgT8bac6rjAt9xWL6/O6T403L5xzZRh5sbj+R6l7NsEmKE2v8pYPbPDSEgVDEqyRtu84DaezJ40u0AAAAAACLfCA==
PGP/CONTROL/CONTROL_FC00051/CONTROL_FC_00051_L001/ 4VwUCQCWwZj0/eGdN69UoNRVaRuTHaf1kp+YmG1QfkCMY/iMfIybj5RYXcq24fgn2hobrBIzmYuN/d3iy5XZldpu57UAAAAAACLfCA==