worldfile.xl (Conversion of World Files)

Author: Hirohisa Mori / joshua@globalbase.org + [Transrate]Reiko Inoue Bendtsen c/o Suzaku Translations / (http://www.suzaku-translations.com/) +

PROTOTYPE

xl worldfile.xl / direct [prefix] [unit] [crd]

xl worldfile.xl / csv [encoding] [filename]

ARGUMENTS

[prefix] Extension of conversion source data

[unit] Length unit of conversion source coordinate system

[crd] Mapping destination coordinate system file after conversion

[encoding] Character coding name of CSV files

[filename] CSV file name

Option

ENVIRONMENT

Agent xl [UNDEF REF (xl)]

EXPLANATION

If you specify direct for the first argument, multiple world files are mapped to a single coordinate system [crd]. If you specify csv for the first argument, each world file read from a csv file [filename] written in a given format is mapped to a different coordinate system, and the coordinate system is further mapped to a coordinate system specified by [crd] based on the world file.

Conversion by the direct option is used when multiple world files are considered to be parts of a single image. On the other hand, conversion by the csv option can be used when multiple world files are completely independent separate images.

In case of conversion using the direct option, [prefix] specifies the extension of a world file image. It does not apply to image files with other extensions. [unit] indicates the unit of data in a world file. This unit must also be the base unit of the mapping destination coordinate system. [crd] indicates the mapping destination coordinate system.


	$ xl worldfile.xl - - / direct tif m ginowan.crd
	....
	$

If the command above is issued, .lst and .cr files are generated for all the .tif world files in the working directory and .map file for mapping the .lst file to ginowan.crd based on the world file is generated.

In case of conversion using the csv option, specify the character code name used to descrive CVS files for [encoding]. [filename] indicates the target CSV file.

In a csv file, write each world file on a separate line and enter bibliographic information generated for each world file name ( without extension) and world file. Insert a control command at the end of a file. Figure Fig.(CSV file ) shows a cvs file opened in Excel.

Figure CSV file

Lines starting with "#" are comments and are ignored during processing. All the lines starting from "." in the last half of the file are commands. Please refer to "CSV Commands for worldfile.xl Scripts Reference"for the detailed explanation on commands.

As a general rule, commands follow a syntax where one command is written on one line, the command name is written at the beginning of the line and options unique to bibliographic data written in each line are given in column B and onward. The commands used in this example are briefly explained below.

Specify a alphabet character type in the .character line. Characters in lines where small is specified are all converted to lower case. If no option is specified, no conversion is performed.

Specify a character string that must be placed before bibliographic data in the .pre.string line. No character strings are prefixed if no option is specified.

.qualifier indicates which line of bibliographic data shall correspond to which qualifier. If no qualifier is specified in a line, it is not included in the bibliographic data.

Specify the data type of the bibliographic data for .qtype.

Specify bibliographic data common to all coordinate systems for .qdata.

Specify a coordinate system URLL to which world files are mapped, regardless of other lines, for .wf.mapping.

Specify an image file extension in lines where names of world files to be processed are written for .wf.processing.

[UP] Go To Page Top

RETURN VALUE

In case the direct option is used
.lst, .cr and .map files corresponding to each world file
A .map file specifies a mapping from a .lst file to [crd].
In case the csv option is used
.lst, .cr, .map(1) , .map(2) , and .crd files corresponding to each world file
.map(1) specifies a mapping from a .lst file to a .crd file.
.map(2) specifies a mapping from a .crd file to a [crd] file.

ERRORS

REFERENCE

BUGS

[UP] Go To Page Top