Stories for the research portal release of 31 dec 2011

These are user stories from LifeLines and PanaceaProject?.

Scenario 1: using catalog to browse and requests study data

Module/Catalogue?

Stories:

• StoryCreateBiobankCatalog -
• StoryBrowseCatalogAndSelectFeatures - User can browse and select features in a treeview; Selected features are put in shopping cart.
• StoryRequestData? - User can request access to data set; Includes summary of research, power calculation, etc.
• StoryApproveRequest? - LifeLines approves request; selected features and targets is passed to scenario 2.

Error: Failed to load processor YumlUseCase

No macro or processor named 'YumlUseCase' found

Scenario 2: provide a Molgenis Research Portal for a study

Module/Installer?

Stories:

• StoryConvertPhenoData - prepare the pheno data in pheno format
• StoryImputeGenoData - impute the raw genotype data (future)
• StoryConvertGenoData - prepare geno data set(s) in binary and plink format
• StoryNewMolgenisVm - create VM with the app and autoload data, users, firewall.
• (LifeLInes) StoryLinkWomToVm - coordinate with UMCG-ICT to link VM to WOM

Overview:

Error: Failed to load processor YumlUseCase

No macro or processor named 'YumlUseCase' found

Scenario 3: user can access data via research portal

Module/ResearchPortal?

• StoryBrowseAndSelectFeatures? - User can browse and select features in a treeview; Selected features are put in shopping cart.
• StoryViewAndFilterInMatrix - user can browse and filter data in matrix view; repeated values can be made cols/rows
• StoryDownloadAsPlink - user can select one feature and download with associated genotypes
• StoryDownloadAsSpss? - use can select multiple features and download as spss
• StoryRunGwasAnalysis?

Error: Failed to load processor YumlUseCase

No macro or processor named 'YumlUseCase' found

As LL team we want to provide a Molgenis Research Portal for each study

Scrum: ticket:949

Acceptance criteria:

• When a VM is rolled out, a Molgenis-based LL Research Portal is provided within it
• Based on the study request, this Portal will be filled with content (How do we know which content to load? Where does this happen?)
• Targets, protocols and measurements are retrieved from some location and put into the Portal. They are restricted based on the study request.
• The Portal instance contains only the pheno data that was requested for the study

Status:

We must have the imputed Third Release geno data on gpfs storage

• Harm-Jan is currently imputing; this will take another two weeks.
• After that we can upload these data (in TriTyper? format?) to gpfs.

Harm-Jan:

Op dit moment ben ik de genotype data van LifeLines release 3 aan het imputeren op het millipede cluster. Ik zal proberen deze in de gestelde twee weken klaar te hebben. Als dit allemaal is afgerond heb ik een file die voor elke SNP aangeeft wat de imputatie kwaliteit is geweest (mbv de door BEAGLE aangegeven r2 kwaliteits score), per 300 samples. Om de data spoedig te imputeren deel ik de totale dataset namelijk op in batches van ongeveer 300. Ik zal er voor zorgen dat er een koppeltabel komt die aangeeft welke sample in welke batch zit en geef daarnaast ook de gemiddelde imputatie score over alle batches. Daarnaast loont het de moeite om voor elke SNP ook de minor allele frequency (MAF) en de Hardy-Weinberg p-waarde (HWEP) te presenteren. Deze HWEP is een waarde die aangeeft of de verdeling van de allelfrequentie voor een SNP overeenkomt met de verwachte allelfrequentie verdeling voor die SNP. We hebben eerder gezien dat een lage HWEP vaak samen gaat met een lage imputatie kwaliteit (ie: door fouten in imputatie wijkt de werkelijke allelfrequentie verdeling af van de verwachte). Bovendien zijn deze waardes zijn eenvoudig uit te rekenen met de software die ik Joeri eerder heb gegeven. Daarnaast kan de MAF ook informatief zijn aangezien laag-frequente SNPs (MAF < 0.01) slecht geimputeerd worden in de huidige setting, aangezien de referentie dataset slechts 90 samples bevat.

Morris:

2 vraagjes:

(1) Wat is de preciese imputatie procedure? (of verschilt die niet van wat Alex doet)? We moeten onderzoekers namelijk precies kunnen vertellen wat ze krijgen.

(2) Dit is namelijk iets wat LifeLines straks gewoon zelf moet kunnen (dwz Alex pipeline werkt al op compute dus als die identiek is hebben we 'go').

@Joeri: het zou mooi zijn alle info die HarmJan? nu noemt dus ook getoond kunnen worden. Je zou HWE en MAF kunnen zien als features, elke SNP als target, en dan dus values voor elke combo.

We need to be able to link geno to pheno data

Proposal by Jan-Lucas:

Uitgangspunten:

1. Marcel spreadsheet bevat LLPatient ID's en Marcel Pseudoniemen (gekoppeld).
2. LL PatientID's gaan niet van LRA naar Target Stage.
3. Target Stage bevat LL bronpseudoniem.
4. Voor onderzoek wordt LL bronpseudoniem vervangen door onderzoekpseudoniem.

Voorstel zelf:

1. Marcels spreadsheet wordt geimporteerd in LRA, indien niet mogelijk in aparte database.
2. Bij aanmaken dataset in UMCG Publish voor een onderzoek wordt Marcels spreadsheet op dezelfde manier gepseudonimiseerd als de LRA data, van Patient ID naar bronpseudoniem naar onderzoekspseudoniem. Dit levert lijst op met onderzoekspseudoniem en Marcelpseudoniem.
3. Lijst gaat mee in data export/import naar CIT Publish.
4. Op CIT publish komt een view die vertaling maakt van Marcelpseudoniem naar onderzoekspseudoniem per onderzoek. View kan relatoneel zijn, maar ook XML opeleveren.
5. Op CIT publish komt een database procedure voor legen van tabel met pseudoniemen.
6. Als LRA dat op CIT Publish staat wordt view uitgelezen, op basis hiervan kan procedure "replace pseudonyms" uitgevoerd worden (uit Gert-Jans PPTX).
7. Na procedure "replace pseudonyms" wordt eventueel aangemaakte file met pseudoniemen verwijderd. (Bij voorkeur heeft procedure die lijst in memory, maar als in file dan moet deze verwijderd.
8. Na procedure "replace pseudonyms" wordt tabel met pseudoniemen geleegd voor dat onderzoek, dan met aanroepen database procedure.

We must be able to initiate a GWAS run from the Research Portal

Proposed flow by Morris:

precondition:

• De research portal heeft toegang tot een genofile (meteen plink format + binary format) met daarin dezelfde individual pseudonyms als in de pheno database. Of kunnen we hier beter alleen de xQTL binary file voor gebruiken?
• Deze genodata wordt dus vooraf al per research portal met de juiste pseudoniemen klaargezet (=SOP genodata). De portal hoeft dus niet zelf de pseudonimisatie te raadplegen.
• De VM draait direct bovenop het cluster en heeft via dat cluster toegang tot GPFS. Elke research portal heeft dus een folder zoiets als /gpfs/target/lifelines/study1/rawdata/study1.bed

logica:

• Als de gebruiker het phenotype heeft geselecteerd gaat programma dus, gegeven lijst van individuen, de gehele bed (?) file doorlopen en (1) rijen weglaten van individuals die niet in de view zitten en (2) de pheno kolom aanpassen met het juiste phenotype.
• Implementatie is afhankelijk van hoe lang dit proces duurt. Is het 'klaar terwijl je wacht' dan kan het gewoon als plugin. Anders moet het via MOLGENIS compute zoals Joeri beschrijft. Output: /gpfs/target/lifelines/study1/results/myselection1.bed

Acceptance criteria:

• List of individuals and selected phenotype are passed from the Portal