.. _tut_clipping:

***********************
Clipping Planes in SUMA
***********************

.. contents:: :local:

.. highlight:: Tcsh

**Under construction\.\.\.**

Introduction
============

We briefly describe new clipping plane behavior in SUMA, which is
useful to investigate internal structures and overlays of data.  This
Demo was presented at OHBM 2022:

    | **Using Clipping PLanes to Analyze Brain Data in SUMA**
    | by Lauren P, Glen DR, Reynolds RC, Torrisi S, Taylor PA
    | `Lauren et al. (2022) OHBM poster.
      <https://afni.nimh.nih.gov/pub/dist/OHBM2022/OHBM2022_lauren_clippingPlanes.pdf>`_

To run this functionality, your system's AFNI version should be at
least 22.1.02.

| For suggestions on applying SUMA's "Clipping plane" functionality,
  please see this part of the documentation: 
| :ref:`suma_clipping`
| \.\.\. which contains a useful cheatsheet of keystrokes.

See also the related :ref:`SurfLayers Demo <tut_surflayers>`.


Poster-related SUMA videos
==================================

The following ``*.mpg`` files should play using, e.g., the VLC media
player:

* `<https://afni.nimh.nih.gov/pub/dist/OHBM2022/ohbm2022_clipping_plane_ex1.mpg>`_

* `<https://afni.nimh.nih.gov/pub/dist/OHBM2022/ohbm2022_clipping_plane_ex2.mpg>`_

* `<https://afni.nimh.nih.gov/pub/dist/OHBM2022/ohbm2022_clipping_plane_ex3.mpg>`_

Questions/Contact
===================

For questions/comments/suggestions, please contact:

.. list-table:: 
   :header-rows: 0
   :align: left

   * - Peter Lauren
     - *peter.lauren __at__ nih.gov*
   * - Daniel Glen
     - *glend __at__ mail.nih.gov*
   * - Paul Taylor
     - *paul.taylor __at__ nih.gov*

| \.\.\. and/or use the ever-popular AFNI Message Board:
| `<https://discuss.afni.nimh.nih.gov>`_



.. |ss| raw:: html

   <strike>

.. |se| raw:: html

   </strike>