NAME

       cit2pmid - find candidate NCBI PubMed identifiers for a citation

SYNOPSIS

       cit2pmid  [-debug] [-strict] [-remote|-eutils|-local|-exact|-verify] [-asn file|-cit file]
       [-title|-TITL str] [-author|-FAUT|-LAUT str] [-journal|-JOUR str]  [-year|-YEAR|-PDAT str]
       [-volume|-VOL str] [-issue|-ISS str] [-page[s]|-PAGE str]

DESCRIPTION

       cit2pmid  tries  to identify NCBI PubMed identifiers corresponding to a supplied citation.
       Some modes search an indexed local NCBI PubMed archive (as prepared by index-pubmed(1)).

OPTIONS

       -debug Trace some aspects of execution.

       -strict
              Perform stricter matching (only in -local mode, at least for now).

       -remote
              Use nquire -citmatch remote service (default).

       -eutils
              Use esearch remote service.

       -local Use transmute -r2p (ref2pmid) for relaxed search with local archive.

       -exact Use phrase-search for strict matching with local archive.

       -verify
              Query against local archive with strict (but  not  -exact)  matching  then  confirm
              positive candidates via citmatch.

       -asn file
              Read  NCBI  Pub  ASN.1  from  file  (- for standard input).  Must be the only query
              specification.

       -cit file
              Read CITATION XML from file (-  for  standard  input).   Must  be  the  only  query
              specification.

       -title|-TITL str
              Article title; may need other fields to disambiguate, especially if incomplete.

       -author str
              Author  name  (last  name,  optionally followed by initials); may appear twice, for
              first and last authors.  (Otherwise, taken to be first author only.)

       -FAUT str
              Explicitly name first author.

       -LAUT str
              Explicitly name last author.

       -journal|-JOUR str
              Journal name.

       -year|-YEAR|-PDAT str
              Publication year.

       -volume|-VOL str
              Journal volume.

       -issue|-ISS str
              Journal issue.

       -page[s]|-PAGE str
              Journal page, or hyphenated range.

ENVIRONMENT

       EDIRECT_PUBMED_MASTER
              Local archive directory to use.  Expected to hold an absolute path;  mandatory  for
              any mode besides -remote and -eutils.

SEE ALSO

       edict(1),   esearch(1),  fetch-pubmed(1),  index-pubmed(1),  nquire(1),  phrase-search(1),
       ref2pmid(1), transmute(1).