Frequently Asked Questions (FAQ)

What does the application do?

Input

What does LENS take as input?
Why is my gene entry not recognized in your database?

Data sources

What is the source of GWAS association data?
What is the source of Pathways data?
What is the source of Drugs data?
What is the source of Diseases data?
What is the source of Interactions data?
Are any of the data manually curated?
How often are the data annotations updated?

Interactome visualization

Can I see more information about the genes and interactions in the network?
What is the layout format that is applied on the network with "Auto Layout"?
There are too many nodes on the network. What can I do to visualize it without it be too cluttered?
Can I zoom the network diagram?
Can I select multiple nodes for moving/scaling?

Download/Share results

Can I download the results?
How can I share my results with a collaborator?

Network Statistics

How are the network statistics calculated?

Statistics of overlaps with GWAS and diseases, drugs, pathways, and GWAS

Are significance tests the same with each of these datasets?
Can I see the significance of overlap with all the genes in the network with these pathways, etc?
How is the statistical significance computed? Why are specific diseases, drugs, pathways and GWAS are shown?

Customizing results

What is the "Links" tab for?
How do I change the title?
How do I save changes to my results?
Why can't I edit the notes?
Why can't I change the title?

Answers

What does LENS do?

LENS takes lists of human genes and links them together by protein-protein interactions, and performs enrichment analyses on the resulting network.

Input

What does LENS take as input?

LENS takes one or two lists of genes, entered one gene per line. The genes may be HGNC-approved symbols, Entrez ids, or Uniprot ids. All elements in the list should be of the same type of ID. You can also give input genes by choosing a disease, drug, pathway or GWAS from the text box on the right. The text box offers auto-complete options. When you select one of these options, the genes associated are automatically loaded into the box on the left.

Why is my gene entry not recognized in your database?

There are two common causes of this issue:

  1. If you are using gene symbols, you are not using anHGNC-approved symbol.
    You can try looking for your gene in the HUGO Gene Symbol Database.
  2. LENS only has information on the human interactome. You may be providing non-human genes/proteins.

Data Sources

What is the source of GWAS association data?

GWAS data comes from the NHGRI GWAS catalogue. LENS combines results from multiple GWASs so long as they are examining the same trait.

What is the source of pathways data?

Pathways and their associated genes are collected from REACTOME.

What is the source of drugs data?

Drugs and their target genes are collected from DrugBank.

What is the source of diseases data?

Diseases and their associated genes are collected from the KEGG DISEASE Database.

What is the source of tnteractions data?

Protein-protein interactions are collected from biophysical interactions found in HPRD and BioGRID.

Are any of the data manually curated?

We do not manually evalute any of the data we aquire from other databases, and we rely on their methods for data curation.

How often are the data annotations updated?

We update our local copies of these databases once a month.

Interactome visualization

Can I see more information about the genes and interactions in the network?

If you click on any circle representing a gene, or any line between genes, you will be linked to Wiki-Pi for more information on the gene or interaction.

What is the layout format that is applied on the network with "Auto Layout"?

We use a force layout provided by Data Driven Documents (d3)

There are too many nodes on the network. What can I do to visualize it without it be too cluttered?

The number of nodes can be reduced by clicked the "Hide Non-connecting Nodes" button. This will remove all gray circles that are not part of a shortest path. You may also consider reducing the number of genes you give as input, or move genes from the candidate gene list to the target gene list.

Can I zoom the network diagram?

LENS uses a semantic zoom method. If you scroll within the network view, the distance between connected genes can be increased or decreased.

Can I select multiple nodes for moving/scaling?

Clicking and dragging in the white-space of the interactome will allow you to select mutliple genes, which will be outlined in green. You can then move, scale, or reapply the layout to just those selected genes. You can make multiple selections by holding the shift-key while clicking and dragging. Clicking anywhere within the whitespace without dragging will clear the selection.

Download/Share results

Can I download the results?

Several files are available for download:

How can I share my results with a collaborator?

LENS saves your results indefinitely, and they can be shared with a static URL. While your results are being computed, you can see two URLs: one for viewing and sharing your results, and another for viewing and editing your results. You can send the "view and share" link to collaborators to show them the results, or send the "view and edit" link to allow colaborators to add their own notes.

Network Statistics

How are the network statistics calculated?

The average shortest path length is the average shortest path distance from each candidate gene to its nearest candidate neighbor, or target neighbor if target genes were given. Multiple paths between nodes of equal length are not double counted. If a node is entirely disconnected, the distance between it and its nearest neighbor is 17. Shortest path lengths taken into account are only from candidate genes to their neighbors; disconnected target genes do not affect the average. This also applies to the number of disconnected nodes reported. That is, only the number of disconnected candidate genes is given.

These numbers, alone, may not be very informative. To put them in perspective, the same numbers are reported for randomly generated networks. If only candidate genes were provided, five networks are generated using randomly selected genes in equal number to the original input size. The minimum shortest path length, average shortest path length, and number of disconnected nodes are averaged from the five networks and reported. If target genes were given, three sets of random networks are generated for more comparisons. The first selects random candidate genes as before, but retains the list of target genes. The second keeps the candidate genes from the input and randomizes the target genes. The last randomizes both gene sets.

Statistics of overlaps with GWAS and diseases, drugs, pathways, and GWAS

Are significance tests the same with each of these datasets?

Because we store gene associations as true/false values, the procedure for testing for significance is the same for each dataset.

Can I see the significance of overlap with all the genes in the network with these pathways, etc?

By default, when you view the overlaps you will see only the enrichment for candidate genes. To see the overlap with the entire network, click the "Entire Network" button in the overlap view.

How is the statistical significance computed?

The p-value for statistical significance for LENS is computed using a hypergeometric distribution.

Why are specific diseases, drugs, pathways and GWAS are shown?

Any disease, drug, pathway or GWAS with at least one associated gene in the candidate genes given by the user, or in the interactome generated by LENS, will be displayed and have a p-value computed.

Customizing results

What is the "Links" tab for?

The Links tab contains two links to your results - one allows people to view your results and make changes to the notes and title, and the other will let users view the results but not make changes. You can bookmark these links for your own use, or send them to others to let them see your findings.

How do I change the title?

If you have the link to edit the results, at the top of the page you should see text that says, "Click here to change the title." Clicking the title will turn it into a text-box for you to edit. When you're done, you can click anywhere outside of the text box to apply the change. Don't forget to save the changes if you want it to be persistent though.

How do I save changes to my results?

If you are using the link to edit your results, you should see a button beside the Download link that says, "Save View". If you click this button, any changes to the title and notes will be viewable to anyone with a link to your results.

Why can't I edit the notes?

If you can't edit the notes page, you are not using the link that allows you to edit the results. Double check the link you used to get to the page.

Why can't I change the title?

If you can't change the title, you are not using the link that allows you to edit the results. Double check the link you used to get to the page.