Workspace To New Mosaic (Samples)

サマリ

Creates a new raster dataset in the output location and mosaics all the raster datasets in the input workspace, or geodatabase, into it.

レガシレガシ:
This tool has been deprecated. For more information, see An overview of the Samples toolbox.

使用法

構文

WorkspaceToNewMosaic_samples (input_workspace, output_location, output_raster_name, {config_keyword}, {mosaic_mode}, {colormap_mode}, {pyramid_origin}, {ignore_background_value}, {nodata_value}, {convert_1_bit_data_to_8_bit}, {mosaic_tolerance})
パラメータ説明データ タイプ
input_workspace

The location where the raster datasets will be mosaicked into the output raster dataset. It can be a directory, personal geodatabase, file geodatabase, or an enterprise geodatabase.

Folder | Workspace
output_location

The location where the new raster dataset will be created.

Folder | Workspace
output_raster_name

The dataset name of the output raster.

String
config_keyword
(オプション)

ファイル ジオデータベースおよび ArcSDE ジオデータベースの格納パラメータ(コンフィグレーション)を指定します。パーソナル ジオデータベースは、コンフィグレーション キーワードを使用しません。

ArcSDE コンフィグレーション キーワードは、データベース管理者によって設定されます。

String
mosaic_mode
(オプション)

The method used to mosaic overlapping areas.

  • FIRSTThe output cell value of the overlapping areas will be the value from the first raster dataset mosaicked into that location.
  • LASTThe output cell value of the overlapping areas will be the value from the last raster dataset mosaicked into that location. This is the default.
  • BLENDThe output cell value of the overlapping areas will be a horizontally weighted calculation of the values of the cells in the overlapping area.
  • MEANThe output cell value of the overlapping areas will be the average value of the overlapping cells.
  • MINIMUMThe output cell value of the overlapping areas will be the minimum value of the overlapping cells.
  • MAXIMUMThe output cell value of the overlapping areas will be the maximum value of the overlapping cells.
String
colormap_mode
(オプション)

The method used to choose which colormap from the input rasters will be applied to the mosaic output.

  • FIRSTThe colormap from the first raster dataset in the list will be applied to the output raster mosaic. This is the default.
  • LASTThe colormap from the last raster dataset in the list will be applied to the output raster mosaic.
  • MATCHEnsures that all the colors from the input raster datasets are in the final colormap and that they are all unique.
  • REJECTOnly the raster datasets that do not have a colormap associated with them will be mosaicked.
String
pyramid_origin
(オプション)

This is the origination location of the raster pyramid. It is recommended that you specify this point if you plan on building large mosaics in a file geodatabase or an ArcSDE geodatabase, especially if you are plan on mosaicking to them over time (for example, for updating).

The pyramid reference point should be set to the upper left corner of your raster dataset.

In setting this point for a file geodatabase or an ArcSDE geodatabase, partial pyramiding will be used when updating with a new mosaicked raster dataset. Partial pyramiding updated the parts of the pyramid that do not exist due to the new mosaicked datasets. Therefore, it is good to set your pyramid reference point so that your entire raster mosaic will be below and to the right of this point. However, a pyramid reference point should not be set too large either.

Point
ignore_background_value
(オプション)

ラスタ データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。指定した値は、ラスタ データセットの他の有用なデータと区別されます。たとえば、ラスタ データセットの境界に沿ったゼロ値は、ラスタ データセット内のゼロ値と区別されます。

指定したピクセル値は、出力ラスタ データセットでは NoData に設定されます。

ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ArcSDE およびファイル ジオデータベース ラスタについては、この余分の処理を行う必要はありません。

Double
nodata_value
(オプション)

指定した値を持つすべてのピクセルが、出力ラスタ データセットでは NoData に設定されます。

Double
convert_1_bit_data_to_8_bit
(オプション)

入力の 1 ビット ラスタ データセットを 8 ビット ラスタ データセットに変換するかどうかを選択します。この変換では、入力ラスタ データセットの値 1 が出力ラスタ データセットの 255 に変更されます。これは、1 ビット ラスタ データセットを ArcSDE にインポートするときに便利です。1 ビット ラスタ データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤを持ちますが、ArcSDE では 1 ビット ラスタ データセットは 1 ビット ピラミッド レイヤしか持つことができず、そのために表示が不十分なものになります。このデータを ArcSDE の 8 ビットに変換すると、ピラミッド レイヤが 1 ビットではなく 8 ビットとして作成されるため、本来のラスタ データセットが表示されます。

  • NONE変換を実行しません。これがデフォルトです。
  • OneBitTo8Bit入力ラスタが変換されます。
Boolean
mosaic_tolerance
(オプション)

モザイク化を実行したときに、ターゲット ピクセルとソース ピクセルの位置がいつも正確に揃うとは限りません。ピクセルの位置にずれがある場合は、リサンプリングを実行するかそれともデータをシフトするかを決める必要があります。ピクセルのリサンプリングを実行するか、それともピクセルをシフトするかは、モザイク化の許容値によって制御されます。

入力データセットとターゲット データセットのピクセル配置の差が許容値より大きければ、リサンプリングが実行されます。入力データセットとターゲット データセットのピクセル配置の差が許容範囲内であれば、リサンプリングは実行されません(代わりに、シフトが実行されます)。

The unit of tolerance is a pixel; the valid value range is 0 to 0.9999. The maximum a pixel can be shifted is 0.5, so anything you set that is greater than 0.5 will guarentee a shift takes place. A tolerance of zero guantees resampling, if there is a misalignment in pixels.

たとえば、ソース ピクセルとターゲット ピクセルのずれが 0.25 であるとします。モザイク化の許容値が 0.2 に設定されていると、ピクセルのずれが許容値を上回るため、リサンプリングが発生します。モザイク化の許容値が 0.3 に設定されていると、ピクセルがシフトします。

Float

コードのサンプル

import arcgisscripting
gp = arcgisscripting.create()
 
gp.WorkspaceToNewMosaic_samples("D:\\temp\\tempws, "Database Connections\\raster.sde", "wrksp_to_new_mosaic", "#" "LAST", "FIRST", "#", "#", "#", "#", "0")

環境

このツールは、ジオプロセシング環境を使用しません

4/24/2012