Description
The BufferFeatures process creates area features around existing features.
Inputs
Points, lines and/or area features in a supported format. Supported formats include H2O, HOB, S-57 ENC (000), DES, DGN, DXF, DWG, SHP, GML, KML, MapInfo File, SQLite, GeoPackage, CARIS WKT, LHT, and XML.
Outputs
Areas features in a supported format. Supported formats include GML, KML, MapInfo File, SQLite, GeoPackage, CARIS WKT.
Command Line Syntax
carisbatch --run BufferFeatures --distance <value> [options] <input> <output>
User Interface Command
Options
The following table describes the parameters available for this process.
Parameter |
| |||
|---|---|---|---|---|
Long | Short | Description | Can Repeat | Notes
|
--buffer-crs | A string specifying the projected coordinate reference system to be used in buffer calculations. For time-dependent coordinate reference systems, the epoch can be specified, typically using the year as <crs_id>@1997. A fractional year can also be specified, such as <crs_id>@1997.3, if needed. If no epoch is specified, the reference epoch of the coordinate reference system is used. The buffer CRS must be a projected CRS. The default is to use the CRS of the buffered features if this is a projected CRS. Otherwise, a best fit projected CRS is calculated for each feature. A UTM zone is used if possible, and if not, a Lambert Conformal Equal Area projection, and if not, a polar stereographic, and if not, World Mercator. | FALSE | The resulting features will be output using the CRS of the input features. If the buffer CRS differs from the input CRS, the buffer areas will be transformed to the input CRS when the output file is generated. | |
--distance | A number specifying the buffer offset distance from the input features. The unit must be specified. Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd. | FALSE | ||
--scale | s | A number specifying the scaling to apply to the distance (1:scale). The default scale value is 1, such that the distance is measured on the ground. A scale of 1000 would mean that the distance is measured on a map at 1:1000 scale. | FALSE | |
--feature-catalogue | F | A string specifying the name of the catalogue that defines the features and attributes in a vector dataset. One of { list dynamically populated from the catalogue control file }. The names of the available catalogues can be accessed through application via the Object Catalogue environment variable in Tools > Options. The available catalogues are controlled by the Catalogue Control file. An example of a catalogue name is "S-57 ENC 3.1". | FALSE | A catalogue must be specified only when the input is a HOB file. |
--area-method | A string specifying the convention for creating buffers for area features. • OUTSIDE: Create buffers outside the features. Holes are made smaller. • INSIDE: Create buffers inside the features. Holes are made larger. The default is OUTSIDE. | FALSE | ||
--line-end-style | A string specifying the end style created for buffers around line features. • ROUND: Buffers extend past the end of lines and are rounded. • BUTT: Buffers end where lines end and are squared. • PROJECTED: Buffers extend past the end of lines and are squared. The default is ROUND. | FALSE | ||
Example
To use this command refer to the following example.
Example | ||
|---|---|---|
Objective | You want to add features to an existing map. | |
Description | Command Line Syntax | |
The input data is in a HOB file that is using an S-57 ENC 3.1 feature catalogue. | --feature-catalogue "S-57 ENC 3.1" | |
The buffer areas will be created with a 10m offset from the source features. | --distance 10m | |
The input file is named InputFeatures.hob and is located at D:\BatchSample. | D:\BatchSample\InputFeatures.hob | |
The output file is named BufferFeatures.hob and is also located at D:\BatchSample. | D:\BatchSample\BufferFeatures.hob | |
Command Line |
| |
Outcome | Buffer area features are created for the features in the input file and saved to the a new file in the specified location. | |
Extra Notes | N/A | |