|
1 | | -% International Terrestrial Reference Frame (ITRF) Matlab Toolbox. |
2 | | -% Version 1.2 (26 May 2025). |
3 | | -% |
4 | | -% Coordinate transformations between different ITRS and ETRS89 realizations. |
5 | | -% |
6 | | -% Synopsis: |
7 | | -% |
8 | | -% crdvelout=itrf2itrf(crdvelin,from,to,yearin,yearout) |
9 | | -% crdout=itrf2itrf(crdin,from,to,yearin) |
10 | | -% |
11 | | -% Main function: |
12 | | -% |
13 | | -% itrf2itrf - Transform coordinates/velocities between various ITRF's and |
14 | | -% ETRF2000, ETRF2014 and ETRF2020. |
15 | | -% pmmvel - Get velocity from Plate Motion Model parameters. |
16 | | -% |
17 | | -% Other functions: |
18 | | -% |
19 | | -% itrftp - Get ITRF transformation parameters at a certain epoch |
20 | | -% itrftables - Print table with transformation parameters between ITRF's. |
21 | | -% itrf2etrf - Transform coordinates/velocities between ITRFyy and ETRFyy. |
22 | | -% |
23 | | -% Support functions: |
24 | | -% |
25 | | -% itrftpdef - Define ITRF transformation parameters |
26 | | -% etrftpdef - Define ETRF transformation parameters |
27 | | -% pmmpar - Define Plate Motion Model parameters. |
28 | | -% dijkstra - Find shortest path in a graph using Dijkstra's algorithm |
29 | | -% trafo3d - 3D similarity transformation with 7 or 14 parameters |
30 | | -% |
31 | | -% Demo/test functions: |
32 | | -% |
33 | | -% testitrf - Test itrf2itrf using actual ITRF coordinates |
34 | | -% testpmm - Test Plate Model Motion (PMM) functions |
35 | | -% |
36 | | -% Notes: |
37 | | -% |
38 | | -% (1) itrf2itrf supports also transformations between ITRFyy and ETRF2000, |
39 | | -% ETRF2014 and ETRF2020. |
40 | | -% (2) itrf2etrf only supports transformations between ITRFyy and ETRFyy, or |
41 | | -% vice versa, for the same year. |
42 | | -% |
43 | | -% crdvelout=itrf2etrf(crdvelin,from,to,yearin,yearout) |
44 | | -% crdout=itrf2etrf(crdin,from,to,yearin) |
45 | | -% |
46 | | -% Mainly useful for legacy ETRF. For operations involving ETRF2000, |
47 | | -% ETRF2014 and ETRF2020 you are better off with itrf2itrf. |
48 | | -% To preform transformations between legacy ETRF split the transform |
49 | | -% in two steps, e.g. |
50 | | -% |
51 | | -% ITRFxx -> ETRFxx itrf2etrf |
52 | | -% ETRFxx -> ITRFxx itrf2etrf |
53 | | -% ITRFxx -> ETRFyy : |
54 | | -% ITRFxx -> ITRFyy itrf2itrf |
55 | | -% ITRFyy -> ETRFyy itrf2etrf |
56 | | -% ETRFxx -> ITRFyy : |
57 | | -% ETRFxx -> ITRFxx itrf2etrf |
58 | | -% ITRFxx -> ITRFyy itrf2itrf |
59 | | -% ETRFxx -> ETRFyy : |
60 | | -% ETRFxx -> ITRFxx itrf2etrf |
61 | | -% ITRFxx -> ITRFyy itrf2itrf |
62 | | -% ITRFyy -> ETRFyy itrf2etrf |
63 | | -% |
64 | | -% (3) Dijkstra's algorithm to find the shortest path is used to construct |
65 | | -% all possible combinations of transformations. |
66 | | -% |
67 | | -% Examples: |
68 | | -% |
69 | | -% crdvelout=itrf2itrf( ... |
70 | | -% [ 3899225.258 396731.815 5015078.341 -.0130 .0158 .0092 ; ... |
71 | | -% 3812141.404 395731.729 4995987.219 .0004 -.0013 .0002 ],... |
72 | | -% 'ITRF2005','ITRF2000',2008.4,2000.0) |
73 | | -% |
74 | | -% crdout=itrf2itrf( ... |
75 | | -% [ 3899225.258 396731.815 5015078.341 ; ... |
76 | | -% 3812141.404 395731.729 4995987.219 ],... |
77 | | -% 'ITRF2005','ITRF2000',2008.4) |
78 | | -% |
79 | | -% crdvelout=itrf2itrf( ... |
80 | | -% [3924687.552 301132.856 5001910.904 -.0150 .0164 .0070], ... |
81 | | -% 'ITRF2000','ETRF2000',1997.0,1989.0) |
82 | | -% |
83 | | -% The Matlab functions in this package are free software: you can redistribute |
84 | | -% it and/or modify it under the terms of the GNU General Public License as |
85 | | -% published by the Free Software Foundation <http://www.gnu.org/licenses/>. |
86 | | -% |
87 | | -% This software is distributed in the hope that it will be useful, but WITHOUT |
88 | | -% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
89 | | -% FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. |
90 | | -% |
91 | | -% (c) Hans van der Marel, Delft University of Technology, 2012-2025. |
| 1 | +% International Terrestrial Reference Frame (ITRF) Matlab Toolbox. |
| 2 | +% Version 1.2 (26 May 2025). |
| 3 | +% |
| 4 | +% Coordinate transformations between different ITRS and ETRS89 realizations. |
| 5 | +% |
| 6 | +% Synopsis: |
| 7 | +% |
| 8 | +% crdvelout=itrf2itrf(crdvelin,from,to,yearin,yearout) |
| 9 | +% crdout=itrf2itrf(crdin,from,to,yearin) |
| 10 | +% |
| 11 | +% Main function: |
| 12 | +% |
| 13 | +% itrf2itrf - Transform coordinates/velocities between various ITRF's and |
| 14 | +% ETRF2000, ETRF2014 and ETRF2020. |
| 15 | +% pmmvel - Get velocity from Plate Motion Model parameters. |
| 16 | +% |
| 17 | +% Other functions: |
| 18 | +% |
| 19 | +% itrftp - Get ITRF transformation parameters at a certain epoch |
| 20 | +% itrftables - Print table with transformation parameters between ITRF's. |
| 21 | +% itrf2etrf - Transform coordinates/velocities between ITRFyy and ETRFyy. |
| 22 | +% |
| 23 | +% Support functions: |
| 24 | +% |
| 25 | +% itrftpdef - Define ITRF transformation parameters |
| 26 | +% etrftpdef - Define ETRF transformation parameters |
| 27 | +% pmmpar - Define Plate Motion Model parameters. |
| 28 | +% dijkstra - Find shortest path in a graph using Dijkstra's algorithm |
| 29 | +% trafo3d - 3D similarity transformation with 7 or 14 parameters |
| 30 | +% |
| 31 | +% Demo/test functions: |
| 32 | +% |
| 33 | +% testitrf - Test itrf2itrf using actual ITRF coordinates |
| 34 | +% testpmm - Test Plate Model Motion (PMM) functions |
| 35 | +% |
| 36 | +% Notes: |
| 37 | +% |
| 38 | +% (1) itrf2itrf supports also transformations between ITRFyy and ETRF2000, |
| 39 | +% ETRF2014 and ETRF2020. |
| 40 | +% (2) itrf2etrf only supports transformations between ITRFyy and ETRFyy, or |
| 41 | +% vice versa, for the same year. |
| 42 | +% |
| 43 | +% crdvelout=itrf2etrf(crdvelin,from,to,yearin,yearout) |
| 44 | +% crdout=itrf2etrf(crdin,from,to,yearin) |
| 45 | +% |
| 46 | +% Mainly useful for legacy ETRF. For operations involving ETRF2000, |
| 47 | +% ETRF2014 and ETRF2020 you are better off with itrf2itrf. |
| 48 | +% To preform transformations between legacy ETRF split the transform |
| 49 | +% in two steps, e.g. |
| 50 | +% |
| 51 | +% ITRFxx -> ETRFxx itrf2etrf |
| 52 | +% ETRFxx -> ITRFxx itrf2etrf |
| 53 | +% ITRFxx -> ETRFyy : |
| 54 | +% ITRFxx -> ITRFyy itrf2itrf |
| 55 | +% ITRFyy -> ETRFyy itrf2etrf |
| 56 | +% ETRFxx -> ITRFyy : |
| 57 | +% ETRFxx -> ITRFxx itrf2etrf |
| 58 | +% ITRFxx -> ITRFyy itrf2itrf |
| 59 | +% ETRFxx -> ETRFyy : |
| 60 | +% ETRFxx -> ITRFxx itrf2etrf |
| 61 | +% ITRFxx -> ITRFyy itrf2itrf |
| 62 | +% ITRFyy -> ETRFyy itrf2etrf |
| 63 | +% |
| 64 | +% (3) Dijkstra's algorithm to find the shortest path is used to construct |
| 65 | +% all possible combinations of transformations. |
| 66 | +% |
| 67 | +% Examples: |
| 68 | +% |
| 69 | +% crdvelout=itrf2itrf( ... |
| 70 | +% [ 3899225.258 396731.815 5015078.341 -.0130 .0158 .0092 ; ... |
| 71 | +% 3812141.404 395731.729 4995987.219 .0004 -.0013 .0002 ],... |
| 72 | +% 'ITRF2005','ITRF2000',2008.4,2000.0) |
| 73 | +% |
| 74 | +% crdout=itrf2itrf( ... |
| 75 | +% [ 3899225.258 396731.815 5015078.341 ; ... |
| 76 | +% 3812141.404 395731.729 4995987.219 ],... |
| 77 | +% 'ITRF2005','ITRF2000',2008.4) |
| 78 | +% |
| 79 | +% crdvelout=itrf2itrf( ... |
| 80 | +% [3924687.552 301132.856 5001910.904 -.0150 .0164 .0070], ... |
| 81 | +% 'ITRF2000','ETRF2000',1997.0,1989.0) |
| 82 | +% |
| 83 | +% The Matlab functions in this package are free software: you can redistribute |
| 84 | +% it and/or modify it under the terms of the GNU General Public License as |
| 85 | +% published by the Free Software Foundation <http://www.gnu.org/licenses/>. |
| 86 | +% |
| 87 | +% This software is distributed in the hope that it will be useful, but WITHOUT |
| 88 | +% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
| 89 | +% FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. |
| 90 | +% |
| 91 | +% (c) Hans van der Marel, Delft University of Technology, 2012-2025. |
0 commit comments