| 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 |