How to create an Extract Band function dataset

Creating an Extract Band function dataset

1. Create the Function Arguments object.
2. Specify the output order of bands using a long array whose indices correspond to the output band indices and the values correspond to the input band.
3. Create a Raster Function object.
4. Create a Function Raster Dataset object.
5. Create a name object for the function raster dataset.
6. Specify the output file name for the new dataset.
7. Initialize the new function raster dataset with the raster function and its arguments.

[C#]

// Create the Function Arguments object.
IExtractBandFunctionArguments rasterFunctionArguments=
    (IExtractBandFunctionArguments)new ExtractBandFunctionArguments();
// Specify the output order of bands.
ILongArray bandIDs=new LongArrayClass();
bandIDs.Add(3); // Band 4
bandIDs.Add(2); // Band 3
bandIDs.Add(1); // Band 2
rasterFunctionArguments.BandIDs=bandIDs;
// The input data can be of type IRasterDataset, IRasterBand, or IRaster.
rasterFunctionArguments.Raster=inputData;

// Create the Raster Function object.
IRasterFunction rasterFunction=new ExtractBandFunction();
// Create the Function Raster Dataset object.
IFunctionRasterDataset functionRasterDataset=new FunctionRasterDataset();
// Create a name object for the Function Raster Dataset.
IFunctionRasterDatasetName functionRasterDatasetName=(IFunctionRasterDatasetName)
    new FunctionRasterDatasetName();
// Specify the output file name for the new dataset (including the .afr extension at the end).
functionRasterDatasetName.FullName=@"c:\temp\ExtractBand.afr";
functionRasterDataset.FullName=(IName)functionRasterDatasetName;
// Initialize the new Function Raster Dataset with the Raster Function and its arguments.
functionRasterDataset.Init(rasterFunction, rasterFunctionArguments);

[VB.NET]

' Create the Function Arguments object
Dim rasterFunctionArguments As IExtractBandFunctionArguments
rasterFunctionArguments=New ExtractBandFunctionArguments()
' Specify the output order of bands.
Dim bandIDs As ILongArray
bandIDs=New LongArrayClass()
bandIDs.Add(3) ' Band 4
bandIDs.Add(2) ' Band 3
bandIDs.Add(1) ' Band 2
rasterFunctionArguments.BandIDs=bandIDs
' The input data can be of type IRasterDataset, IRasterBand, or IRaster.
rasterFunctionArguments.Raster=inputData

' Create the Raster Function object.
Dim rasterFunction As IRasterFunction
rasterFunction=New ExtractBandFunction()
' Create the Function Raster Dataset object.
Dim functionRasterDataset As IFunctionRasterDataset
functionRasterDataset=New FunctionRasterDataset()
' Create a name object for the Function Raster Dataset.
Dim functionRasterDatasetName As IFunctionRasterDatasetName
functionRasterDatasetName=New FunctionRasterDatasetName()
' Specify the output file name for the new dataset (including the .afr extension at the end).
functionRasterDatasetName.FullName="c:\temp\ExtractBand.afr"
functionRasterDataset.FullName=functionRasterDatasetName
' Initialize the new Function Raster Dataset with the Raster Function and its arguments.
functionRasterDataset.Init(rasterFunction, rasterFunctionArguments)

---

To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):

• ESRI.ArcGIS.DataSourcesRaster
• ESRI.ArcGIS.Geodatabase
• ESRI.ArcGIS.System (ESRI.ArcGIS.esriSystem)

Development licensing	Deployment licensing
ArcGIS Desktop Advanced	ArcGIS Desktop Advanced
ArcGIS Desktop Standard	ArcGIS Desktop Standard
ArcGIS Desktop Basic	ArcGIS Desktop Basic