worldfilewrite

Write world file from raster reference object

Syntax

worldfilewrite(R,worldfilename)


Description

worldfilewrite(R,worldfilename) calculates the world file entries corresponding to reference object R and writes them into the file worldfilename. Specify R as a GeographicCellsReference, GeographicPostingsReference, MapCellsReference, or MapPostingsReference object.

Examples

Write out the information from a reference object for the image file concord_ortho_w.tif

info = imfinfo('concord_ortho_w.tif');
R = worldfileread('concord_ortho_w.tfw','planar',[info.Height info.Width])
worldfilewrite(R,'concord_ortho_w_test.tfw');
type concord_ortho_w_test.tfw

Version History

Introduced before R2006a

R2023b: worldfilewrite warns when you specify referencing matrices as input

When you specify a referencing matrix as input, the worldfilewrite function issues a warning that it will not accept referencing matrices as input in a future release. Use a geographic raster reference object (specified as a GeographicCellsReference or GeographicPostingsReference object) or a map raster reference object (specified as a MapCellsReference or MapPostingsReference object) as input instead. Reference objects have several advantages over referencing matrices.

• Unlike referencing matrices, reference objects have properties that document the size of the associated raster, its limits, and the direction of its rows and columns.

• You can manipulate the limits of rasters associated with reference objects using the geocrop or mapcrop function.

• You can manipulate the size and resolution of rasters associated with reference objects using the georesize or mapresize function.

Depending on whether the referencing matrix is in geographic or planar coordinates, there are different ways to update your code.

Geographic Coordinates

If the referencing matrix is in geographic coordinates, create a geographic reference object.

• Create a geographic reference object for a raster of cells by using the georefcells function.

• Create a geographic reference object for a raster of regularly posted samples by using the georefpostings function.

• Convert from a referencing matrix to a geographic reference object by using the refmatToGeoRasterReference function.

Once you have created a reference object, replace uses of the referencing matrix in your code with the reference object.

Planar Map Coordinates

If the referencing matrix is in planar map coordinates, create a map reference object.

• Create a map reference object for a raster of cells by using the maprefcells function.

• Create a map reference object or for a raster of regularly posted samples by using the maprefpostings function.

• Convert from a referencing matrix to a map reference object by using the refmatToMapRasterReference function.

Once you have created a reference object, replace uses of the referencing matrix in your code with the reference object.

R2022b: worldfilewrite will not accept referencing matrices as input

The worldfilewrite function will not accept referencing matrices as input in a future release.