Scroll to navigation

DCLTRF(1) GFD Dennou Club Library DCLTRF(1)

NAME

dcltrf - list available DCL coordinate transformation numbers and names

SYNOPSIS

dcltrf [ transformation_number ]

DESCRIPTION

dcltrf is a utility program included in the GFD Dennou Club Library (DCL). It lists the defined Normalization Transformation Numbers (NTR) and their descriptions.

In DCL, coordinate systems (such as linear, logarithmic, or various map projections) are managed via integer IDs called Transformation Numbers (NTR). This utility helps users identify which ID corresponds to which coordinate system.

Operation

  • If executed without arguments, it scans transformation numbers from 1 to 99 and prints the details of all defined transformations.
  • If a transformation_number is provided as an argument, it displays information only for that specific ID. If the ID is not defined, an error message is displayed.

Output Format

The output consists of the ID, a short code (3 characters), and a description (20 characters):

NTR = id ; code ; description ;

OPTIONS

An integer between 1 and 99. If specified, details for only this transformation are shown.

dcltrf also accepts standard DCL runtime parameters via command-line options.

EXAMPLES

To list all available transformations:

$ dcltrf
NTR = 1 ; C ; CARTESIAN ;
NTR = 2 ; X ; X-LOG ;
NTR = 3 ; Y ; Y-LOG ;
NTR = 4 ; XY ; LOG-LOG ;
...

To check the definition of transformation number 10:

$ dcltrf 10
NTR = 10 ; CYL ; CYLINDRICAL ;

To check an undefined number (e.g., 99):

$ dcltrf 99
MSG: DCLTRF: TRANSFORMATION NUMBER 99 IS NOT DEFINED.

AUTHORS

Youhei SASAKI <uwabami@gfd-dennou.org>, GFD Dennou Club

SEE ALSO

dclpara(1), dclconfig(1)

2026-01-23 DCL 7.5.2