AchromatDoubletLens

class raytracing.AchromatDoubletLens(fa, fb, R1, R2, R3, tc1, tc2, te, diameter, n1=None, n2=None, mat1=None, mat2=None, wavelengthRef=None, url=None, label='', wavelength=None)

Bases: CompoundLens

General Achromat doublet lens with an effective focal length of fa, back focal length of fb. The values fa and fb are used to validate the final focal lengths and back focal lengths that are obtained from the combination of elements. Most manufacturer’s specifiy 1% tolerance, so if fa is more than 1% different from the final focal length, a warning is raised.

Parameters:

• fa (float) – The effective focal length

• fb (float) – The back focal length

• R1 (float) – The first radius

• R2 (float) – The second radius

• R3 (float) – The third radius

• tc1 (float) – The first center thickness

• tc2 (float) – The second center thickness

• te (float) – The edge thickness

• n1 (float) – The refraction index of the first material

• n2 (float) – The refractive index of the second material

• diameter (float) – The diameter of the lens

• mat1 (object of Matrix class) – The transfer matrix of the first lens

• mat2 (object of Matrix class) – The transfer matrix of the second lens

• wavelengthRef (float) – The defined wavelength

• url (string) – A link to find more info for the lens

• label (string) – The name of the lens

Notes

Nomenclature from Thorlabs: https://www.thorlabs.com/newgrouppage9.cfm?objectgroup_id=120

With Edmund optics, the sign of the various radii can change depending on some of the components (i.e. PN_85_877 for instance)

property forwardSurfaces: List[Interface]

A list of surfaces that represents the element for drawing purposes

Methods

__init__(fa, fb, R1, R2, R3, tc1, tc2, te, ...)

A base class for any lens that we make from its individual elements

Inherited Methods

all()
append(matrix)	This function adds an element at the end of the path.
backFocalLength()	The focal lengths measured from the back vertex.
backwardConjugate()	With an image at the back edge of the element, where is the object ? Distance before the element by which a ray must travel to reach the conjugate plane at the back of the element.
display()
displayHalfHeight()	A reasonable height for display purposes for an element, whether it is infinite or not.
effectiveFocalLengths()	The effective focal lengths calculated from the power (C) of the matrix.
flipOrientation()	Flip the orientation (forward-backward) of this group of elements.
focalDistances()	This is the synonym of effectiveFocalLengths()
focalShifts([wavelengths])	The chromatic aberration shifts to the focal distance from the design focal length for a range of wavelengths.
focusPositions(z)	Positions of both focal points on either side of the element.
forwardConjugate()	With an object at the front edge of the element, where is the image? Distance after the element by which a ray must travel to reach the conjugate plane of the front of the element.
fromFocusToFocus()	A simple method to obtain a MatrixGroup that includes all three matrices to travel from the front focus, through the lens, and then to the back focus.
fromStruct(theStruct)
frontFocalLength()	The focal lengths measured from the front vertex.
hasFiniteApertureDiameter()	True if ImagingPath has at least one element of finite diameter
insert(index, element)	This function is used to insert a matrix at a specific index.
intermediateConjugates()	This function calculates the position and the magnification of the conjugate planes.
load(filePath[, append])	A MatrixGroup saved with save() can be loaded using this function.
magnification()	The magnification of the element
mul_beam(rightSideBeam)	This function calculates the multiplication of a coherent beam with complex radius of curvature q by an ABCD matrix.
mul_matrix(rightSideMatrix)	This function is used to combine two elements into a single matrix.
mul_ray(rightSideRay)	This function does the multiplication of a ray by a matrix.
opticalInvariant(ray1, ray2[, z])	The optical invariant is a quantity that is conserved for any two rays in the system.
pointsOfInterest(z)	List of points of interest for this element as a dictionary:
pop(index)	This function is used to remove a matrix at a specific index.
principalPlanePositions(z)	Positions of the input and output principal planes.
profileFromRayTraces(rayTraces[, z])
save(filePath)	A MatrixGroup can be saved using this function and loaded with load()
showChromaticAberrations([wavelengths])	Show the chromatic aberrations focal shifts for this lens as obtained from the function focalShifts()
toStruct()
trace(inputRay)	Trace the input ray from first element until after the last element, indicating if the ray was blocked or not.
traceMany(inputRays[, useOpenCL])	This function trace each ray from a group of rays from front edge of element to the back edge.
traceManyNative(inputRays)	This function trace each ray from a group of rays from front edge of element to the back edge.
traceManyOpenCL(inputRays)	This function trace each ray from a group of rays from front edge of element to the back edge.
traceManyThrough(inputRays[, progress, ...])	This function trace each ray from a list or a Rays() distribution from front edge of element to the back edge.
traceManyThroughInParallel(inputRays[, ...])	This is an advanced technique to gain from parallel computation: it is the same as traceManyThrough(), but splits this call in several other parallel processes using the multiprocessing module, which is os-independent.
traceThrough(inputRay)	Contrary to trace(), this only returns the last ray.
transferMatrices()	The list of Matrix() that corresponds to the propagation through this element (or group).
transferMatrix([upTo])	The transfer matrix between front edge and distance=upTo

Attributes

Struct
determinant	The determinant of the ABCD matrix is always frontIndex/backIndex, which is often 1.0.
forwardSurfaces	A list of surfaces that represents the element for drawing purposes
hasPower	If True, then there is a non-null focal length because C!=0.
isIdentity
isImaging	If B=0, then the matrix represents that transfer from a conjugate plane to another (i.e. object at the front edge and image at the back edge).
largestDiameter	Largest finite diameter in all elements
surfaces