RayZaler 0.1
The free opto-mechanical simulation framework
@addtogroup Elements

Circular stop in a rectangular frame.

Specialization of OpticalElement



Details

ApertureStop represents an infinite, opaque plane with a circular aperture in the middle with adjustable diameter. The outer rectangular frame size can also be adjusted for representation purposes in the 3D views of the element, but this has no effect on how much light is blocked.

Properties

NameDescriptionDefaultUnits
ApertureStop
radius
Aperture radius 0.025m
diameter
Aperture diameter 0.05m
width
Width of the stop mask 0.075m
height
Height of the stop mask 0.075m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • stopSurf: ApertureStopBoundary(CircularFlat, ReflectiveEMInterface)

An optical bench with four legs.

Specialization of Element



Properties

NameDescriptionDefaultUnits
BenchElement
height
Height of the table 1m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Rectangular prism with adjustable dimensions.

Specialization of Element



Properties

NameDescriptionDefaultUnits
BlockElement
length
Length (X dimension) of the block 1.0m
width
Width (Y dimension) of the block 1.0m
height
Height (Z dimension) of the block 1.0m
wireFrame
Represent as wireframe onlyFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Circular window with thickness and a refractive index.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
CircularWindow
thickness
Thickness of the window 0.01m
radius
Radius of the window 0.025m
diameter
Diameter of the window 0.05m
n
Refractive index of the window1.5
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • inputFace: CircularWindowBoundary(CircularFlat, DielectricEMInterface)
  • outputFace: CircularWindowBoundary(CircularFlat, DielectricEMInterface)

Lens with surfaces given by conic curves.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
ConicLens
thickness
Thickness of the lens 0.01m
radius
Radius of the lens 0.025m
diameter
Diameter of the lens 0.05m
x0
X-axis offset 0m
y0
Y-axis offset 0m
n
Refractive index1.5
curvature
Radius of curvature of both surfaces 0.05m
focalLength
Focal length of both surfaces 0.05m
conic
Conic constant (K) of both surfaces0
frontCurvature
Radius of curvature of the front surface 0.1m
frontFocalLength
Focal length of the front surface 0.05m
frontConic
Conic constant (K) of the front surface0
backCurvature
Radius of curvature of the front surface 0.1m
backFocalLength
Focal length of the back surface 0.05m
backConic
Conic constant (K) of the back surface0
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • inputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)
  • outputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)

Circular mirror with a surface given by a conic curve.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
ConicMirror
thickness
Thickness of the mirror 0.01m
radius
Radius of the mirror 0.1m
diameter
Diameter of the mirror 0.2m
curvature
Radius of curvature of the mirror 0.5m
focalLength
Focal length of the mirror 0.25m
conic
Conic constant (K) of the reflective surface0
hole
Radius of the central hole 0.0m
x0
X-axis offset 0m
y0
Y-axis offset 0m
vertexRelative
Positioning is relative to the vertex of the reflective surfaceFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • refSurf: ConicMirrorBoundary(Conic(0.000000), ReflectiveEMInterface)

Generic detector with rectangular pixels.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
Detector
pixelWidth
Horizontal size of the pixel 1.5e-05m
pixelHeight
Vertical size of the pixel 1.5e-05m
cols
Number of pixels in the horizontal direction512
rows
Number of pixels in the vertical direction512
flip
Flip detector 180ยบ around the X axisFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Optical surfaces

  • detSurf: DetectorBoundary(RectangularFlat, [no interface])

Elliptic mirror with a flat surface.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
FlatMirror
thickness
Thickness of the mirror 0.01m
radius
Radius of the mirror 0.025m
diameter
Diameter of the mirror 0.05m
width
Width of the mirror 0.05m
height
Height of the mirror 0.05m
vertexRelative
Positioning is relative to the vertex of the reflective surfaceFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • refSurf: FlatMirrorBoundary(CircularFlat, ReflectiveEMInterface)

Ideal (paraxial) lens with null thickness.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
IdealLens
radius
Radius of the lens 0.025m
diameter
Diameter of the lens 0.05m
focalLength
Focal length 1.0m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • lensSurface: IdealLensBoundary(CircularFlat, ParaxialEMInterface)

Rectangular grid of microlenses.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
LensletArray
conic
Conic constant (K) of the lens surface0.0
thickness
Thickness of the microlenses 0.01m
width
Horizontal dimension of the array 0.1m
height
Vertical dimension of the array 0.1m
cols
Number of microlenses in the horizontal direction10
rows
Number of microlenses in the vertical direction10
curvature
Radius of curvature of the microlenses 0.5m
focalLength
Focal length of the microlenses 0.5m
n
Refractive index of the microlenses1.5
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • inputFace: LensletArrayBoundary(Array(Conic(0.000000), 10, 10), DielectricEMInterface)
  • outputFace: LensletArrayBoundary(Array(Conic(0.000000), 10, 10), DielectricEMInterface)

Flat obstacle to the passage of light.

Specialization of OpticalElement



Details

Obstruction is an element that can be used to model arbitrary 2D obscurations in the light path. Usually, Obstruction is instanced with the path of a grayscale PNG image file, in which the intensity of each pixel encodes a transmission probability in that location: shades of gray vary the transmission from no transmission (black) to full transmission (white).

Although there is freedom in the choice of a bit depth of the image, RayZaler will only take into account the 16 most significant bits of the pixel value.

If no path is specified, Obstruction represents a perfectly circular opaque disc. In any case, properties radius or diameter can be used to normalize the largest dimension (width or height) of the obstruction shape to a physical size.

Properties

NameDescriptionDefaultUnits
Obstruction
radius
Radius or half-length of the largest obstacle dimension 0.025m
diameter
Diameter or length of the lrgest obstacle dimension 0.05m
file
Path to the PNG file containing the shape of the obstace
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Optical surfaces

  • stopSurf: ObstructionBoundary(CircularFlat, DummyEMInterface)

Lens with parabolic surface.

Specialization of ConicLens



Properties

NameDescriptionDefaultUnits
ConicLens
thickness
Thickness of the lens 0.01m
radius
Radius of the lens 0.025m
diameter
Diameter of the lens 0.05m
x0
X-axis offset 0m
y0
Y-axis offset 0m
n
Refractive index1.5
curvature
Radius of curvature of both surfaces 0.1m
focalLength
Focal length of both surfaces 0.1m
conic
Conic constant of the lens (overriden)-1
frontCurvature
Radius of curvature of the front surface 0.1m
frontFocalLength
Focal length of the front surface 0.05m
frontConic
Conic constant of the lens (front face, overriden)-1
backCurvature
Radius of curvature of the front surface 0.1m
backFocalLength
Focal length of the back surface 0.05m
backConic
Conic constant of the lens (back face, overriden)-1
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • inputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)
  • outputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)

Mirror with parabolic surface.

Specialization of ConicMirror



Properties

NameDescriptionDefaultUnits
ConicMirror
thickness
Thickness of the mirror 0.01m
radius
Radius of the mirror 0.1m
diameter
Diameter of the mirror 0.2m
curvature
Radius of curvature of the mirror 0.5m
focalLength
Focal length of the mirror 0.25m
conic
Conic constant of the mirror (overriden)-1
hole
Radius of the central hole 0.0m
x0
X-axis offset 0m
y0
Y-axis offset 0m
vertexRelative
Positioning is relative to the vertex of the reflective surfaceFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • refSurf: ConicMirrorBoundary(Conic(-1.000000), ReflectiveEMInterface)

Circular phase screen with irregular height described through Zernike polynomials.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
PhaseScreen
Z0
Coefficient for polynomial $Z_{0}$ 0.0m
Z1
Coefficient for polynomial $Z_{1}$ 0.0m
Z2
Coefficient for polynomial $Z_{2}$ 0.0m
Z3
Coefficient for polynomial $Z_{3}$ 0.0m
Z4
Coefficient for polynomial $Z_{4}$ 0.0m
Z5
Coefficient for polynomial $Z_{5}$ 0.0m
Z6
Coefficient for polynomial $Z_{6}$ 0.0m
Z7
Coefficient for polynomial $Z_{7}$ 0.0m
Z8
Coefficient for polynomial $Z_{8}$ 0.0m
Z9
Coefficient for polynomial $Z_{9}$ 0.0m
Z10
Coefficient for polynomial $Z_{10}$ 0.0m
Z11
Coefficient for polynomial $Z_{11}$ 0.0m
Z12
Coefficient for polynomial $Z_{12}$ 0.0m
Z13
Coefficient for polynomial $Z_{13}$ 0.0m
Z14
Coefficient for polynomial $Z_{14}$ 0.0m
Z15
Coefficient for polynomial $Z_{15}$ 0.0m
Z16
Coefficient for polynomial $Z_{16}$ 0.0m
Z17
Coefficient for polynomial $Z_{17}$ 0.0m
Z18
Coefficient for polynomial $Z_{18}$ 0.0m
Z19
Coefficient for polynomial $Z_{19}$ 0.0m
Z20
Coefficient for polynomial $Z_{20}$ 0.0m
Z21
Coefficient for polynomial $Z_{21}$ 0.0m
Z22
Coefficient for polynomial $Z_{22}$ 0.0m
Z23
Coefficient for polynomial $Z_{23}$ 0.0m
Z24
Coefficient for polynomial $Z_{24}$ 0.0m
Z25
Coefficient for polynomial $Z_{25}$ 0.0m
Z26
Coefficient for polynomial $Z_{26}$ 0.0m
Z27
Coefficient for polynomial $Z_{27}$ 0.0m
Z28
Coefficient for polynomial $Z_{28}$ 0.0m
Z29
Coefficient for polynomial $Z_{29}$ 0.0m
Z30
Coefficient for polynomial $Z_{30}$ 0.0m
Z31
Coefficient for polynomial $Z_{31}$ 0.0m
Z32
Coefficient for polynomial $Z_{32}$ 0.0m
Z33
Coefficient for polynomial $Z_{33}$ 0.0m
Z34
Coefficient for polynomial $Z_{34}$ 0.0m
Z35
Coefficient for polynomial $Z_{35}$ 0.0m
Z36
Coefficient for polynomial $Z_{36}$ 0.0m
Z37
Coefficient for polynomial $Z_{37}$ 0.0m
Z38
Coefficient for polynomial $Z_{38}$ 0.0m
Z39
Coefficient for polynomial $Z_{39}$ 0.0m
Z40
Coefficient for polynomial $Z_{40}$ 0.0m
Z41
Coefficient for polynomial $Z_{41}$ 0.0m
Z42
Coefficient for polynomial $Z_{42}$ 0.0m
Z43
Coefficient for polynomial $Z_{43}$ 0.0m
Z44
Coefficient for polynomial $Z_{44}$ 0.0m
Z45
Coefficient for polynomial $Z_{45}$ 0.0m
Z46
Coefficient for polynomial $Z_{46}$ 0.0m
Z47
Coefficient for polynomial $Z_{47}$ 0.0m
Z48
Coefficient for polynomial $Z_{48}$ 0.0m
Z49
Coefficient for polynomial $Z_{49}$ 0.0m
Z50
Coefficient for polynomial $Z_{50}$ 0.0m
Z51
Coefficient for polynomial $Z_{51}$ 0.0m
Z52
Coefficient for polynomial $Z_{52}$ 0.0m
Z53
Coefficient for polynomial $Z_{53}$ 0.0m
Z54
Coefficient for polynomial $Z_{54}$ 0.0m
Z55
Coefficient for polynomial $Z_{55}$ 0.0m
Z56
Coefficient for polynomial $Z_{56}$ 0.0m
Z57
Coefficient for polynomial $Z_{57}$ 0.0m
Z58
Coefficient for polynomial $Z_{58}$ 0.0m
Z59
Coefficient for polynomial $Z_{59}$ 0.0m
radius
Radius of the phase screen 0.025m
diameter
Diameter of the phase screen 0.05m
ni
Input refractive index1.0
no
Output refractive index1.5
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • interface: PhaseScreenBoundary(CircularFlat, ParaxialZernikeEMInterface)

Rectangular aperture in a rectangular frame.

Specialization of OpticalElement



Properties

NameDescriptionDefaultUnits
RectangularStop
borderWidth
Horizontal size of the frame 0.1m
borderHeight
Vertical size of the frame 0.1m
width
Horizontal size of the aperture 0.075m
height
Vertical size of the aperture 0.075m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • stopSurf: RectangularStopBoundary(RectangularFlat, ReflectiveEMInterface)

Solid bar with circular section.

Specialization of Element



Properties

NameDescriptionDefaultUnits
RodElement
length
Length of the rod 0.05m
diameter
Diameter of the section 0.003m
radius
Radius of the section 0.0015m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Lens with spherical surface.

Specialization of ConicLens



Properties

NameDescriptionDefaultUnits
ConicLens
thickness
Thickness of the lens 0.01m
radius
Radius of the lens 0.025m
diameter
Diameter of the lens 0.05m
x0
X-axis offset 0m
y0
Y-axis offset 0m
n
Refractive index1.5
curvature
Radius of curvature of both surfaces 0.1m
focalLength
Focal length of both surfaces 0.1m
conic
Conic constant of the lens (overriden)0
frontCurvature
Radius of curvature of the front surface 0.1m
frontFocalLength
Focal length of the front surface 0.05m
frontConic
Conic constant of the lens (front face, overriden)0
backCurvature
Radius of curvature of the front surface 0.1m
backFocalLength
Focal length of the back surface 0.05m
backConic
Conic constant of the lens (back face, overriden)0
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • inputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)
  • outputSurface: ConicLensBoundary(Conic(0.000000), DielectricEMInterface)

Mirror with spherical surface.

Specialization of ConicMirror



Properties

NameDescriptionDefaultUnits
ConicMirror
thickness
Thickness of the mirror 0.01m
radius
Radius of the mirror 0.1m
diameter
Diameter of the mirror 0.2m
curvature
Radius of curvature of the mirror 0.5m
focalLength
Focal length of the mirror 0.25m
conic
Conic constant of the mirror (overriden)0
hole
Radius of the central hole 0.0m
x0
X-axis offset 0m
y0
Y-axis offset 0m
vertexRelative
Positioning is relative to the vertex of the reflective surfaceFalse
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

Optical surfaces

  • refSurf: ConicMirrorBoundary(Conic(0.000000), ReflectiveEMInterface)

Arbitrary mesh from a STL file.

Specialization of Element



Properties

NameDescriptionDefaultUnits
StlMesh
file
Path of the STL mesh
units
Physical length of the units of the STL mesh 0.001m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Flat mount supported by 3 legs with adjustable heights, forming an isosceles triangle.

Specialization of Element



Properties

NameDescriptionDefaultUnits
Tripod
leg1
Height of the first leg0.02
leg2
Height of the second leg0.02
leg3
Height of the third leg0.02
radius
Radius of the circumscribing circle 0.042m
diameter
Diameter of the circumscribing circle 0.084m
angle
Angle of the vertex of the triangle 70deg
legDiameter
Diameter of the legs 0.006m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames

A hollow tube with circular section and open ends.

Specialization of Element



Properties

NameDescriptionDefaultUnits
TubeElement
length
Length of the tube 0.05m
innerDiameter
Inner diameter 0.0015m
outerDiameter
Outer diameter 0.003m
Element
blue
Blue channel of the solid color of the element 0.250..1
green
Green channel of the solid color of the element 0.250..1
red
Red channel of the solid color of the element 0.250..1
shiny
Specular component intensity 630..127
specBlue
Blue channel of the specular color of the element 0.250..1
specGreen
Green channel of the specular color of the element 0.250..1
specRed
Red channel of the specular color of the element 0.250..1

Reference frames