DOCK Blaster:FAQ: Difference between revisions

From DISI
Jump to navigation Jump to search
No edit summary
 
(61 intermediate revisions by 3 users not shown)
Line 1: Line 1:
DOCK Blaster FAQ
[[DOCK Blaster]] is a free virtual screening service. These are the frequently asked questions. Questions that take more than a few lines deserve their own wiki article.  Other FAQs are available at this site as follows:
* [[ZINC:FAQ]]
* [[DUD:FAQ]]
* [[DOCK:FAQ]]
* [[THC:FAQ]]
* [[FAQ]] for everything not covered by one of those products.


== Q1. What is DOCK Blaster? ==
= General =  
DOCK Blaster is a free service for molecular docking and virtual screening. It uses UCSF DOCK 3.5.54 as a docking engine, and ZINC as a dockable database. It runs entirely on our 400 CPU cluster in San Francisco. The interface is an expert system that tries to help you get results you can use. We hope to publish a paper in 2007.


== Q2. How do I use DOCK Blaster? ==
== What is DOCK Blaster? ==  
You need a structure of your target, and an indication of the binding site you want to target. The target should be in PDB format, and must conform to certain rules (see [[Preparing Input]]. The binding site indicator is ideally a docked ligand in mol2 format, but could also be residues surrounding the binding site in PDB format. Point your browser to blaster.docking.org, enter your data, and click "I agree, DOCK!".
DOCK Blaster is a free web-based service for molecular docking and virtual screening. It uses [[UCSF]] [[DOCK 3]] as a [[docking engine]], and [[ZINC]] as a [[dockable database]]. It runs entirely on the [[About our cluster | computer cluster ]] in the [[Shoichet Lab]] at [[Mission Bay]] in San Francisco. The graphical user interface comprises an expert system that is designed to help guide both novices and experts to useful results.


== Q3. How much does DOCK Blaster cost to use? ==
== Is DOCK Blaster formally described in a paper? How to cite? ==
DOCK Blaster is completely free. It is supported by NIH grant GM 71896 (to BKS and JJI).


== Q4. I'm having trouble using DOCK Blaster ==
The performance of DOCK Blaster against benchmarking data is described in Irwin, Shoichet, Mysinger et al., "Automated docking screens: a feasibility study", J. Med. Chem (2009), in press.  The documentation of the interface and the software that runs it is documented on this wiki.
There are broadly speaking three kinds of problems
1. The site is broken or seems to be acting incorrectly. If so, please write to support at docking.org, describing the problem, so we can fix it.
2. You cannot get a job to start, because DOCK Blaster complains about your input. We have tried to make the error messages as descriptive as possible. Please attempt to follow them. However, if you are not making progress after you have tried 5 times to correct your input, please email support at docking.org, including your JOB ID number if available, so that we can look at the problem.
  3. The job has run, but you cannot understand what to do with the results.  


== Q5. Can I trust DOCK Blaster? ==
== Why DOCK Blaster? Docking programs have been around for ages. What's new? ==
You are wise to be cautious about trusting the results produced by DOCK Blaster. Molecular docking and virtual screening methods are notoriously succeptible to many possible failures due to the numerous approximations made in the calculations. We recognize this inherent skepticism, and have therefore attempted to provide tools with which you can reassure yourself that DOCK Blaster results really are worth investigating - or not, as the case may be.
We aim to serve a constituency of investigators who would like to use docking to discover new ligands for their targets, but find the barriers to setting up their own computational lab prevent them from doing so. Experts are still welcome to use DOCK Blaster, of course. But we are really aiming to serve biologists who seek new chemistry for their biological targets.


Here is the evidence we will gather to investigate the calculation:
== How do I use DOCK Blaster? ==
1. score of the supplier ligand in its supplied pose
2. ability to re-dock the supplied ligand
3. score & pose of similar ligands, drawn from ZINC
4. score & pose of property-matched, dissimilar ligands drawn from ZINC
5. score of extrema ligands
6. score of actives, if supplied
7. score of inactives, if supplied
8. appearance of top scoring ligands from the lead-like or fragment-like database.


Now, we review how to evaluate the above results in order to estimate whether the results are worth pursuing, for example, by purchasing compounds.
Please see [[DOCK Blaster | What you need to start]].


== How much does DOCK Blaster cost to use? ==
DOCK Blaster is free. It is supported by the US National Institutes of Health via grant GM71896 (to JJI and BKS). We reserve the right to limit usage by intensive users.


== What do I do if I am having trouble using DOCK Blaster? ==


== Q6. I think DOCK Blaster has crashed on my job ==
If you began by uploaded a receptor file, aka "Start with a structure", by far the most common problem is with the formatting of the files.  We recommend reading [[DOCK_Blaster:Prepare_Input | this]] and also looking at some [[DOCK_Blaster:Tutorials | examples]] and also [http://data.docking.org sample data].
Normally, DOCK Blaster should recover from a crash, and do two things:  
1. inform the site manager that a crash occurred.
2. email the originator of the job, if an email address was supplied.  


Sometimes this email may not be sent for up to 3 hours after a crash. It is possible that the email sending itself fails.  
If you began with a PDB code, aka "Start with a PDB Code", by far the most common problem is that there is no single identifiable ligand in the file. If this is the case, you need to download the PDB file yourself, and, specifying the binding site, use the "Start with a structure" starting point.  


If you believe your job has crashed, we suggest one of two actions, depending on the nature of the crash.  
If you used "I'm feeling lucky", and you are having problems, we regret that you were not more luckyWe suggest trying "I'm feeling lucky" a couple of more times, and perhaps your luck will change.  
  1. If you believe the job crashed due to a general system failure, and not due to your calculation itself, then we recommend trying to re-run the job before contacting DOCK Blaster support. If you try again, and the job crashes at the same or similar point, then please write to support at docking.org to inform us of this so we can investigate.
2. If you believe the job crashed due to causes specific to your calculation, then please write support at docking.org right away, telling us any relevant information you think we should know.


More detailed information about problems may be found here:


== Q7. I have privacy concerns about my data ==
DOCK Blaster is a free public service, run on taxpayer-supported computers. We do not support private calculations. All calculations 


== Q8. DOCK Blaster is reporting a problem that I don't think is real/legitimate ==
* [[Problems]] page for a general overview of all problems.  


== Q9. DOCK Blaster made completely wrong suggestions for my target ==
* [[Bugs]] page for information about bugs. Please report bugs to support at docking.org.  


== Q10. Is there any evidence that DOCK Blaster works? ==
* [[DOCK Blaster:Problems]] page for DOCK Blaster specific problems.


== Q11. Why are you guys doing this, I mean, DOCK Blaster? ==
== Can DOCK Blaster be trusted? ==
Please see [[DOCK Blaster:Reliability | this]].


== Q12. Can I get my own private copy of DOCK Blaster? ==
== Has DOCK Blaster crashed? ==
Please read [[DOCK Blaster:Crash  | this]].


== Q13. Does DOCK Blaster work better on some targets than on others? ==
== Are my data private? ==
Please see our [[Privacy Policy]]


== Q14. How long does DOCK Blaster take? ==
== What should I do if I disagree with a decision DOCK Blaster has apparently made? ==
Please write to support at docking.org explaining the problem.


== Q15. What do DOCK Blaster results mean? ==
== What should I do if DOCK Blaster has made completely wrong suggestions for my target? ==
DOCK Blaster is a research tool that aims to help people discover new ligands.  Unfortunately, docking can fail for many reasons, as documented by an extensive literature. Our benchmarking studies (Irwin et al, J Med Chem, 2009) suggest that black box docking works on perhaps 18% of eligible targets.  Thus there is a rather high probability that your target is not among the successful ones.  Finally, it is important to remain skeptical of any docking results, whether they are produced by an expert or a machine like DOCK Blaster.


== Q16. Can I used DOCK Blaster with a different docking program? ==
== Is there any evidence that DOCK Blaster works? ==
DOCK Blaster uses the same docking technology (DOCK 3) and database technology (ZINC) as is used in the Shoichet Lab for all their ([http://shoichetlab.compbio.ucsf.edu/publications.php publications]). The DUD Paper (Huang, Shoichet Irwin, J Med Chem, 2006) assessed the performance of docking, some of it fully automated.  Recently, the DOCK Blaster paper (Irwin et al, J Med Chem 2009, in press) assessed fully automated docking against over 7000 targets drawn from the PDB.  The results indicate that automated docking screens produce viable-looking results perhaps 18% of the time.  Importantly, the automatic self-assessment feature of DOCK Blaster allows you to tell when this is true.


== Q17. Can I used DOCK Blaster with a different database of small molecules? ==
== What is your motivation to create and support DOCK Blaster? ==
We felt that many investigators who would like to use virtual screening were not using it because of several barriers to entry. We hope that DOCK Blaster will fill an niche and give access to this technology to investigators who previously were put off by the requirements to set up a docking laboratory.


== Q99. I have a question that isn't listed here... ==
== Can I get my own private copy of DOCK Blaster? ==
You may request a copy of DOCK Blaster by writing to John Irwin at jji at cgl dot ucsf dot edu.  We will be making the scripts available, but it will take us some time following publication (Sept 2009) to get them into a state we can release.
 
== Does DOCK Blaster work better on some targets than on others? ==
Yes. Now, which ones? The paper (Irwin et al, J Med Chem, 2009, in press) documents 1,298 targets for which DOCK Blaster produces viable-looking results. You can find these on our [http://data.docking.org website].  [http://data.docking.org/2009/TableS12.xls TableS12.xls]
 
== How long does DOCK Blaster take? ==
Submitted to an unloaded cluster, preliminary docking usually runs in 30-60 minutes.  A full database screen, which may or may not be warranted by the preliminary docking, can take hours to days, depending on the binding site and the database docked.  If the cluster is loaded it will obviously take longer to deliver results.  We aim to provide informative messages to manage your expectations.  Thank you for your patience!  More information here: [[DOCK Blaster:Timings]]
 
== What do DOCK Blaster results mean? ==
Top scoring hits from a docking screen are computer-generated predictions of small molecules that may bind to your protein. Surveying the literature, typical prediction rates from docking screens vary wildly, but are often of a rate of only a few percent, although there are famous exceptions (Doman 2002).  In a typical screen, purchasing 50 compounds selected from among the top 500, we would consider ourselves fortunate if 3 compounds showed micromolar affinity.  What this means in practice is that docking hit lists should not be simply purchased willy-nilly.  We recommend holding a [[hit picking party]] to select compounds for purchase and test based on a range of opinions.  We would be astonished to see a confirmed hit rate over 10%, meaning that we expect at least 9/10 top scoring docking compounds WILL NOT BIND.  Caveat emptor.
 
== Can I used DOCK Blaster with a different docking program? ==
Currently, DOCK Blaster only supports DOCK 3. It has not escaped our notice that the overall system may be appropriate for other docking engines. If this option interests you, please write us, making the case for a particular docking program.
 
== Can I used DOCK Blaster with my own database of small molecules? ==
Yes, to some extent.  You can upload ligands to ZINC to create an user uploaded subset, 1000 molecules at a time.  These subsets may be docked using DOCK Blaster.
 
A number of subsets of ZINC are available for docking.  We may be able to create large custom subsets to suit your purposes.  If you do not see what you need in the "by subset" page of ZINC, please write us at support at docking.org to discuss.
 
For most purposes, we recommend the use of the "fragment-like" or "lead-like" subsets of ZINC.
 
== Why is it called "DOCK Blaster"? ==
The name is a tribute to [http://www.ncbi.nlm.nih.gov/BLAST/ BLAST], the famous sequence alignment and searching tool of [http://www.ncbi.nlm.nih.gov/ NCBI]. And of course [[Portal:DOCK | DOCK]]. If you have a better name, let us know, there is a prize. ;-)
 
== What is the history of DOCK Blaster? ==
Please see [[DOCK Blaster:History]].
 
= Preparer / Scrutinizer Questions =
 
 
= Calibration Questions =
 
 
= Docking Questions =
 
 
= Results Browser and Interpretation Questions =
 
 
 
= What do I do if my question is not listed here? =
Please use 'search' to check the documentation, use google, or try to ask our panel of experts in the blaster-fans@docking.org mailing list. If you still can't get an answer, please write support at docking.org.
 
 
[[Category:DOCK Blaster]]
[[Category:FAQ]]

Latest revision as of 22:06, 5 April 2013

DOCK Blaster is a free virtual screening service. These are the frequently asked questions. Questions that take more than a few lines deserve their own wiki article. Other FAQs are available at this site as follows:

General

What is DOCK Blaster?

DOCK Blaster is a free web-based service for molecular docking and virtual screening. It uses UCSF DOCK 3 as a docking engine, and ZINC as a dockable database. It runs entirely on the computer cluster in the Shoichet Lab at Mission Bay in San Francisco. The graphical user interface comprises an expert system that is designed to help guide both novices and experts to useful results.

Is DOCK Blaster formally described in a paper? How to cite?

The performance of DOCK Blaster against benchmarking data is described in Irwin, Shoichet, Mysinger et al., "Automated docking screens: a feasibility study", J. Med. Chem (2009), in press. The documentation of the interface and the software that runs it is documented on this wiki.

Why DOCK Blaster? Docking programs have been around for ages. What's new?

We aim to serve a constituency of investigators who would like to use docking to discover new ligands for their targets, but find the barriers to setting up their own computational lab prevent them from doing so. Experts are still welcome to use DOCK Blaster, of course. But we are really aiming to serve biologists who seek new chemistry for their biological targets.

How do I use DOCK Blaster?

Please see What you need to start.

How much does DOCK Blaster cost to use?

DOCK Blaster is free. It is supported by the US National Institutes of Health via grant GM71896 (to JJI and BKS). We reserve the right to limit usage by intensive users.

What do I do if I am having trouble using DOCK Blaster?

If you began by uploaded a receptor file, aka "Start with a structure", by far the most common problem is with the formatting of the files. We recommend reading this and also looking at some examples and also sample data.

If you began with a PDB code, aka "Start with a PDB Code", by far the most common problem is that there is no single identifiable ligand in the file. If this is the case, you need to download the PDB file yourself, and, specifying the binding site, use the "Start with a structure" starting point.

If you used "I'm feeling lucky", and you are having problems, we regret that you were not more lucky. We suggest trying "I'm feeling lucky" a couple of more times, and perhaps your luck will change.

More detailed information about problems may be found here:


  • Problems page for a general overview of all problems.
  • Bugs page for information about bugs. Please report bugs to support at docking.org.

Can DOCK Blaster be trusted?

Please see this.

Has DOCK Blaster crashed?

Please read this.

Are my data private?

Please see our Privacy Policy

What should I do if I disagree with a decision DOCK Blaster has apparently made?

Please write to support at docking.org explaining the problem.

What should I do if DOCK Blaster has made completely wrong suggestions for my target?

DOCK Blaster is a research tool that aims to help people discover new ligands. Unfortunately, docking can fail for many reasons, as documented by an extensive literature. Our benchmarking studies (Irwin et al, J Med Chem, 2009) suggest that black box docking works on perhaps 18% of eligible targets. Thus there is a rather high probability that your target is not among the successful ones. Finally, it is important to remain skeptical of any docking results, whether they are produced by an expert or a machine like DOCK Blaster.

Is there any evidence that DOCK Blaster works?

DOCK Blaster uses the same docking technology (DOCK 3) and database technology (ZINC) as is used in the Shoichet Lab for all their (publications). The DUD Paper (Huang, Shoichet Irwin, J Med Chem, 2006) assessed the performance of docking, some of it fully automated. Recently, the DOCK Blaster paper (Irwin et al, J Med Chem 2009, in press) assessed fully automated docking against over 7000 targets drawn from the PDB. The results indicate that automated docking screens produce viable-looking results perhaps 18% of the time. Importantly, the automatic self-assessment feature of DOCK Blaster allows you to tell when this is true.

What is your motivation to create and support DOCK Blaster?

We felt that many investigators who would like to use virtual screening were not using it because of several barriers to entry. We hope that DOCK Blaster will fill an niche and give access to this technology to investigators who previously were put off by the requirements to set up a docking laboratory.

Can I get my own private copy of DOCK Blaster?

You may request a copy of DOCK Blaster by writing to John Irwin at jji at cgl dot ucsf dot edu. We will be making the scripts available, but it will take us some time following publication (Sept 2009) to get them into a state we can release.

Does DOCK Blaster work better on some targets than on others?

Yes. Now, which ones? The paper (Irwin et al, J Med Chem, 2009, in press) documents 1,298 targets for which DOCK Blaster produces viable-looking results. You can find these on our website. TableS12.xls

How long does DOCK Blaster take?

Submitted to an unloaded cluster, preliminary docking usually runs in 30-60 minutes. A full database screen, which may or may not be warranted by the preliminary docking, can take hours to days, depending on the binding site and the database docked. If the cluster is loaded it will obviously take longer to deliver results. We aim to provide informative messages to manage your expectations. Thank you for your patience! More information here: DOCK Blaster:Timings

What do DOCK Blaster results mean?

Top scoring hits from a docking screen are computer-generated predictions of small molecules that may bind to your protein. Surveying the literature, typical prediction rates from docking screens vary wildly, but are often of a rate of only a few percent, although there are famous exceptions (Doman 2002). In a typical screen, purchasing 50 compounds selected from among the top 500, we would consider ourselves fortunate if 3 compounds showed micromolar affinity. What this means in practice is that docking hit lists should not be simply purchased willy-nilly. We recommend holding a hit picking party to select compounds for purchase and test based on a range of opinions. We would be astonished to see a confirmed hit rate over 10%, meaning that we expect at least 9/10 top scoring docking compounds WILL NOT BIND. Caveat emptor.

Can I used DOCK Blaster with a different docking program?

Currently, DOCK Blaster only supports DOCK 3. It has not escaped our notice that the overall system may be appropriate for other docking engines. If this option interests you, please write us, making the case for a particular docking program.

Can I used DOCK Blaster with my own database of small molecules?

Yes, to some extent. You can upload ligands to ZINC to create an user uploaded subset, 1000 molecules at a time. These subsets may be docked using DOCK Blaster.

A number of subsets of ZINC are available for docking. We may be able to create large custom subsets to suit your purposes. If you do not see what you need in the "by subset" page of ZINC, please write us at support at docking.org to discuss.

For most purposes, we recommend the use of the "fragment-like" or "lead-like" subsets of ZINC.

Why is it called "DOCK Blaster"?

The name is a tribute to BLAST, the famous sequence alignment and searching tool of NCBI. And of course DOCK. If you have a better name, let us know, there is a prize. ;-)

What is the history of DOCK Blaster?

Please see DOCK Blaster:History.

Preparer / Scrutinizer Questions

Calibration Questions

Docking Questions

Results Browser and Interpretation Questions

What do I do if my question is not listed here?

Please use 'search' to check the documentation, use google, or try to ask our panel of experts in the blaster-fans@docking.org mailing list. If you still can't get an answer, please write support at docking.org.