Fixed data

Author: rijnb

src/main/resources/com/mapcode/README renamed to src/main/resources/com/mapcode/README.md

@@ -0,0 +1,67 @@
+# Creating Unit Test Reference Files
+
+## Creating the Mapcode Utility
+
+To create the test files, you will first need to build the 'mapcode' utility
+from the "Mapcode C++" library on Github: https://github.com/mapcode-foundation/mapcode-cpp
+
+You find the tool in the `utility` directory and compile it with:
+
+    cd utility
+    gcc mapcode.cpp -o -mapcode
+
+## Creating Mapcode Test Sets
+
+These test files have been created with the commands below.
+
+Note: The syntax of the 'mapcode' command is:
+
+    mapcode --random nrOfPoints [extraDigits] [seed]
+    mapcode --grid   nrOfPoints [extraDigits]
+    mapcode --boundaries        [extraDigits]
+
+The parameters extraDigits is 8 means the highest precision codes are generated.
+The unit tests will use cut-off version of these codes to check lower precisions
+as well.
+
+    mapcode --random 1000    8 1234 > random_e8_1k.txt
+    mapcode --random 10000   8 1234 > random_e8_10k.txt
+    mapcode --random 100000  8 1234 > random_e8_100k.txt
+    mapcode --grid   1000    8      > grid_e8_1k.txt
+    mapcode --grid   10000   8      > grid_e8_10k.txt
+    mapcode --grid   100000  8      > grid_e8_100k.txt
+    mapcode --boundaries     8      > boundaries_e8.txt
+    
+    for f in *.txt; do split -l 200000 -a 1 $f $f.; rm $f; done
+
+**IMPORTANT:** Please note that an explicit seed `1234` is used for the generation of
+random data sets, so they can be compared across different version of the software.
+
+After generating the files, they must be split into smaller pieces (in this case
+5Mb chunks) to allow uploading to Github or other source code control systems,
+hence the `split` command.
+
+## Reference File Format
+
+The reference files are the following format:
+
+    <number-of-mapcode-aliases> <lat-deg> <lon-deg> <x> <y> <z>
+    <territory-code> <mapcode>      (repeated for every alias)
+                                    (empty line)
+    ...                             (repeated for every record)
+
+Example:
+
+    1 0.043244999999998867679 0.057660000000000266596
+    HHHH1.CXRC-MMLH2S9M
+    
+    6 41.851944000000003143 12.433113999999999777
+    ITA 0Z.0Z-00000000
+    ITA G5.20M-X0230000
+    ITA 2MC.29K-JVDRH4CV
+    ITA 65C.X5QK-CPNRRNPN
+    ITA J0QN.7X4-B1R2S4P3
+    TJKM1.D2Z6-L1N8FHY0
+
+You can use the tool Processing (http://processing.org) with the application
+in `show3d` to visualize the generated data.

src/main/resources/com/mapcode/mminfo.dat

@@ -121154,20 +121154,20 @@ MNG NW6D.X4G0-JFL32041
 CN-NM MLT.210W-D49RXMHX
 TSW4C.V7HF-DPJG0Y7M
 
-3 5.119999999999997442 7.994999999999997442
-NGA TS.RZJ7-4BR0L6X0
-NGA FXQ8.3GH-05300000
-JJ5Z9.096Y-VGW5NBCG
-
-8 32.560000000000002274 92.75
-CN-XZ PBQD.ZCF-C8781XD1
-CN-XZ KF73.TQ58-R0231325
-CN-GS 5FPN.F38-0FV7NHDD
-CN-GS KF73.TQ58-R0231325
-CN-QH 5FPN.F38-0FV7NHDD
-CN-QH KF73.TQ58-R0231325
-CHN KF73.TQ58-R0231325
-RRGYY.7MJ2-PW5RKH1W
+3 5.119999999999997442 8.2249999999999943157
+NGA XD.JZD7-2CS3M9Y3
+NGA GX98.5MZ-14000000
+JJ5ZG.S94Y-YHT4P8DK
+
+8 32.560000000000002274 92.290000000000006253
+CN-XZ NNFD.ZNG-B6872XG4
+CN-XZ KD8R.HQK8-Q3443333
+CN-GS 4TC8.K8R-1DW8SFCJ
+CN-GS KD8R.HQK8-Q3443333
+CN-QH 4TC8.K8R-1DW8SFCJ
+CN-QH KD8R.HQK8-Q3443333
+CHN KD8R.HQK8-Q3443333
+RRG6S.BM32-PW5RKH1W
 
 8 32.560000000000002274 108.73999999999999488
 CN-HB 53KR.3K-T9P00322
@@ -121179,27 +121179,27 @@ CN-SN M7Q8.3LWY-XX7W0D0D
 CHN M7Q8.3LWY-XX7W0D0D
 RSW1P.XM12-NT9MHH0T
 
-4 42.799999999999997158 92.75
-CN-XJ GDNF.7MJ-60LN0000
-CN-XJ 3MH3.33Z7-TD0S5LHD
-CHN 3MH3.33Z7-TD0S5LHD
-TRHGN.S7CF-CGT5Q7FF
+4 42.799999999999997158 92.290000000000006253
+CN-XJ G5WH.8X9-74JQ4312
+CN-XJ 3KKZ.63L7-TJ2T6QHD
+CHN 3KKZ.63L7-TJ2T6QHD
+TRFSW.Z7BF-DGX3S6DJ
 
 4 42.799999999999997158 108.73999999999999488
 MNG DWTZ.WSL-XHC3X8B8
 MNG NW6D.X4G0-J0413320
 CN-NM MLT.210W-7XX0L5S1
 TSW4C.V7HF-DGX3S6DJ
 
-8 32.560000999999999749 92.750000999999997475
-CN-XZ PBQD.ZCF-C8M6TWMW
-CN-XZ KF73.TQ58-R1NBDGT1
-CN-GS 5FPN.F38-0M7JJKRB
-CN-GS KF73.TQ58-R1NBDGT1
-CN-QH 5FPN.F38-0M7JJKRB
-CN-QH KF73.TQ58-R1NBDGT1
-CHN KF73.TQ58-R1NBDGT1
-RRGYY.7MJ2-V3354213
+8 32.560000999999999749 92.290001000000003728
+CN-XZ NNFD.ZNG-B6MCVXKT
+CN-XZ KD8R.HQK8-Q4QCGGT5
+CN-GS 4TC8.K8R-1L9DHHR9
+CN-GS KD8R.HQK8-Q4QCGGT5
+CN-QH 4TC8.K8R-1L9DHHR9
+CN-QH KD8R.HQK8-Q4QCGGT5
+CHN KD8R.HQK8-Q4QCGGT5
+RRG6S.BM32-V3354213
 
 10 32.560000999999999749 108.73999899999999741
 CN-HB 53KR.3K-TG431514
@@ -121213,13 +121213,13 @@ CN-GS M7Q8.3LWX-33421123
 CHN M7Q8.3LWX-33421123
 RSW1P.XM12-T1103401
 
-6 42.799998999999999683 92.750000999999997475
-CN-GS 599L.12F-BTDQPK3B
-CN-GS 3MH3.33Z7-T6DJX2N6
-CN-XJ GDNF.7MJ-609C0233
-CN-XJ 3MH3.33Z7-T6DJX2N6
-CHN 3MH3.33Z7-T6DJX2N6
-TRHGN.S7CF-CG3W9LKJ
+6 42.799998999999999683 92.290001000000003728
+CN-GS 4NZ6.57X-CSGLNH39
+CN-GS 3KKZ.63L7-TCBDT0N6
+CN-XJ G5WH.8X9-74880000
+CN-XJ 3KKZ.63L7-TCBDT0N6
+CHN 3KKZ.63L7-TCBDT0N6
+TRFSW.Z7BF-DH1V5RKF
 
 8 42.799998999999999683 108.73999899999999741
 MNG DWTZ.WSL-XH02VSS4
@@ -121231,13 +121231,13 @@ CN-GS 4X0N.Q007-9HWBW39H
 CHN 4X0N.Q007-9HWBW39H
 TSW4C.V7HF-DG0Y7MLF
 
-6 32.559999000000004798 92.749999000000002525
-CN-XZ PBQD.ZCF-C2T47X4B
-CN-XZ KF73.TQ58-KY9NHK0W
-CN-QH 5FPN.F38-0DM3YF0M
-CN-QH KF73.TQ58-KY9NHK0W
-CHN KF73.TQ58-KY9NHK0W
-RRGYY.7MJ2-PNKK0X6N
+6 32.559999000000004798 92.289999000000008778
+CN-XZ NNFD.ZNG-B0V38Y28
+CN-XZ KD8R.HQK8-KW6PKK1T
+CN-QH 4TC8.K8R-1DH5WK0L
+CN-QH KD8R.HQK8-KW6PKK1T
+CHN KD8R.HQK8-KW6PKK1T
+RRG6S.BM32-PNKK0X6N
 
 8 32.559999000000004798 108.74000099999999236
 CN-HB 53KR.3K-T9D24130
@@ -121249,11 +121249,11 @@ CN-SN M7Q8.3LWY-XRHP3X73
 CHN M7Q8.3LWY-XRHP3X73
 RSW1P.XM12-NNKF2V5N
 
-4 42.800000999999994633 92.749999000000002525
-CN-XJ GDNF.7MJ-66144312
-CN-XJ 3MH3.33Y7-YKW1PBBD
-CHN 3MH3.33Y7-YKW1PBBD
-TRHGN.S7CF-CMLF0V8P
+4 42.800000999999994633 92.289999000000008778
+CN-XJ G5WH.8X9-7B014024
+CN-XJ 3KKZ.63L7-THY2R8BD
+CHN 3KKZ.63L7-THY2R8BD
+TRFSW.Z7BF-DNHK2T8M
 
 4 42.800000999999994633 108.74000099999999236
 MNG DWTZ.WSL-XHQ5NP1D