medlinecitation.java

一个自然语言处理的Java开源工具包。LingPipe目前已有很丰富的功能

     * @return The latest date on which a change was made to this
     * citation.
     */
    public Date dateRevised() {
        return mDateCreated;
    }

    /**
     * Returns the article for this citation, containing the
     * information derived from the cited article itself.
     *
     * @return The article for this citation.
     */
    public Article article() {
        return mArticle;
    }

    /**
     * Returns information about the journal in which this
     * citation appears.
     *
     * @return Information about the journal in which this
     * citation appears.
     */
    public JournalInfo journalInfo() {
        return mJournalInfo;
    }

    /**
     * Returns the array of chemical substances mentioned in this
     * journal.  The array may be of length zero if no chemicals were
     * included.
     *
     * @return The substances mentioned in this journal.
     */
    public Chemical[] chemicals() {
        return mChemicals;
    }

    /**
     * Returns the array of citation subsets for this journal.  These
     * values indicate specialized subsets of the collection of journals.
     *
     * <blockquote>
     * <table border='1' cellpadding='5'>
     * <tr><td><code>AIM</code></td>
     *     <td>citations from Abridged Index Medicus journals,
     *         a list of about 120 core clinical, English language
     *         journals.</td></tr>
     * <tr><td><code>B</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         biotechnology (not currently used).</td></tr>
     * <tr><td><code>C</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         communication disorders (not currently used).</td></tr>
     * <tr><td><code>D</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         dentistry; these citations appeared in Index to Dental
     *         Literature.</td></tr>
     * <tr><td><code>E</code></td>
     *     <td>citations in the field of bioethics. (includes records
     *         from the former BIOETHICS database)</td></tr>
     * <tr><td><code>F</code></td>
     *     <td>older citations from one journal prior to its selection for
     *         Index Medicus; used to augment the database for NLM's
     *         International MEDLARS Centers (not currently used)</td></tr>
     * <tr><td><code>H</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         health administration. (includes records from the former
     *         HealthSTAR database)</td></tr>
     * <tr><td><code>IM</code></td>
     *     <td>citations from Index Medicus journals.</td></tr>
     * <tr><td><code>J</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         population information. (not currently used; on records from the
     *         former POPLINE database)</td></tr>
     * <tr><td><code>K</code></td>
     *     <td>citations from non-Index Medicus journals relating to
     *         consumer health.</td></tr>
     * <tr><td><code>N</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         nursing; these citations appeared in the International
     *         Nursing Index.</td></tr>
     * <tr><td><code>R</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         population and reproduction; these citations appeared in
     *         Population Sciences (not currently used).</td></tr>
     * <tr><td><code>Q</code></td>
     *     <td>citations in the field of the history of medicine. (includes
     *         records from the former HISTLINE database)</td></tr>
     * <tr><td><code>QO</code></td>
     *     <td>is subset of Q - indicates older history of medicine journal
     *         citations that were created before the former HISTLINE file
     *         was converted to a MEDLINE-like format. (For NLM use because
     *         they require special handling at NLM).</td></tr>
     * <tr><td><code>S</code></td>
     *     <td>citations in the field of space life sciences. (includes
     *         records from the former SPACELINE database)</td></tr>
     * <tr><td><code>T</code></td>
     *     <td>citations from non-Index Medicus journals in the field of
     *         health technology assessment. (includes records from the
     *         former HealthSTAR database)</td></tr>
     * <tr><td><code>X</code></td>
     *     <td>citations in the field of AIDS/HIV. (includes records from
     *         the former AIDSLINE database)</td></tr>
     * </table>
     * </blockquote>
     *
     * @return An array of zero or more citation subsets.
     */
    public String[] citationSubsets() {
        return mCitationSubsets;
    }

    /**
     * Returns an array of the comments or corrections for
     * this citation.
     *
     * @return The comments or corrections for this citaiton.
     */
    public CommentOrCorrection[] commentOrCorrections() {
        return mCommentOrCorrections;
    }

    /**
     * Return an array of the gene symbols for this citation.  This
     * item was only provided for records processed at NLM between
     * 1991 and 1995.  Up to 25 symbols per article may appear.  Each
     * symbol is limited to 72 characters.  There was no
     * standardization of the naming conventions.  SGML escapes appear
     * in the text used for Greek characters.  Superscripts are
     * enclosed in <code>&lt;up&gt;</code> and <code>&lt;/up&gt;</code>
     * delimeters, whereas subscripts use <code>down</code>.
     *
     * <P>The Greek character entities used are listed in:
     * <blockquote>
     * <a href="http://www.nlm.nih.gov/bsd/license/greek_symbol.html"
     *   >NLM Technical Bulletin: Greek Symbols</a>
     * </blockquote>
     *
     * @return An array of gene symbols for this citation.
     */
    public String[] geneSymbols() {
        return mGeneSymbols;
    }

    /**
     * Returns an array of MeSH headings for this citation.
     *
     * @return An array of MeSH headings for this citation.
     */
    public MeshHeading[] meshHeadings() {
        return mMeshHeadings;
    }

    /**
     * Returns the number of bibliographic references in a review
     * article, or the empty (zero length) string if none was
     * provided. Note that other information concerning reference
     * counts are provided by NLM's partners as part of the general
     * notes.
     *
     * @return Number of bibliographic references in a review article.
     */
    public String numberOfReferences() {
        return mNumberOfReferences;
    }

    /**
     * Returns the array of personal names of subjects for articles
     * that contain information about the person named.  This is
     * typically a biographical note or an obituary.
     *
     * @return An array of personal names of subjects in this article.
     */
    public PersonalNameSubject[] personalNameSubjects() {
        return mPersonalNameSubjects;
    }

    /**
     * Returns the array of other identifiers for this citation.
     * These identifiers are drawn from other sources as described
     * in the documentation for <code>OtherID</code>.
     *
     * @return The array of other identifiers for this citation.
     */
    public OtherID[] otherIDs() {
        return mOtherIDs;
    }

    /**
     * Returns the array of other abstracts for this citation.
     *
     * @return The array of other abstracts for this citation.
     */
    public OtherAbstract[] otherAbstracts() {
        return mOtherAbstracts;
    }

    /**
     * Returns the keyword lists for this citation.  Each
     * keyword list in the returned array will have an
     * owner specified, and each keyword is specified as being
     * a major or minor keyword.
     *
     * @return The keyword lists for this citation.
     */
    public KeywordList[] keywordLists() {
        return mKeywordLists;
    }

    /**
     * Returns a list of space flight names or mission numbers for
     * articles on research carried out in space.  Results may
     * be as simple as <code>manned</code> or <code>short duration</code>
     * or may indicate more specific projects such as <code>Biosatellite
     * 2 Project</code>.
     *
     * <P>This space flight data is added by the (United States)
     * National Aeronautics and Space Administration (NASA) and more
     * information is availabe from:
     *
     * <blockquote>
     * <a href="http://www.nlm.nih.gov/bsd/space_flight.html"
     *   >Space Flight Mission Summary Table</a>
     * </blockquote>
     *
     * @return An array of space flight names, descriptions or mission
     * numbers.
     */
    public String[] spaceFlightMissions() {
        return mSpaceFlightMissions;
    }

    /**
     * Returns the investigators created by the (United States)
     * National Aeronautics and Space Administration (NASA).
     * Investigators identify NASA-funded principal investigators.
     * Investigator lists are always complete.
     *
     * @return The inve
     */
    public Investigator[] investigators() {
        return mInvestigators;
    }

    /**
     * Returns supplemental or descriptive information for this
     * citation that does not fit elsewhere.  Each general note
     * has an owner and text.
     *
     * @return The general notes for this citation.
     */
    public GeneralNote[] generalNotes() {
        return mGeneralNotes;
    }

    /**
     * Returns a string-based representation of this citation.
     *
     * @return A string-based representation of this citation.
     */
    public String toString() {
        StringBuffer sb = new StringBuffer();
        if (mNlmDcmsID != null && mNlmDcmsID.length() > 0) {
            sb.append("Medline ID=" + mNlmDcmsID);
        }
        sb.append("PMID=" + mPMID);
        sb.append("\n");
        sb.append("     JOURNAL INFO=" + mJournalInfo);
        sb.append("\n");
        sb.append("     ARTICLE=" + mArticle);
        sb.append("\n");
        sb.append("     OWNER=" + mOwner);
        sb.append("\n");
        sb.append("     STATUS=" + mStatus);
        sb.append("\n");
        sb.append("     CREATED=" + mDateCreated);
        sb.append("\n");
        sb.append("     COMPLETED=" + mDateCompleted);
        sb.append("\n");
        sb.append("     REVISED=" + mDateRevised);
        sb.append("\n");
        sb.append("     CHEMICALS=" + Arrays.asList(mChemicals));
        sb.append("\n");
        sb.append("     CITATION SUBSETS="
                  + Arrays.asList(mCitationSubsets));
        sb.append("\n");
        sb.append("     MESH HEADINGS=" + Arrays.asList(mMeshHeadings));
        sb.append("\n");
        if (numberOfReferences() != null
            && numberOfReferences().length() > 0) {

            sb.append ("     NUMBER OF REFERENCES=");
            sb.append(numberOfReferences());
            sb.append("\n");
        }
        if (personalNameSubjects().length > 0) {
            sb.append("     PERSONAL NAME SUBJECTS=");
            sb.append(Arrays.asList(personalNameSubjects()));
            sb.append("\n");
        }
        if (mKeywordLists != null && mKeywordLists.length > 0) {
            sb.append("     KEYWORD LISTS=" + mKeywordLists);
        }
        if (mGeneralNotes.length > 0) {
            sb.append("     GENERAL NOTES="
                      + Arrays.asList(mGeneralNotes));
            sb.append("\n");
        }
        if (mGeneSymbols.length > 0) {
            sb.append("     GENE SYMBOLS="
                      + Arrays.asList(mGeneSymbols));
            sb.append("\n");
        }
        if (mSpaceFlightMissions.length > 0) {
            sb.append("     SPACEFLIGHT MISSIONS="
                      + Arrays.asList(mSpaceFlightMissions));
            sb.append("\n");
        }
        if (mOtherIDs.length > 0) {
            sb.append("     OTHER IDS="
                      + Arrays.asList(mOtherIDs));
            sb.append("\n");
        }
        if (mInvestigators.length > 0) {
            sb.append("     INVESTIGATORS="
                      + Arrays.asList(mInvestigators));