v.transform(1)

1v.transform(1)                Grass User's Manual               v.transform(1)
2
3
4

NAME

6       v.transform   - Transforms an vector map layer from one coordinate sys‐
7       tem into another coordinate system.
8

KEYWORDS

10       vector
11

SYNOPSIS

13       v.transform
14       v.transform help
15       v.transform   [-qts]   input=name   output=name     [pointsfile=string]
16       [xshift=float]     [yshift=float]     [zshift=float]     [xscale=float]
17       [yscale=float]   [zscale=float]   [zrot=float]   [--overwrite]
18
19   Flags:
20       -q  Suppress display of residuals or other information
21
22       -t  Shift all z values to bottom=0
23
24       -s  Instead of  points  use  transformation  options  (xshift,  yshift,
25           zshift, xscale, yscale, zscale, zrot)
26
27       --overwrite
28
29   Parameters:
30       input=name
31           Name of input vector map
32
33       output=name
34           Name for output vector map
35
36       pointsfile=string
37           ASCII file holding transform coordinates
38
39       xshift=float
40           Shifting value for x coordinates Default: 0.0
41
42       yshift=float
43           Shifting value for y coordinates Default: 0.0
44
45       zshift=float
46           Shifting value for z coordinates Default: 0.0
47
48       xscale=float
49           Scaling factor for x coordinates Default: 1.0
50
51       yscale=float
52           Scaling factor for y coordinates Default: 1.0
53
54       zscale=float
55           Scaling factor for z coordinates Default: 1.0
56
57       zrot=float
58           Rotation around z axis in degrees counterclockwise Default: 0.0
59

DESCRIPTION

61       v.transform  transforms  a  vector map layer from one coordinate system
62       into another coordinate system.
63

NOTES

65       When using an ASCII  table  containing  source  and  target  coordinate
66       pairs, in each row four coordinate values separated by white space have
67       to be specified.  Comments are permitted and have to be indicated by  a
68       '#' character.
69
70       Example  for  a  points  file of a linear transformation from XY to UTM
71       coordinates (L: left, R: right, U: upper, L: lower, N, S, W, E):
72       # Linear transformation from XY to UTM coordinates:
73       # 4 maps corners defined
74       # UL NW
75       # UR NE
76       # LR SW
77       # LL SE
78       -584 585  598000 4920770
79       580  585  598020 4920770
80       580  -600 598020 4920750
81       -584 -600 598000 4920750
82        The ground control points may be also  (ir)regularly  distributed  and
83       can be more than four points.
84

EXAMPLE

86       Most DXF/DWG drawings are done within XY coordinates. To transform them
87       to a national grid, we can use 'v.transform' with a 4 point transforma‐
88       tion
89
90       v.transform   -t   in=watertowerXY  out=watertowerUTM  points=wt.points
91       zscale=0.04 zshift=1320
92
93

AUTHOR

98       Radim Blazek, ITC-Irst, Trento, Italy
99
100       Last changed: $Date: 2006/01/11 10:26:57 $
101
102       Full index
103
104
105
106GRASS 6.2.2                                                     v.transform(1)