Magic Commands
==============

The default IPython `magic commands <https://ipython.readthedocs.io/en/stable/interactive/magics.html>`_
are available in the Jupyter Notebook.

Additionally we define the following ones:

.. function:: %addpath path

    Adds `path` to the list of paths to look for Python modules.

.. function:: %holoviews

    Replaces current cell with a set of useful imports to use HoloViews.

.. function:: %install [-v] packagename

    Installs (or updates if installed) packagename.

.. function:: %info_versions -p package1 package2 package3
    
    Display the versions of the packages in the list.

.. function:: %list_packages

    List names and versions of all installed packages.

.. function:: %tensorflow_version [version]

    Display available TensorFlow versions. If the optional `version` is given then it is activated. 

.. function:: %watermark

    Prints date/time stamps and various system information. Options can be viewed by executing `%watermark?`


Other useful magic commands are (please see above for a full list):

.. function:: %pip 

     Run the pip package manager within the current kernel.

.. function:: %writefile [-a] filename

     Write the content of the cell to a file. The file will be overwritten unless `-a` (append) is specified.