just-focus 0.3.0

Vector electromagnetic field calculations in the focus of high NA microscope objectives.

Just Focus

Just Focus is a Python package for computing vectorial electromagnetic fields in the focus of high numerical aperture microscope objectives.

Quickstart

Compute the field in the focal plane (z = 0.0) of a NA 1.4 oil immersion microscope objective assuming a linearly polarized, paraxial Gaussian beam with a waist size equal to the radius of the objective's back aperture. Use a hyperbolic tangent function to smooth the boundary of the stop and zero pad the mesh so that the final square mesh has 64 * 2^4 = 1024 samples in each direction.

import numpy as np

from leb.just_focus import InputField, Polarization, Pupil, Stop

mesh_size = 64
pupil = Pupil(
    na=1.4,
    refractive_index=1.518,
    wavelength_um=0.561,
    mesh_size=mesh_size,
    stop=Stop.TANH,
)

inputs = InputField.gaussian_pupil(
    beam_center=(0.0, 0.0),
    waist=1.0,
    mesh_size=mesh_size,
    polarization=Polarization.LINEAR_Y,
)

results = pupil.propgate(0.0, inputs, padding_factor=4)

Installation

pip install just-focus

Extras

Install additional dependencies for making plots:

pip install just-focus[plot]

Then you can use functions in the leb.just_focus.plots module to plot the inputs and results.

from leb.just_focus.plots import plot_inputs

plot_inputs(inputs, pupil)

Development

Set up the development environment

Development requires uv.

After cloning this repo, run the following command from the project's root directory:

uv sync --all-extras

This will create a virtual environment with the required dependencies in a folder named .venv.

Tests

Just run pytest from the project's root directory:

pytest

Other Packages to Compute Vectorial Focal Fields

• InFocus (MATLAB) https://github.com/QF06/InFocus
• Debye Diffraction Code (MATLAB and Python) https://github.com/jdmanton/debye_diffraction_code

Resources

• I. Herrera and P. A. Quinto-Su, "Simple computer program to calculate arbitrary tightly focused (propagating and evanescent) vector light fields," arXiv:2211.06725 (2022). https://doi.org/10.48550/arXiv.2211.06725.

This manuscript describes the specific numerical implementation of the vectorial field propagation algorithm used here.

• K. M. Douglass, "Coordinate Systems for Modeling Microscope Objectives," (2024). https://kylemdouglass.com/posts/coordinate-systems-for-modeling-microscope-objectives/

This blog post explains how to set up the various coordinate systems and numerical meshes for evaluating the results of the Richards-Wolf model for high NA objectives.

• M. Leutenegger, R. Rao, R. A. Leitgeb, and T. Lasser. Fast focus field calculations. Opt. Express 14, 11277-11291 (2006). https://doi.org/10.1364/OE.14.011277

This manuscript was the first to describe the calculation of vectorial focal fields using the fast Fourier transform.

• L. Novotny and B. Hecht, "Principles of Nano-Optics," Cambridge University Press, pp. 56 - 66 (2006). https://doi.org/10.1017/CBO9780511813535

Chapter 3 contains the derivation of the field at the focus of an aplanatic lens.