gov.nih.nlm.nls.lvg.Flows.ToExpansions Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lvg2010dist Show documentation
LVG tools is used by Apache cTAKES.
The newest version!
package gov.nih.nlm.nls.lvg.Flows;
import java.util.*;
import java.sql.*;
import gov.nih.nlm.nls.lvg.Lib.*;
import gov.nih.nlm.nls.lvg.Db.*;
/*****************************************************************************
* This class provides features of generating known acronym expansions for a
* specified acronym.  The input acronym is stripped punctuationand
* then lowercase before put into SQL for database query.
*
* History:
* 

* 
*
* @author NLM NLS Development Team
*
* @see 
* Design Document 
*
* @version    V-2010
****************************************************************************/
public class ToExpansions extends Transformation implements Cloneable
{
    // public method
    /**
    * Performs the mutation of this flow component.
    *
    * @param   in   a LexItem as the input for this flow component
    * @param   conn   LVG database connection
    * @param   detailsFlag   a boolean flag for processing details information
    * @param   mutateFlag   a boolean flag for processing mutate information
    *
    * @return  Vector - results from this flow component
    *
    * @see DbBase
    */
    public static Vector Mutate(LexItem in, Connection conn,
        boolean detailsFlag, boolean mutateFlag)
    {
        // mutate: 
        Vector records = GetExpansions(in.GetSourceTerm(), conn);
        // update target LexItem
        Vector out = new Vector();
        int size = records.size();
        // tag: set true if output is unique, used in frutiful variants
        boolean curTagFlag = ((size==1)?true:false);
        Tag tag = new Tag(in.GetTag());
        tag.SetBitFlag(Tag.UNIQUE_ACR_EXP_BIT, curTagFlag);
        String tagStr = ((curTagFlag)?"Unique":"NotUnique");
        in.SetTag(tag.GetValue());
        for(int i = 0; i < size; i++)
        {
            AcronymRecord record = records.elementAt(i);
            String term = record.GetExpansion();
            // details & mutate
            String details = null;
            String mutate = null;
            if(detailsFlag == true)
            {
                details = INFO + " (" + record.GetType() + ")";
            }
            if(mutateFlag == true)
            {
                mutate = record.GetType() + GlobalBehavior.GetFieldSeparator()
                    + tagStr + GlobalBehavior.GetFieldSeparator();
            }
            LexItem temp = UpdateLexItem(in, term, Flow.EXPANSIONS, 
                Transformation.UPDATE, 
                Inflection.GetBitValue(Inflection.BASE_BIT), 
                details, mutate);
            out.addElement(temp);
        }
        return out;
    }
    /**
    * A unit test driver for this flow component.
    */
    public static void main(String[] args)
    {
        // load config file
        Configuration conf = new Configuration("data.config.lvg", true);
        String testStr = GetTestStr(args, "ER");
        // Mutate
        LexItem in = new LexItem(testStr);
        Vector outs = new Vector();
        try
        {
            Connection conn = DbBase.OpenConnection(conf);
            if(conn != null)
            {
                outs = ToExpansions.Mutate(in, conn, true, true);
            }
            DbBase.CloseConnection(conn, conf);
        }
        catch (Exception e)
        {
            System.err.println(e.getMessage());
        }
        PrintResults(in, outs);     // print out results
    }
    // private method
    private static Vector GetExpansions(String inStr, 
        Connection conn)
    {
        // strip punctuations & lowercase
        String strippedStr = ToStripPunctuation.StripPunctuation(inStr);
        String lcStrippedStr = strippedStr.toLowerCase();
        Vector out = new Vector();
        try
        {
            out = DbAcronym.GetExpansions(lcStrippedStr, conn);
        }
        catch (SQLException e) { }
        return out;
    }
    // data members
    private static final String INFO = "Generate Acronym Expansions";
}