---

LOSR::OpticalSystem Class Reference

LOSR::OpticalSystem is a on-axis lenses system made of optical materials. More...

#include <OpticalSystem.hpp>

Inheritance diagram for LOSR::OpticalSystem::

List of all members.

Public Methods
	OpticalSystem (unsigned int inSize=0)
	Construct an optical system of the size given. More...
	~OpticalSystem ()
	Destructor (do nothing).
void	read (std::istream &ioIs=std::cin)
	Read a LOSR::OpticalSystem from a C++ input stream. More...
void	write (std::ostream &ioOs=std::cout) const
	Write a LOSR::OpticalSystem into a C++ output stream. More...
bool	validate ()
	Validate and correct the apertures of the optical system. More...

---

Detailed Description

LOSR::OpticalSystem is a on-axis lenses system made of optical materials.

LOSR::OpticalSystem is a on-axis lenses system made of optical materials. It is a std::vector of LOSR::Surface, that is a sequence of surface between different optical materials.

Author:

Christian Gagné and Julie Beaulieu

Version:

0.2

Date:

8/28/2001

---

Constructor & Destructor Documentation

OpticalSystem::OpticalSystem ( unsigned int inSize = 0 )

Construct an optical system of the size given. Parameters: inSize   Size of the optical system. : std::vector<Surface>(inSize) { }

---

Member Function Documentation

void OpticalSystem::read ( std::istream & ioIs = std::cin )

Read a LOSR::OpticalSystem from a C++ input stream. Parameters: ioIs   Input stream to extract the LOSR::OpticalSystem from. { char c1 ='\0', c2='\0'; unsigned int sz = 0; char buf[2048]; // Extract and ignore the rest of lines starting with a # for(ioIs >> c1; c1=='#'; ioIs >> c1) ioIs.getline(buf,2048,'\n'); if(!ioIs) throw LOSR_RuntimeErrorM("Premature end of stream!"); // Looking for the number of surface, between parenthesis ioIs >> sz >> c2; if((c1!='(') || (c2!=')')) throw LOSR_RuntimeErrorM("Bad file format!"); resize(sz); // Read each surfaces from the stream for(unsigned int i=0; i<sz; i++) { if(!ioIs) throw LOSR_RuntimeErrorM("Premature end of stream!"); (*this)[i].read(ioIs); } }

bool OpticalSystem::validate ( )

Validate and correct the apertures of the optical system. The system is validate by calculating whether the curvature and the distance between of two adjacent surfaces is physically possible with the given apertures. If the system is not physically possible, the apertures are reduced to the greatest value valid for the actual setup. Returns: True if the optical system is valid, false if it needed to be corrected. { const double lcMinRadius = 0.0001; bool lSystemValid = true; // For all surfaces of the optical system for(unsigned int i=0; i<(size()-1); i++) { // Determine the minimal aperture between the two surfaces double lMinAperture = LOSR_MinM( (*this)[i].getAperture(), (*this)[i+1].getAperture() ); // Calculates values for the first surface double lAlpha1 = 0; double lR1 = (*this)[i].getCurvature(); if(fabs(lR1) > lcMinRadius) { lR1 = 1.0 / lR1; lAlpha1 = lR1 - sqrt((lR1*lR1) - (lMinAperture*lMinAperture)); } // Calculates values for the second surface double lAlpha2 = 0; double lR2 = (*this)[i+1].getCurvature(); if(fabs(lR2) > lcMinRadius) { lR2 = 1.0 / lR2; lAlpha2 = lR2 - sqrt((lR2*lR2) - (lMinAperture*lMinAperture)); } // Test whether the apertures are valid. If not, correct it // See maple spreadsheet file opsys_validate.pdf for calculation details. if((*this)[i].getThickness() < (lAlpha1+lAlpha2)) { lSystemValid = false; double lY = 0.0; double lT = (*this)[i].getThickness(); if(fabs(lR1) <= lcMinRadius) { // R1 = infinity, x=0, using formula for y2b (see file opsys_validate.pdf) lY = sqrt( LOSR_Pow2M(lR2) - LOSR_Pow2M(lR2 - lT) ); } else if(fabs(lR2) <= lcMinRadius) { // R2 = infinity, x=T, using formula for y2a (see file opsys_validate.pdf) lY = sqrt( LOSR_Pow2M(lR1) - LOSR_Pow2M(lT - lR1) ); } else { // Using formula for y (see file opsys_validate.pdf) lY = sqrt( LOSR_Pow2M(lR1) - LOSR_Pow2M( ( - (lT * (lT - 2.0 * lR2)) / (2.0 * (lR1 + lR2 - lT)) ) - lR1 ) ); } (*this)[i].setAperture( LOSR_MinM( (*this)[i].getAperture(), lY ) ); (*this)[i+1].setAperture( LOSR_MinM( (*this)[i+1].getAperture(), lY ) ); } } return lSystemValid; }

void OpticalSystem::write ( std::ostream & ioOs = std::cout ) const

Write a LOSR::OpticalSystem into a C++ output stream. Parameters: ioOs   Output stream to write the LOSR::OpticalSystem into. { ioOs << '(' << size() << ')' << std::endl; for(unsigned int i=0; i<size(); i++) { (*this)[i].write(ioOs); } }

---

The documentation for this class was generated from the following files:

• OpticalSystem.hpp
• OpticalSystem.cpp

---