Skip to content

About

Educational MATLAB simulations of quantum wave-packet dynamics: numerical Schrodinger evolution, potential barriers and visualizations motivated by pilot-wave theory.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

Quantum Wave-Packet Dynamics in MATLAB

DeepDynaSim collection | Computational physics | Educational simulations

Visualize numerical wave-packet evolution and interactions with potential barriers. The examples are motivated by quantum mechanics and pilot-wave discussions and use MATLAB to explore wave behaviour.

Choose an example

File Focus
schrodingerequation_numerical.m Numerical two-dimensional time-dependent Schrodinger evolution
potentialbarriers.m Potential-barrier example
gaussianwaveinteractingpotentialbarrier.m Gaussian wave packet interacting with a barrier

Getting started

Clone the repository, open its root folder in MATLAB and inspect the grid, time step, potential and initial wave packet in the selected script.

edit schrodingerequation_numerical.m

These scripts numerically evolve wavefunctions. Check spatial/time convergence, normalization and boundary effects when interpreting a visualization. The detailed notes below explain the included examples and retain the existing figures.

What each script actually computes

schrodingerequation_numerical.m

The free-particle example uses central spatial differences and circshift to wrap the grid periodically. Its time update is explicit forward Euler:

psi_next = psi - i * dt * H(psi) / hbar

It is not a Crank-Nicolson solve. For a Hamiltonian eigenmode with real eigenvalue lambda, the amplification factor satisfies

abs(1 - i*dt*lambda/hbar)^2 = 1 + (dt*lambda/hbar)^2

Consequently, nonzero eigenmodes grow under this update: the displayed time-step heuristic is not a proof of stability or probability conservation. The current example illustrates the discretization and visualization, and must not be used as a validated unitary quantum solver. Check norm drift, spatial resolution, time resolution and periodic-boundary effects before interpreting numerical results.

The script uses a 151-by-151 grid with hbar=m=1, a Gaussian initial state and zero potential. It plots initial/final densities and writes wave_packet_evolution.mp4 in the current folder. VideoWriter needs a supported MPEG-4 encoder. The values are dimensionless model units, not a calibrated laboratory experiment.

potentialbarriers.m

This script plots three prescribed potential arrays: rectangular, elliptical and circular. It does not propagate a wavefunction or compute transmission/reflection probabilities. The finite rectangular region is assigned a positive potential, so the plotted example is a barrier rather than a negative potential well.

gaussianwaveinteractingpotentialbarrier.m

This is a separate split-step/directional-recursion example for a Gaussian packet and a circular barrier. It stores 80 time steps and generates density/potential panels plus 2DCylindricalPotential3D.gif. Its boundary handling and update are different from those of schrodingerequation_numerical.m; a stability claim for one method must not be transferred to the other.

These programs evolve wavefunctions and potentials. They do not implement Bohmian particle trajectories or an additional pilot-wave guidance equation. The repository name should not be read as a claim that such a trajectory solver is included.

Original example outputs

wave_packet_evolution.mp4

wave_packet_evolution

comparisonofbarriers

2DCylindricalPotential3D

wave_function_interaction_barrier

Related work and collaboration

Explore related repositories: Emergence · LorentzTransformations.

DeepDynaSim is an engineering R&D and consulting company in İzmir, Türkiye, focused on physics-guided AI, simulation and control. For engineering collaboration: support@deepdynasim.com. For repository questions, use Issues.

Reuse follows the existing LICENSE; academic authorship and third-party attribution remain with their respective creators.

About

Educational MATLAB simulations of quantum wave-packet dynamics: numerical Schrodinger evolution, potential barriers and visualizations motivated by pilot-wave theory.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages