:index:`MP2`: Optical Flow
##################################

In this MP, you will synthesize a video by moving around the samples
of a few base images.  The movement vectors will be computed from a
lower-resolution video using an `optical flow fields
<https://en.wikipedia.org/wiki/Optical_flow>`_ computed by the
`Lucas-Kanade algorithm
<https://en.wikipedia.org/wiki/Lucas%E2%80%93Kanade_method>`_.

* `mp2.zip <mp/mp2.zip>`_ contains the code.  You should download the code,
  unzip it into some directory, and then type ``jupyter-lab`` to get started.
* `mp2_notebook.html <mp/mp2_notebook.html>`_ is an example of what the Jupyter notebook will
  look like, once you've finished everything.
  
* ``python grade.py`` is how you will grade your code on your local machine.  The
  solutions are available to you in ``solutions.hdf5``.
  
* When it works on your machine, then you can try uploading **only**
  the file ``submitted.py`` to the MP2 assignment on `Gradescope
  <https://www.gradescope.com/courses/288629>`_.

Extra Credit
--------------

* `mp2_extra.zip <mp/mp2_extra.zip>`_ is the extra credit assignment.
  This adds one more file for you to work on (``extra.py``), and one more
  visible test file (``tests/test_extra.py``) with its accompanying
  solutions file (``extra_solutions.hdf5``).
* When you've finished revising ``extra.py``, you can test it on your
  machine by running ``python grade.py``.
* When it works on your machine, upload **only** the file ``extra.py``
  to the ``MP2 Extra Credit`` assignment on `Gradescope
  <https://www.gradescope.com/courses/288629>`_.