.. highlightlang:: us

.. _xyzgetnumberofpoints:

XYZGetNumberOfPoints
====================

.. index:: XYZGetNumberOfPoints

.. us.tag  XYZGetNumberOfPoints ENGLISH XYZGet_data

:ref:`XYZGetNumberOfPoints` returns the
number of data points (x/y/z-triple) of a 3D dataset.

.. function::  nPoints = XYZGetNumberOfPoints(hData)

.. us.return

**Return Value**

*nPoints* is the number of datapoints. If the dataset only contains
a matrix the function returns the value 0.

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYZCreate`.

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZCreate`,
   :ref:`XYZGetData`,
   :ref:`XYZGetInterDensity`,
   :ref:`XYZIsMatrixOnly`

:sub:`id-1595235`