help:faq [2011/02/24 09:59]
hpm (172.22.10.43) |
help:faq [2013/08/21 11:06] (current)
hpm (172.22.68.212) |
| | Answers to frequently asked questions (FAQs) about the Web Services provided by EMBL-EBI. | | Answers to frequently asked questions (FAQs) about the Web Services provided by EMBL-EBI. |
| | | | |
| - | If you have a question that is not answered here please contact [[http://www.ebi.ac.uk/support/index.php?query=WebServices|EBI Support]]. | + | If you have a question that is not answered here please contact [[http://www.ebi.ac.uk/support/index.php?query=WebServices|EMBL-EBI Support]]. |
| | + | |
| | + | ===== Staying Informed ===== |
| | + | |
| | + | To stay informed about updates and changes to the EMBL-EBI Web Services, and scheduled maintenance to the EMBL-EBI website and services we suggest: |
| | + | |
| | + | * Keep an eye on the [[:about:news|Web Services News]] ([[http://www.ebi.ac.uk/Tools/webservices/feed.php?linkto=current&mode=list&ns=about&type=rss2|RSS]] or [[http://www.ebi.ac.uk/Tools/webservices/feed.php?linkto=current&mode=list&ns=about&type=atom1|Atom]]). |
| | + | * Subscribe to the [[http://listserver.ebi.ac.uk/mailman/listinfo/ws-users|ws-users mailing list]]. This is a low volume mailing list containing service announcements and notification of appropriate training events. |
| | + | * Follow [[https://twitter.com/#!/emblebi|emblebi]] and/or [[https://twitter.com/#!/emblebies|emblebies]] on [[http://twitter.com/|Twitter]]. |
| | + | * "Like" [[http://www.facebook.com/EMBLEBI|EMBL-EBI]] on [[http://www.facebook.com/|Facebook]]. |
| | | | |
| | ===== How do I use these services? ===== | | ===== How do I use these services? ===== |
| | | | |
| | The Web Services provided by EMBL-EBI are limited to one sequence (e.g. the query sequence for a sequence similarity search), or one set of sequences (e.g. the set of sequences to be aligned for a multiple sequence alignment), per job. Thus if you wish to analyse multiple sequences you will have to submit multiple jobs. | | The Web Services provided by EMBL-EBI are limited to one sequence (e.g. the query sequence for a sequence similarity search), or one set of sequences (e.g. the set of sequences to be aligned for a multiple sequence alignment), per job. Thus if you wish to analyse multiple sequences you will have to submit multiple jobs. |
| | + | |
| | + | **Please note**: We kindly ask all users to submit **NO MORE THAN 25 JOBS AT THE TIME AND NOT TO SUBMIT MORE JOBS UNTIL YOU HAVE OBTAINED RESULTS FOR THE LAST 25**. There are many people using these services and a fair share policy has been implemented that allows us to block users that submit jobs in a manner that prevents others from using the service. This block may affect access to the EMBL-EBI Web Services for an entire organisation or a class B or C subnet. Also make sure you **USE A REAL EMAIL ADDRESS** in your submissions. Using a fake email means we cannot contact you and will very likely result in your jobs being killed and your IP, Organisation or entire domain being black-listed. We do apologise for any inconvenience this may cause. |
| | | | |
| | === Multiple sequences per-file === | | === Multiple sequences per-file === |
| | | | |
| - | For some services the supplied clients support input of multiple sequences in the [[http://www.ebi.ac.uk/2can/tutorials/formats.html#fasta|fasta sequence format]]. This has to be specifically enabled using a flag, see the client help for details. | + | For some services the supplied clients support input of multiple sequences in the [[http://www.ebi.ac.uk/2can/tutorials/formats.html#fasta|fasta sequence format]]. This has to be specifically enabled using a flag, see the client's help/usage information (typically accessed using the ''--help'' option) for details. |
| | | | |
| | === File per-sequence === | | === File per-sequence === |
| | A simple way to do this is to create a set of files containing one sequence per file, and then loop over the files submitting each one, and getting the result. | | A simple way to do this is to create a set of files containing one sequence per file, and then loop over the files submitting each one, and getting the result. |
| | | | |
| - | To split a file containing multiple fasta formatted sequences use the following scripts: | + | To split a file containing multiple fasta formatted sequences into a set of files each containing a single sequence the following methods can be used: |
| - | * UNIX and UNIX-like environments: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/fsplit.sh|fsplit.sh]] | + | * Use the [[http://emboss.open-bio.org/rel/rel6/apps/seqretsplit.html|EMBOSS seqretsplit]] program, part of [[http://emboss.open-bio.org/|EMBOSS]], a collection of sequence manipulation and analysis tools. |
| - | * MS Windows: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/fsplit.bat|fsplit.bat]] | + | * Use a script which uses the ''csplit'' utility. The ''csplit'' program is available as part of the [[http://www.gnu.org/software/coreutils/|GNU coreutils]] package, for MS Windows a pre-complied version is available: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/csplit.zip|csplit.zip]]. See the following scripts for example usage: |
| - | | + | * UNIX and UNIX-like environments: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/fsplit.sh|fsplit.sh]] |
| - | These scripts require the ''csplit'' program. The ''csplit'' program is available as part of the [[http://www.gnu.org/software/coreutils/|GNU coreutils]] package, for MS Windows a pre-complied version is available: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/csplit.zip|csplit.zip]]. | + | * MS Windows: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/fsplit.bat|fsplit.bat]] |
| | | | |
| | To following scripts illustrate how to submit the jobs: | | To following scripts illustrate how to submit the jobs: |
| - | * UNIX and UNIX-like environments: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/wsbatch.sh|wsbatch.sh]] | + | * UNIX and UNIX-like environments: |
| | + | * Dispatcher: [[http://www.ebi.ac.uk/Tools/webservices/downloads/util/wsbatch.sh|wsbatch.sh]] |
| | + | * JDispatcher: [[http://www.ebi.ac.uk/Tools/webservices/download_clients/util/jdispatcher_file_per-sequence_batch.sh|jdispatcher_file_per-sequence_batch.sh]] |
| | + | |
| | + | The following parallel job running tools may also be useful: |
| | + | |
| | + | * [[http://www.gnu.org/software/make/|GNU make]] |
| | + | * [[http://www.gnu.org/software/parallel/|GNU Parallel]] |
| | + | * [[http://www.maier-komor.de/xjobs.html|xjobs]] |
| | | | |
| | === Workflow systems === | | === Workflow systems === |
| | | | |
| - | Workflow systems support a number of forms of automated bulk analysis. See [[http://www.ebi.ac.uk/Tools/webservices/tutorials/07_workflows|Workflows and Web Services]]. | + | Workflow systems (e.g. [[https://kepler-project.org/|Kepler]], [[http://www.taverna.org.uk/|Taverna]] or [[http://www.trianacode.org/|Triana]]) support a number of forms of automated bulk analysis. See [[http://www.ebi.ac.uk/Tools/webservices/tutorials/07_workflows|Workflows and Web Services]] for further details. |
| | + | |
| | + | === Dedicated Tools === |
| | + | |
| | + | Dedicated analysis tools, such as [[http://www.blast2go.com/|Blast2GO]], may also use web services to provide some functionality or to perform a specific analysis. See their documentation for details. |
| | | | |
| | ===== How do I specify a proxy? ===== | | ===== How do I specify a proxy? ===== |
| | * Scheduled maintenance which affects services you are using. | | * Scheduled maintenance which affects services you are using. |
| | * Deprecation and retirement of a service you are using. | | * Deprecation and retirement of a service you are using. |
| - | As described in our [[http://www.ebi.ac.uk/Information/termsofuse.html|Terms of Use]] this information is not provided to anyone else, nor will we contact you except for the reasons stated above. | + | As described in our [[http://www.ebi.ac.uk/about/terms-of-use|Terms of Use]] this information is not provided to anyone else, nor will we contact you except for the reasons stated above. |
| - | | + | |
| - | If you use a fake e-mail address then we will not be able to contact you and will very likely result in your jobs being killed and your IP, Organisation or entire domain being black-listed, see [[http://www.ebi.ac.uk/Information/termsofuse.html|Terms of Use]]. | + | |
| - | | + | |
| - | ===== Staying Informed ===== | + | |
| - | | + | |
| - | To stay informed about changes to the EMBL-EBI web services and scheduled maintenance we recommend: | + | |
| - | | + | |
| - | - Keep an eye on the [[:about:news|News page]]. There are RSS news feeds associated with the page if you want to see changes in your news reader. | + | |
| - | - The [[http://listserver.ebi.ac.uk/mailman/listinfo/ws-users|ws-users mailing list]]. This is a low volume mailing list containing service announcements and notification of appropriate training events. | + | |
| | | | |
| | + | If you use a fake e-mail address then we will not be able to contact you and will very likely result in your jobs being killed and your IP, Organisation or entire domain being black-listed, see [[http://www.ebi.ac.uk/about/terms-of-use|Terms of Use]]. |
| | | | |
| | | | |
