Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_SW_DUPREGION

# EOS_SW_DUPREGION

This function copies the information stored in a current region or period to a new region or period and generates a new id. It is useful when the user wishes to further subset a region (period) in multiple ways.

## Examples

In this example, we first subset a swath with EOS_SW_DEFBOXREGION, duplicate the region creating a new region ID, regionID2, and then perform two different vertical subsets of these (identical) geographic subset regions:

regionID = EOS_SW_DEFBOXREGION(swathID, cornerlon, $

cornerlat, 0)

regionID2 = EOS_SW_DUPREGION(regionID)

regionID = EOS_SW_DEFVRTREGION(swathID, regionID, $

"Pressure", rangePres)

regionID2 = EOS_SW_DEFVRTREGION(swathID, regionID2, $

"Temperature", rangeTemp)

## Syntax

Result = EOS_SW_DUPREGION(regionID)

## Return Value

Returns new region or period ID or FAIL (–1) on error.

## Arguments

### regionID

Region or period id (long) returned by EOS_SW_DEFBOXREGION, EOS_SW_DEFTIMEPERIOD, or EOS_SW_DEFVRTREGION.

## Keywords

None

## Version History

5.2 | Introduced