DielectricSlab

class raytracing.DielectricSlab(n, thickness, diameter=inf, label='')

Bases: ThickLens

A slab of dielectric material of index n and length d, with flat faces

Parameters:
  • n (float) – The refraction index of the dielectric. This value cannot be negative

  • thickness (float) – The thickness of the dielectric

  • diameter (float) – The diameter of the dielectric. (default=Inf)

  • label (string) – the label of the element

Examples

>>> from raytracing import *
>>> #define a dielectric with refraction index of 1.5
>>> D=DielectricSlab(n=1.5,thickness=5,diameter=20,label='Dielectric')
>>> print(D) #print the transfer matrix of dielectric slab
|  1.000    3.333 |
|                 |
| -0.000    1.000 |
f = +inf (afocal)
property forwardSurfaces: List[Interface]

A list of surfaces that represents the element for drawing purposes.

transferMatrix(upTo=inf)
Returns a either DielectricSlab() or a Matrix() corresponding to a partial propagation

if the requested distance is smaller than the length of this element

Parameters:

upTo (float) – The length of the propagation (default=Inf)

Returns:

transferMatrix – the corresponding matrix to the propagation

Return type:

object of class Matrix

Methods

__init__(n, thickness[, diameter, label])

transferMatrix([upTo])

Returns a either DielectricSlab() or a Matrix() corresponding to a partial propagation

Inherited Methods

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()

We flip the element around (as in, we turn a lens around front-back).

focalDistances()

This is the synonym of effectiveFocalLengths()

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()

If the system has a finite aperture size

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:

principalPlanePositions(z)

Positions of the input and output principal planes.

profileFromRayTraces(rayTraces[, z])

toStruct()

trace(ray)

The ray matrix formalism, through multiplication of a ray by a matrix, will give the correct ray but will never consider apertures.

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).

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 diameter for a group of elements

surfaces