.. highlightlang:: us

.. index:: NC_CreateSampleReduction

.. _NC_CreateSampleReduction:

NC_CreateSampleReduction
========================

.. us.tag  NC_CreateSampleReduction NOTREADYENGLISH nc.tools New5400

:ref:`NC_CreateSampleReduction` creates a file with all channels
with mor than 2 million data points in the source file. 

.. function::  ret = NC_CreateSampleReduction(ncid)

.. us.return

**Return Value**

*ret* is smaller than 0 if an error occurred and otherwise greater than 0.

.. us.params

**Parameters**

.. uparam:: ncid

   *ncid* is returned by :ref:`nc_create` or :ref:`nc_open`.

.. us.comment

**Comment**

The function creates a new file with the suffix :file:`-red.nc2`. The file 
will only be created if the source file contains channels with more than 2 
million data points. The reduction factor is 1000. Example: A data file
with the name :file:`input.nc2` contains 10 Channels with 2.5 million data points.
The function creates a file with the name :file:`input-red.nc2` with 10 
channels with 2500 data points.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - R2012 (5.40.0)
     - New.

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`fileexport-data`,
   :ref:`nc_create`

:sub:`id-1109612`