Debian Codegraph @

Changes

raw
1 Revision history for Perl extension Geo::Coordinates::OSGB
2
3 2.20 November 2017
4
5 - Replaced OSTN02 data set with OSTN15, the new OSGB standard
6
7 - Moved OSTN data to external files
8
9 - Removed function to inspect OSTN data shifts
10
11 - Updated pod in OSGB.pm and OSGB/Background.pod
12
13 - Drop support for Perl 5.08 - if you must have 5.08 see the note in OSGB.pm
14
15 2.19 July 2017
16
17 - Go faster stripes on main conversion routines
18
19 - Replaced three of the example scripts with a new single multifunction example script
20
21 2.18 June 2017
22
23 - Fix small bug in Grid.pm: removed recent use of "//=", so that the module still works with Perl 5.8
24
25 - Minor refactoring to obey more of perl-critic and perl-tidy
26
27 - Fixed version numbers and date marks
28
29 2.17 June 2017
30
31 - Put an ':all' tag back in OSGB.pm
32
33 - Restored ability to parse a grid reference consisting of a single sheet name
34
35 - Corrected pod in `build/make_maps_code`
36
37 - Minor updates to documentation
38
39 - More rigorous accuracy test in t/06osdata.t
40
41 - Added small bench mark test
42
43 2.16 February 2016
44
45 - Fix bug in OSGB.pm with "unpack" under Perl V5.8
46
47 - Minor documentation corrections
48
49 2.15 February 2016
50
51 - Clearer explanation of changes since V2.10 in README and Background.pod
52
53 - Changed examples/plot_maps to use proper OSTN02 polygons instead of just marking points
54
55 - Improved decimal degrees to degrees, minutes, seconds function in examples/bng_to_ll
56
57 - Fixed examples/plot_maps.pl so that it makes a better attempt to show more
58 than one map series on the same plot
59
60 - Minor corrections and additions to documentation
61
62 - Moved build utilities to new 'build' directory + improved documentation for them
63
64 - Packed OSTN02 data more densely so that OSGB.pm is smaller
65
66 - Corrected data points at eastern boundary of OSTN02 area
67
68
69 2.14 February 2016
70
71 - Found and fixed a bug the core ellipsoid projection routine that was causing
72 the unexpectedly inaccurate results in higher latitudes.
73
74 - Extensive performance improvements to OSTN02 data look up
75
76 - random_grid function now checks that the random grid position
77 it selects is well inside the OSTN02 boundary
78
79 - parse_grid function will now parse a grid square name. For example
80 "parse_grid('TA')" will return (500000,400000).
81
82 - Fixed various typos in Pod sections in all modules, and added more
83 explanations in Background.pod
84
85 2.13 February 2016
86
87 - Re-organized, and much faster, OSTN02 data look up
88
89 - format_grid now supports ... { form => 'SS' } ... to get just the grid square.
90
91 - Updated examples with proper documentation and improved plotting of maps
92
93 - Minor change in t/08out_of_range.t and t/13edge.t tests to allow for Perl
94 with "long double" enabled. Corresponding updates to documentation.
95 This does not affect any function; I've simply made the tests more
96 robust. I should add that "long doubles" do not appear to benefit this
97 module at all. The results and accuracy that I get are the same with
98 "long doubles" but everything runs about 10% slower.
99
100 2.12 January 2016
101
102 - Re-worked the handling of points near the boundary of the OSTN02 polygon,
103 to avoid a potential loop in rare cases. This is unlikely to affect any
104 transformations with real coordinates (unless you spend a lot of time in
105 boats about 10km offshore), but avoids some problems in my testing with
106 random grid points.
107
108 - Simplified OSTN02 data access. Removed the OSGM02 height part of the
109 data as this is no longer used. This makes the module somewhat smaller
110 and a little faster to load.
111
112 - Added user interface to approximate conversion routines for quick Helmert
113 transformations: "grid_to_ll_helmert" and "ll_to_grid_helmert"
114
115 - Fixed a small bug in "parse_grid", so that it allows '/' character in map
116 sheet names, and therefore works with sheet names like: 'B:110/OL44'
117
118 - Corrected structure of POD documentation in Maps.pm and Background.pm
119
120 - Simplified testing of random grid references to give more reliable
121 results. Added more tests based on OS transformations, and to prove
122 some edge conditions.
123
124
125 2.11 January 2016
126
127 - Small bug fixes only
128
129 - Removed the 'r' switch from the single use of the 'tr' function. This accidentally
130 created a dependency on perl 5.14 which caused several CPAN testers to fail 2.10.
131
132 - Added 'use 5.008' to main modules: everything should now work on perl 5.8 or better.
133
134 - Added note about accuracy of OSTN02 in grid square HP (far north of Shetland) and changed
135 the random round-trip tests to avoid this square. For reasons I do not understand, the
136 accuracy of round trip conversion with this implementation of OSTN02 is within a few mm
137 for most of the country, but suddenly drops to an average of about 25m in grid square HP.
138
139 - Minor clean up of pod formatting in a couple of places
140
141
142 2.10 January 2016
143
144 - Complete simplification and restructure of the entire module
145
146 - Geo::Coordinates::OSGB now provides only:
147
148 grid_to_ll
149 ll_to_grid
150
151 - WGS84 is assumed as the default ellipsoid shape
152 - OSTN02 data is automatically used where necessary providing much a simpler interface
153 - New Helmert transformation routines automatically used outside OSTN02 coverage
154
155 - New module Geo::Coordinates::OSGB::Grid provides routines to parse and format grid references
156 -- general purpose "format_grid" for all formatting
157 -- general purpose "parse_grid" for all parsing
158
159 - New module Geo::Coordinates::OSGB::Maps provides outlines, bounding boxes, and titles for OSGB maps
160
161 - The functions `shift_ll_into_WGS84` and `shift_ll_from_WGS84` are no longer provided (or needed).
162
163 - The functions formerly provided by OSTN02.pm are integrated into OSGB.pm, so the subroutines
164 `OSGB36_to_ETRS89` and `ETRS89_to_OSGB36` are no longer provided (or needed).
165
166 - The functions to parse and format grid references are moved to OSGB/Grid.pm.
167
168 - The functions to parse and format lat/lon are removed, because they are better provided by other modules.
169
170 For more details, see the section on "Upgrading" in Background.pod
171
172
173 2.09 October 2015
174
175 - Improved and generalized handling of maps to allow for multiple series, insets, and irregular boundaries
176 - New generic functions "format_grid_map" and "parse_map_grid" to replace the Landranger-specific functions
177 - Complete insets and extensions to sheet boundaries for Landranger maps
178 - Complete sheet boundaries for old One Inch 7th series maps
179 - Complete sheet boundaries for Explorer series of 1:25000 maps
180 - Reorganized distribution:
181 -- example scripts are in examples/
182 -- map definitions are in maps/
183 - Minor improvements to precision
184
185 2.08 June 2015
186
187 - reduced size of the data table in OSTN02 and improved loading time
188
189 - new "random_grid" function in OSGB returns a random point on a random Landranger map.
190 See "gbguessr.pl" script for example use to compare OS maps and Google maps on same point
191
192 - removed old kml generating example script
193 - revised and improved documentation
194
195 2.07 June 2015
196
197 - removed dependency on Math::Trig for tan and sec functions
198 - removed unnecessary package variables from OSTN02
199 - simplified unpacking of data in OSTN02
200
201 2.06 October 2013
202
203 - removed precise URL for theory paper - the OS keep moving it about, so just Google for the name
204 - removed non-ascii characters from POD in OSGB.pm to avoid encoding issue
205
206 2.05 31 August 2013
207
208 - Put blank lines back in OSTN02 to prevent pod2html taking an age during install
209 - Refactored OSGB and OSTN02 lightly to conform more closely to "Perl Best Practices"
210 - corrected corner coordinate data for Landranger sheets 1 and 185
211
212 2.04 6 November 2008
213
214 - Rework search of OSTN02 data to improve performance and reliability
215 - Add range checking of OSTN02 coordinates
216 - Compress OSTN02 data to hexadecimal form to speed up loading
217 - Change selection of data in 03random.t test to avoid off-the-sheet errors
218 - Minor tidy up changes in OSGB
219 - Complete overhaul of the documentation
220 - removed old "coco.pl" example script
221 - added new example script to show all "000 000" grid references
222
223 2.03 Not released
224
225 2.02 22 September 2008
226
227 - Removed irritating degree sign from verbose test message (no functional change)
228 - Make parse_landranger_grid behave better in scalar context
229 - Improve useability of parse_grid
230 - Correct GR of SW corner of Landranger Sheet 3
231 - Further optimize handling of OSTN02 data to prevent data parsing at pod2man time
232 - Improve documentation
233 - More example scripts (with notes)
234
235 2.01 6 September 2007
236
237 - Optimized handling of OSTN02 data to reduce memory requirements *and* speed it up.
238
239 2.00 4 September 2007
240
241 - New version with routines to do adjustment to and from latitude and
242 longitude coordinates based on the (now ubiquitous) WGS84 model, for
243 more compatible use with GPS receivers and Google Earth and similar
244 tools.
245
246 - Includes not only fast approximate adjustment as used in most
247 coordinate tools and devices, but also the definitive-but-slow OSTN02
248 transformation based on OSGB data
249
250 - Step version number
251
252 - POD completely revised
253
254
255 1.07 7 September 2005
256
257 - corrected link in POD
258
259 - various minor documentation corrections
260
261 1.06 16 May 2005
262
263 - general clean up
264
265 - made the format and parse routines external to avoid spaghetti connections
266
267 - added support for grid references in GPS format (eg TQ 32342 24312)
268
269 1.05 29 March 2005
270
271 - Not released
272
273 1.04 29 September 2004
274
275 - corrected a bug in grid2ll, where long/lat values with 0 degrees
276 were always printed as positive in scalar form The problem was that
277 -1 * 0 = +0 in Perl (as it says in the Camel book somewhere).
278
279 - added simple coco.pl script to provide command line coordinate
280 conversions.
281
282 - actually implemented the long-promised map2ll and ll2map functions
283 as well as map2grid and grid2map for completeness. With these
284 functions you can convert to and from coordinates in a more useable
285 form, such as "OS Sheet 43; 875123".
286
287 - added a demonstration script --- plotmaps.pl --- which will produce
288 a pretty index of the Landranger maps, showing the GB coast line
289 and the large grid squares. The output is in PostScript. Use
290 GhostScript to process it. A PDF version of the output is also
291 included.
292
293 - added a useful file with all the names and other details of the
294 Landranger Sheets
295
296 1.03 18 December 2002
297 - changed name for CPAN release
298 - improved ll2grid function
299 - new ll2map and map2ll functions
300
301
302 1.02 November 13, 2002
303 - No changes to code, just tidied the documentation
304
305 0.01 Fri Mar 2 19:05:50 2001
306 - original version; created by h2xs 1.19