Home | NLM » LHNCBC » SKR » API |
Please Note
This software is produced by an agency of the U.S. Government, and
by statute is not subject to copyright in the United States. Recipients
of this software assume all responsibilities associated with its
operation, modification, and maintenance.
|
Users are responsible for compliance with the UMLS Metathesaurus
License Agreement.
To use the SKR Web API, you must have accepted the terms of the UMLS Metathesaurus License Agreement, which requires you to respect the copyrights of the constituent vocabularies and to file a brief annual report on your use of the UMLS. You also must have activated a UMLS Terminology Services (UTS) account. For information on how we use UTS authentication please select the Info icon to the right: For details of the licenses see the UMLS Metathesaurus License Agreement and How to License and Access the Unified Medical Language System® (UMLS®) Data. |
Change History | ||
---|---|---|
Version 1.3 | Initial Public Release | September 6, 2007 |
Version 1.4 | Minor Change Release (Updated defaults) | July 2, 2008 |
Version 1.5 | Minor Change Release (Updated defaults) | July 30, 2009 |
Version 2.0 | Updated for UTS Authentication and Simplified | June 15, 2011 |
Version 2.1 | Updated to allow looping calls without re-authentication | June 1, 2012 |
Version | Notes | Sizes | |
---|---|---|---|
2.1 | Libraries, Examples, Documentation, and all Source Code | 1.3MB |
The SKR Web API has been designed to allow you to interact with our web-based Scheduler using our Batch and Interactive facilities. Interactive access is currently only available for the MetaMap and SemRep programs.
There are six example programs included in the "examples" directory to illustrate how to incorporate the SKR Web API into your application. Two of the examples (GenericBatch.java and GenericBatchNew.java) show how to access the Scheduler Batch facility. MMInteractive and SRInteractive.java examples show how to access Interactive MetaMap and Interactive SemRep respectively. The last two examples GenericBatchUser.java and MMInteractiveUser.java illustrate how to
specify the username and password within the program to eliminate the need for
prompting when running.
For a list of the available options, please select the appropriate program name:
MetaMap and
MTI.
GenericBatch.java
Example program for submitting a new Generic Batch with Validation job
("GenericObject(true)" turns on validation) request to the Scheduler to
run. You will be prompted for your username and password and if they
are alright, the job is submitted to the Scheduler and the results are
returned in the String "results" below.
This example shows how to setup a basic Generic Batch with Validation job with a small file (sample.txt) with ASCII MEDLINE formatted citations as input data. You must set the Email_Address variable and use the UpLoad_File to specify the data to be processed. This example also shows the user setting the SilentEmail option which tells the Scheduler to NOT send email upon completing the job. This example is set to run the MTI (Medical Text Indexer) program using the -opt1L_DCMS and -E options. You can also setup any environment variables that will be needed by the program by setting the Batch_Env field. NOTE: The "-E" option/argument is very important and should be included with whatever program (MetaMap, SemRep, MTI) you decided to run! The reason is that this version of the Generic Batch does validation and the -E option tells the various programs to include a marker denoting when a successful result has been found. |
GenericBatchNew.java
Same as GenericBatch.java above, except you can enter any of the
options and the inputfile on the command line. The usage of the
program and available options are listed below:
usage: GenericBatchNew [options] inputFilename allowed options: --email <address> : set email address. (required option) --command <name> : batch command: metamap, semrep, etc. (default: MTI -opt1_DCMS -E) --note <notes> : batch notes --silent : don't send email after job completes. --silent-errors : Silent on Errors --singleLineInput : Single Line Delimited Input --singleLinePMID : Single Line Delimited Input w/ID --priority : request a Run Priority Level: 0, 1, or 2 |
MMInteractive.java
This example shows how to setup a basic Interactive MetaMap request.
This runs the latest version of MetaMap with 1011 (2010AB) version
of the UMLS Metathesaurus ("KSOURCE", "1011"), with "ignore_word_order" (-i)
and "all_derivational_variants" (D) set as arguments to MetaMap. The
default "Human Readable" output will be produced.
NOTE: The "-E" option/argument is NOT required for Interactive use. |
SRInteractive.java
This example shows how to setup a basic Interactive SemRep request.
This runs the latest version of SemRep with Full Fielded Output (-D).
NOTE: The "-E" option/argument is NOT required for Interactive use. |
GenericBatchUser.java This example is the same as "GenericBatchNew.java" above, except that the username and password are set in the program so that the user is not prompted when the program runs. Please Note: Although we understand the operational need for being able to specify the username and password within a program, you must also be aware of the security risks when using this setup. Please take care to secure the software you create using this option. |
MMInteractiveUser.java This example is the same as "MMInteractive.java" above, except that the username and password are set in the program so that the user is not prompted when the program runs. Please Note: Although we understand the operational need for being able to specify the username and password within a program, you must also be aware of the security risks when using this setup. Please take care to secure the software you create using this option. |
Required Fields | |||
---|---|---|---|
General Description | Name | Type | |
Email Address | Email_Address | String | |
File to Upload | UpLoad_File | String |
GenericObject myGenericObj = new GenericObject();
myGenericObj.setField("Email_Address", "yourEmailAddress");
myGenericObj.setField("SilentEmail", true);
myGenericObj.setField("Batch_Command", "MTI -opt1L_DCMS -E");
myGenericObj.setField("UpLoad_File", "./sample.txt");
try
{
String results = myGenericObj.handleSubmission();
System.out.print(results);
} catch (RuntimeException ex) {
System.err.println("");
System.err.print("An ERROR has occurred while processing your");
System.err.println(" request, please review any");
System.err.print("lines beginning with \"Error:\" above and the");
System.err.println(" trace below for indications of");
System.err.println("what may have gone wrong.");
System.err.println("");
System.err.println("Trace:");
ex.printStackTrace();
} // catch
(1.2 mb) | Presentation from NLM APIs Webinar on SKR Web API, April 2012 |
(12.8 mb) | Presentation from NLM APIs Webinar on SKR Web API, April 2012 (PDF version, no slide animations) |
Last Modified: June 01, 2012 | ii-public2 | |||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
Lister Hill National Center for Biomedical Communications | U.S. National Library of Medicine | National Institutes of Health | ||||||||||||||||||||||||||||
Department of Health and Human Services |