Name

---

      ELL_GEO_MINDIST_PT

Purpose

---

      Find the point on the given geodesic closest to a given point.

Category

---

Calling Sequence

---

      ell_geo_mindist_pt, p1, p2, pt

Inputs

---

      p1, p2 = Start and end point on a geodesic. in
      pt = A reference point not on the geodesic. in
        All points are structures: {lon:lon, lat:lat}.

Keyword Parameters

---

Keywords

---

        OUT=pmin The closest point on the geodesic to point pt.
          If pmin is not between p1 and p2 it is set to the
          closer of p1 or p2 and flag will be 1 or 2.
        DIST=d Distance (m) from pmin to pt.
        AZI=[a1,a2] a1=azimuth from pmin to pt,
                      a2=azimuth from pt to pmin.
        FLAG=flag 0=closest point is between p1 and p2,
                  1=closest point is p1,
                  2=closest point is p2.
                  3=search not bounded by p1 and p2.
        /UNBOUND Do not bound solution between p1 and p2.
        /DEBUG Debug.

Outputs

---

Common Blocks

---

Notes

---

Modification History

---

      R. Sterner, 2008 Feb 11
      R. Sterner, 2008 May 05 --- /UNBOUND.
  Copyright (C) 2008, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.