---

Analyzer.hpp

/*
 *  $Id: Analyzer_8hpp-source.html,v 1.1.1.1 2002/06/12 22:58:43 cgagne Exp $
 *
 *  LOSR -- Library for Optical Systems Raytracing
 *  Copyright (C) 2001 by Christian Gagné and Julie Beaulieu
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2.1 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

#ifndef LOSR_Analyser_hpp
#define LOSR_Analyser_hpp

#include "losr/ApproxRaytracer.hpp"
#include "losr/ExactRaytracer.hpp"
#include "losr/OpticalSystem.hpp"
#include "losr/Surface.hpp"

namespace LOSR {


struct Pupil {
  Pupil(long double inT=0.0,long double inR=0.0,long double inM=0.0);

  long double mT;  
  long double mR;  
  long double mM;  
};


class Analyzer {
public:
  Analyzer() { }   
  ~Analyzer() { }  

  ApproxRaytracer::const_iterator getApertureStop(const ApproxRaytracer& inAxialRay) const;

  ApproxRaytracer::iterator       getApertureStop(ApproxRaytracer& inAxialRay) const;

  ApproxRaytracer::const_iterator getFieldStop(const ApproxRaytracer& inChiefRay) const;

  ApproxRaytracer::iterator       getFieldStop(ApproxRaytracer& inAxialRay) const;

  Pupil  getEntrancePupil(const ApproxRaytracer& inAxialRay,
                          ApproxRaytracer::const_iterator inApertureStop,
                          const ApproxRaytracer& inChiefRay) const;

  Pupil  getExitPupil(const ApproxRaytracer& inAxialRay,
                      ApproxRaytracer::const_iterator inApertureStop,
                      const ApproxRaytracer& inChiefRay) const;

  double getMagnification(const ApproxRaytracer& inChiefRay) const;

  double evaluateLastCurvature(const ApproxRaytracer& inMarginalRay) const;

  bool   traceChiefRay(const ApproxRaytracer& inAxialRay,
                       ApproxRaytracer::const_iterator inApertureStop,
                       ApproxRaytracer& outChiefRay,
                       long double inCY0=1.0, long double inCU0=0.0) const;

  bool   traceMarginalRay(const ApproxRaytracer& inAxialRay,
                          ApproxRaytracer::const_iterator inApertureStop,
                          const ApproxRaytracer& inChiefRay,
                          ApproxRaytracer& outMarginalRay) const;

};

}

#endif // LOSR_Analyser_hpp

---