xenial (1) rassplit.1NCARG.gz

Provided by: ncl-ncarg_6.3.0-6build1_amd64 bug

NAME
       rassplit - split a multi-frame rasterfile into single-frame rasterfiles.


SYNOPSIS
       rassplit [-f f1 f2 f3 ...]  [-ofmt output-format] [-verbose] [-Version] rasterfile


DESCRIPTION
       The  program  rassplit  will  open  rasterfile  and  copy each frame to it's own separate output file. By
       default, all frames are extracted but the user can optionally request a specific set of frames using  the
       -f  option.  The  output  format  defaults  to  be  the  same  as the input format, but the user can also
       optionally select a new output format using the -ofmt option.

       The names of the output rasterfiles are derived from the  name  of  the  source  rasterfile,  the  output
       format, and the frame numbers. The examples given below will demonstrate this.


OPTIONS
       -f f1 f2 f3 ...
              This option allows the user to specify a list of frames to be extracted from the input rasterfile.

       -ofmt output-format
              The user can specify output-format to be the desired format e.g.  hdf, rgb, etc.

       -help  Print help information.

       -verbose
              Print a message each time an output rasterfile is written.

       -Version
              Print the version number.


EXAMPLES
       Assume  you  have  a  file  called 'temp.nrif' that has three frames and that you'd like to split it into
       three separate frames, also in NRIF format.

                 rassplit temp.nrif

       This will result in three output files named temp.0001.nrif, temp.0002.nrif, and temp.003.nrif.

       Assume you only want frames two and three, and you want them produced in HDF format instead of NRIF.

                 rassplit -fmt hdf -f 2 3 temp.nrif

       This will result in two output files named temp.0001.hdf and temp.0002.hdf.


CAVEATS
       If you're splitting an HDF file, ask for a non-HDF output format. Otherwise you'll  just  get  the  first
       frame over and over again.


SEE ALSO
       rasview(1NCARG),rascat(1NCARG),rasls(1NCARG), rasgetpal(1NCARG),ras_formats(5NCARG),ras_palette(5NCARG)

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version


       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.