`PSlab` stands for the "Photonic Slab" and is a tool for modelling of optical properties in various
photonic structures. It can be used for simulations of as well some simple two-dimensional devices, like good old
edge emitting laser, as more complicated ones including photonic band-gap materials or photonic crystal based
lasers.

The main properties of `PSlab` are

- the computations are fully vectorial, no scalar approximation is performed,
- every structure can be tackled as long as it can be divided into several layers uniform in one direction,
- both Cartesian 2D and 3D geometries are supported,
- 2D periodic boundary conditions are naturally implemened,
- Perfetly Matched Layers (PMLs) as abosorbing boundary conditions can be added at each side to properly analyze the radiating modes.

The computations are performed with the **plane wave admittance method** (PWAM) -- a fully vectorial and
three-dimensional numerical procedure for solving the Maxwell equations in complicated structures. Contrary to
other methods (like FDTD or Method of Lines) PWAM does not require spatial discretization of the computational
domain but describes the electromagnetic field as a sum of 2D plane-waves with varying amplitudes along -axis.

You can find the detailed mathematical desription of PWAM in ref. [1]. This document only presents
the basic usage of the `PSlab` package. It consists of the simple tutorial covering the definition of a structure
and running the simulation and more detailde class description and reference.