1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
|
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang xml:lang>
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<meta name="author" content />
<title>Jpylyzer User Manual</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
</style>
<link rel="stylesheet" href="data:text/css,%0A%0A%0A%20body%20%7B%0Amargin%3A%20auto%3B%0Apadding%2Dright%3A%201em%3B%0Apadding%2Dleft%3A%201em%3B%0Amax%2Dwidth%3A%2050em%3B%20border%2Dleft%3A%201px%20solid%20black%3B%0Aborder%2Dright%3A%201px%20solid%20black%3B%0Acolor%3A%20black%3B%0Afont%2Dfamily%3A%20Verdana%2C%20sans%2Dserif%3B%0Afont%2Dsize%3A%20100%25%3B%0Aline%2Dheight%3A%20140%25%3B%0Acolor%3A%20%23333%3B%20%7D%0Apre%20%7B%0Aborder%3A%201px%20dotted%20gray%3B%0Abackground%2Dcolor%3A%20%23ececec%3B%0Acolor%3A%20%231111111%3B%0Apadding%3A%200%2E5em%3B%0A%7D%0Acode%20%7B%0Afont%2Dfamily%3A%20monospace%3B%0A%7D%0Ah1%20a%2C%20h2%20a%2C%20h3%20a%2C%20h4%20a%2C%20h5%20a%20%7B%20text%2Ddecoration%3A%20none%3B%0Acolor%3A%20%237a5ada%3B%20%7D%0Ah1%2C%20h2%2C%20h3%2C%20h4%2C%20h5%20%7B%20font%2Dfamily%3A%20verdana%3B%0Afont%2Dweight%3A%20bold%3B%0Acolor%3A%20%237a5ada%3B%20%7D%0Ah2%2C%20h3%2C%20h4%2C%20h5%20%7B%0Aborder%2Dbottom%3A%201px%20dotted%20black%3B%7D%0Ah1%20%7B%0Afont%2Dsize%3A%20160%25%3B%0Apadding%2Dtop%3A%203em%3B%0Apadding%2Dbottom%3A%201em%3B%0A%7D%0Ah2%20%7B%0Afont%2Dsize%3A%20110%25%3B%0Apadding%2Dtop%3A%200%2E5em%3B%0A%7D%0Ah3%20%7B%0Afont%2Dsize%3A%2095%25%3B%0A%7D%0Ah4%20%7B%0Afont%2Dsize%3A%2090%25%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Ah5%20%7B%0Afont%2Dsize%3A%2090%25%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Ah1%2Etitle%20%7B%0Afont%2Dsize%3A%20200%25%3B%0Afont%2Dweight%3A%20bold%3B%0Apadding%2Dtop%3A%200%2E2em%3B%0Apadding%2Dbottom%3A%200%2E2em%3B%0Atext%2Dalign%3A%20left%3B%0Aborder%3A%20none%3B%0A%7D%0Adt%20code%20%7B%0Afont%2Dweight%3A%20bold%3B%0A%7D%0Add%20p%20%7B%0Amargin%2Dtop%3A%200%3B%0A%7D%0Atable%7B%0Aborder%2Dcollapse%3A%20collapse%3B%0A%7D%0Atable%20th%20%7B%0Afont%2Dweight%3A%20bold%3B%0A%7D%0Atable%20th%2C%20td%20%7B%0Aborder%3A%201px%20solid%20%23ccc%3B%0Apadding%3A%206px%2013px%3B%0A%7D%0Atable%20tr%20%7B%0Aborder%2Dtop%3A%201px%20solid%20%23ccc%3B%0A%0A%7D%0A%23footer%20%7B%0Apadding%2Dtop%3A%201em%3B%0Afont%2Dsize%3A%2070%25%3B%0Acolor%3A%20gray%3B%0Atext%2Dalign%3A%20center%3B%0A%7D%0A%0Amath%5Bmode%3D%22display%22%5D%20%7B%0Adisplay%3A%20block%3B%0Atext%2Dalign%3A%20center%3B%0Afont%2Dfamily%3A%20CMSY10%2C%20CMEX10%2C%20Symbol%2C%20Times%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0A%40media%20screen%20%7B%20%0A%0Amath%20%2A%2E%5Bmathvariant%3D%22normal%22%5D%20%7B%0Afont%2Dfamily%3A%20%22Times%20New%20Roman%22%2C%20Courier%2C%20Garamond%2C%20serif%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22bold%22%5D%20%7B%0Afont%2Dfamily%3A%20%22Times%20New%20Roman%22%2C%20Courier%2C%20Garamond%2C%20serif%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22italic%22%5D%20%7B%0Afont%2Dfamily%3A%20%22Times%20New%20Roman%22%2C%20Courier%2C%20Garamond%2C%20serif%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22bold%2Ditalic%22%5D%20%7B%0Afont%2Dfamily%3A%20%22Times%20New%20Roman%22%2C%20Courier%2C%20Garamond%2C%20serif%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22double%2Dstruck%22%5D%20%7B%0Afont%2Dfamily%3A%20msbm%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22script%22%5D%20%7B%0Afont%2Dfamily%3A%20eusb%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22bold%2Dscript%22%5D%20%7B%0Afont%2Dfamily%3A%20eusb%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22fraktur%22%5D%20%7B%0Afont%2Dfamily%3A%20eufm%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22bold%2Dfraktur%22%5D%20%7B%0Afont%2Dfamily%3A%20eufm%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22sans%2Dserif%22%5D%20%7B%0Afont%2Dfamily%3A%20Arial%2C%20%22Lucida%20Sans%20Unicode%22%2C%20Verdana%2C%20sans%2Dserif%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22bold%2Dsans%2Dserif%22%5D%20%7B%0Afont%2Dfamily%3A%20Arial%2C%20%22Lucida%20Sans%20Unicode%22%2C%20Verdana%2C%20sans%2Dserif%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22sans%2Dserif%2Ditalic%22%5D%20%7B%0Afont%2Dfamily%3A%20Arial%2C%20%22Lucida%20Sans%20Unicode%22%2C%20Verdana%2C%20sans%2Dserif%3B%0Afont%2Dweight%3A%20normal%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22sans%2Dserif%2Dbold%2Ditalic%22%5D%20%7B%0Afont%2Dfamily%3A%20Arial%2C%20%22Lucida%20Sans%20Unicode%22%2C%20Verdana%2C%20sans%2Dserif%3B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Amath%20%2A%2E%5Bmathvariant%3D%22monospace%22%5D%20%7B%0Afont%2Dfamily%3A%20monospace%0A%7D%0A%0Amath%20%2A%2E%5Bmathsize%3D%22small%22%5D%20%7B%0Afont%2Dsize%3A%2080%25%0A%7D%0Amath%20%2A%2E%5Bmathsize%3D%22normal%22%5D%20%7B%0A%0A%7D%0Amath%20%2A%2E%5Bmathsize%3D%22big%22%5D%20%7B%0Afont%2Dsize%3A%20125%25%0A%7D%0A%0Amsub%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amsup%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amsubsup%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amunder%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amover%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amunderover%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Ammultiscripts%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%2C%0Amroot%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22big%22%5D%20%7B%0Afont%2Dsize%3A%20125%25%0A%7D%0Amsub%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amsup%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amsubsup%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amunder%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amover%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amunderover%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Ammultiscripts%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%2C%0Amroot%3E%2A%3Afirst%2Dchild%5Bmathsize%3D%22small%22%5D%20%7B%0Afont%2Dsize%3A%2080%25%0A%7D%0Amsub%3E%2A%3Afirst%2Dchild%2C%0Amsup%3E%2A%3Afirst%2Dchild%2C%0Amsubsup%3E%2A%3Afirst%2Dchild%2C%0Amunder%3E%2A%3Afirst%2Dchild%2C%0Amover%3E%2A%3Afirst%2Dchild%2C%0Amunderover%3E%2A%3Afirst%2Dchild%2C%0Ammultiscripts%3E%2A%3Afirst%2Dchild%2C%0Amroot%3E%2A%3Afirst%2Dchild%20%7B%0Afont%2Dsize%3A%20100%25%0A%7D%0A%0Amsub%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amsup%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amsubsup%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amunder%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amover%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amunderover%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Ammultiscripts%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amath%5Bdisplay%3D%22inline%22%5D%20mfrac%3E%2A%5Bmathsize%3D%22big%22%5D%2C%0Amath%20%2A%5Bscriptlevel%3D%22%2B1%22%5D%5Bmathsize%3D%22big%22%5D%20%7B%0Afont%2Dsize%3A%2089%25%20%0A%7D%0Amsub%3E%2A%20%5Bmathsize%3D%22small%22%5D%2C%0Amsup%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amsubsup%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amunder%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amover%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amunderover%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Ammultiscripts%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amath%5Bdisplay%3D%22inline%22%5D%20mfrac%3E%2A%5Bmathsize%3D%22small%22%5D%2C%0Amath%20%2A%5Bscriptlevel%3D%22%2B1%22%5D%5Bmathsize%3D%22small%22%5D%20%7B%0Afont%2Dsize%3A%2057%25%20%0A%7D%0Amsub%3E%2A%2C%0Amsup%3E%2A%2C%0Amsubsup%3E%2A%2C%0Amunder%3E%2A%2C%0Amover%3E%2A%2C%0Amunderover%3E%2A%2C%0Ammultiscripts%3E%2A%2C%0Amath%5Bdisplay%3D%22inline%22%5D%20mfrac%3E%2A%2C%0Amath%20%2A%5Bscriptlevel%3D%22%2B1%22%5D%20%7B%0Afont%2Dsize%3A%2071%25%0A%7D%0Amroot%3E%2A%5Bmathsize%3D%22big%22%5D%20%7B%0Afont%2Dsize%3A%2062%25%20%0A%7D%0Amroot%3E%2A%5Bmathsize%3D%22small%22%5D%20%7B%0Afont%2Dsize%3A%2040%25%20%0A%7D%0Amroot%3E%2A%20%7B%0Afont%2Dsize%3A%2050%25%0A%7D%0A%0Amath%20%2A%5Bscriptlevel%3D%22%2B2%22%5D%5Bmathsize%3D%22big%22%5D%20%7B%0Afont%2Dsize%3A%2063%25%20%0A%7D%0Amath%20%2A%5Bscriptlevel%3D%22%2B2%22%5D%5Bmathsize%3D%22small%22%5D%20%7B%0Afont%2Dsize%3A%2036%25%20%0A%7D%0Amath%20%2A%5Bscriptlevel%3D%22%2B2%22%5D%20%7B%0Afont%2Dsize%3A%2050%25%20%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22green%22%5D%20%7B%0Acolor%3A%20green%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22black%22%5D%20%7B%0Acolor%3A%20black%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22red%22%5D%20%7B%0Acolor%3A%20red%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22blue%22%5D%20%7B%0Acolor%3A%20blue%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22olive%22%5D%20%7B%0Acolor%3A%20olive%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22purple%22%5D%20%7B%0Acolor%3A%20purple%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22teal%22%5D%20%7B%0Acolor%3A%20teal%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22aqua%22%5D%20%7B%0Acolor%3A%20aqua%0A%7D%0Amath%20%2A%2E%5Bmathcolor%3D%22gray%22%5D%20%7B%0Acolor%3A%20gray%0A%7D%0Amath%20%2A%2E%5Bmathbackground%3D%22blue%22%5D%20%7B%0Abackground%2Dcolor%3A%20blue%0A%7D%0Amath%20%2A%2E%5Bmathbackground%3D%22green%22%5D%20%7B%0Abackground%2Dcolor%3A%20green%0A%7D%0Amath%20%2A%2E%5Bmathbackground%3D%22white%22%5D%20%7B%0Abackground%2Dcolor%3A%20white%0A%7D%0Amath%20%2A%2E%5Bmathbackground%3D%22yellow%22%5D%20%7B%0Abackground%2Dcolor%3A%20yellow%0A%7D%0Amath%20%2A%2E%5Bmathbackground%3D%22aqua%22%5D%20%7B%0Abackground%2Dcolor%3A%20aqua%0A%7D%0A%7D%20%0A%40media%20aural%20%7B%20%7D%0A" />
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<header id="title-block-header">
<h1 class="title">Jpylyzer User Manual</h1>
<p class="author"></p>
</header>
<nav id="TOC" role="doc-toc">
<ul>
<li><a href="#introduction">Introduction</a>
<ul>
<li><a href="#about-jpylyzer">About jpylyzer</a></li>
<li><a href="#validation-scope-and-restrictions">Validation: scope and restrictions</a></li>
<li><a href="#outline">Outline of this User Manual</a></li>
<li><a href="#funding">Funding</a></li>
<li><a href="#license">License</a></li>
</ul></li>
<li><a href="#installation">Installation and set-up</a>
<ul>
<li><a href="#obtaining-the-software">Obtaining the software</a></li>
<li><a href="#installation-pip">Installation with Pip (Linux/Unix, Windows, Mac OS X)</a></li>
<li><a href="#installation-windows">Installation of Windows binaries (Windows only)</a></li>
<li><a href="#installation-debian">Installation of Debian packages (Ubuntu/Linux)</a></li>
</ul></li>
<li><a href="#using-jpylyzer">Using <em>jpylyzer</em></a>
<ul>
<li><a href="#using-overview">Overview</a></li>
<li><a href="#command-line-usage">Command-line usage</a></li>
<li><a href="#using-as-python-module">Using <em>jpylyzer</em> as a Python module</a></li>
<li><a href="#java-integration">Java integration</a></li>
</ul></li>
<li><a href="#structure-jp2">Structure of a JP2 file</a>
<ul>
<li><a href="#structure-scope">Scope of this section</a></li>
<li><a href="#general-format-structure">General format structure</a></li>
<li><a href="#general-box-structure">General structure of a box</a></li>
<li><a href="#defined-boxes">Defined boxes in JP2</a></li>
</ul></li>
<li><a href="#output-format">Output format</a>
<ul>
<li><a href="#output-format-overview">Overview</a></li>
<li><a href="#toolinfo-element">toolInfo element</a></li>
<li><a href="#file-element">file element</a></li>
<li><a href="#fileinfo-element">fileInfo element</a></li>
<li><a href="#statusinfo-element">statusInfo element</a></li>
<li><a href="#isvalid-element">isValid element</a></li>
<li><a href="#tests-element">tests element</a></li>
<li><a href="#properties-element">properties element</a></li>
<li><a href="#propertiesExtension-element">propertiesExtension element</a></li>
</ul></li>
<li><a href="#jp2-box-by-box">JP2: box by box</a>
<ul>
<li><a href="#about-properties-tests-trees">About the properties and tests trees</a></li>
<li><a href="#jpeg2000-signature-box">JPEG 2000 Signature box</a></li>
<li><a href="#file-type-box">File Type box</a></li>
<li><a href="#jp2-header-box">JP2 Header box (superbox)</a></li>
<li><a href="#image-header-box">Image Header box (child of JP2 Header box)</a></li>
<li><a href="#bits-per-component-box">Bits Per Component box (child of JP2 Header box)</a></li>
<li><a href="#colour-specification-box">Colour Specification box (child of JP2 Header box)</a></li>
<li><a href="#palette-box">Palette box (child of JP2 Header box)</a></li>
<li><a href="#component-mapping-box">Component Mapping box (child of JP2 Header box)</a></li>
<li><a href="#channel-definition-box">Channel Definition box (child of JP2 Header box)</a></li>
<li><a href="#resolution-box">Resolution box (child of JP2 Header box, superbox)</a></li>
<li><a href="#capture-resolution-box">Capture Resolution box (child of Resolution box)</a></li>
<li><a href="#display-resolution-box">Default Display Resolution box (child of Resolution box)</a></li>
<li><a href="#codestream-box">Contiguous Codestream box</a></li>
<li><a href="#intellectual-property-box">Intellectual Property box</a></li>
<li><a href="#xml-box">XML box</a></li>
<li><a href="#uuid-box">UUID box</a></li>
<li><a href="#uuid-info-box">UUID Info box (superbox)</a></li>
<li><a href="#uuid-list-box">UUID List box (child of UUID Info box)</a></li>
<li><a href="#data-entry-url-box">Data Entry URL box (child of UUID Info box)</a></li>
<li><a href="#unknown-box-section">Unknown box</a></li>
<li><a href="#top-level-tests-properties">Top-level tests and properties</a></li>
</ul></li>
<li><a href="#contiguous-codestream-box-chapter">Contiguous Codestream box</a>
<ul>
<li><a href="#codestream-structure">General codestream structure</a></li>
<li><a href="#limitations-codestream-validation">Limitations of codestream validation</a></li>
<li><a href="#structure-reported-output">Structure of reported output</a></li>
<li><a href="#contiguous-codestream-box">Contiguous Codestream box</a></li>
<li><a href="#siz-marker">Image and tile size (SIZ) marker segment (child of Contiguous Codestream box)</a></li>
<li><a href="#cod-marker">Coding style default (COD) marker segment</a></li>
<li><a href="#coc-marker">Coding style component (COC) marker segment</a></li>
<li><a href="#rgn-marker">Region-of-interest (RGN) marker segment</a></li>
<li><a href="#qcd-marker">Quantization default (QCD) marker segment</a></li>
<li><a href="#qcc-marker">Quantization component (QCC) marker segment</a></li>
<li><a href="#poc-marker">Progression order change (POC) marker segment</a></li>
<li><a href="#crg-marker">Component registration (CRG) marker segment</a></li>
<li><a href="#com-marker">Comment (COM) marker segment</a></li>
<li><a href="#tile-part">Tile part (child of Contiguous Codestream box)</a></li>
<li><a href="#sot-marker">Start of tile part (SOT) marker segment (child of tile part)</a></li>
<li><a href="#tlm-marker">Tile-part lengths (TLM) marker segment</a></li>
<li><a href="#plm-marker">Packet length, main header (PLM) marker segment</a></li>
<li><a href="#ppm-marker">Packed packet headers, main header (PPM) marker segment</a></li>
<li><a href="#plt-marker">Packet length, tile-part header (PLT) marker segment</a></li>
<li><a href="#ppt-marker">Packed packet headers, tile-part header (PPT) marker segment</a></li>
</ul></li>
<li><a href="#references">References</a></li>
</ul>
</nav>
<h1 id="introduction">Introduction</h1>
<h2 id="about-jpylyzer">About jpylyzer</h2>
<p>This User Manual documents <em>jpylyzer</em>, a validator and feature extractor for JP2 images. JP2 is the still image format that is defined by JPEG 2000 Part 1 (ISO/IEC 15444-1). <em>Jpylyzer</em> was specifically created to answer the following questions that you might have about any JP2 file:</p>
<ol type="1">
<li><p>Is this really a JP2 and does it really conform to the format’s specifications (validation)?</p></li>
<li><p>What are the technical characteristics of this image (feature extraction)?</p></li>
</ol>
<h2 id="validation-scope-and-restrictions">Validation: scope and restrictions</h2>
<p>Since the word ‘validation’ means different things to different people, a few words about the overall scope of <em>jpylyzer</em>. First of all, it is important to stress that <em>jpylyzer</em> is not a ‘one stop solution’ that will tell you that an image is 100% perfect. What <em>jpylyzer</em> does is this: based on the JP2 format specification (ISO/IEC 15444-1), it parses a file. It then subjects the file’s contents to a large number of tests, each of which is based on the requirements and restrictions that are defined by the standard. If a file fails one or more tests, this implies that it does not conform to the standard, and is no valid JP2. Importantly, this presumes that <em>jpylyzer</em>’s tests accurately reflect the format specification, without producing false positives.</p>
<h3 id="valid-means-probably-valid">‘Valid’ means ‘probably valid’</h3>
<p>If a file passes all tests, this is an indication that it is <em>probably</em> valid JP2. This (intentionally) implies a certain degree of remaining uncertainty, which is related to the following.</p>
<p>First of all, <em>jpylyzer</em> (or any other format validator for that matter) ‘validates’ a file by trying to prove that it does <em>not</em> conform to the standard. It cannot prove that that a file <em>does</em> conform to the standard.</p>
<p>Related to this, even though <em>jpylyzer</em>’s validation process is very comprehensive, it is not complete. For instance, the validation of JPEG 2000 codestreams at this moment is still somewhat limited. These limitations are discussed in detail <a href="#limitations-codestream-validation">here</a>. Some of these limitations (e.g. optional codestream segment markers that are only minimally supported at this stage) may be taken away in upcoming versions of the tool.</p>
<h3 id="no-check-on-compressed-bitstreams">No check on compressed bitstreams</h3>
<p>One important limitation that most certainly will <em>not</em> be addressed in any upcoming versions is that <em>jpylyzer</em> does not analyse the data in the compressed bitstream segments. Doing so would involve decoding the whole image, and this is completely out of <em>jpylyzer</em>’s scope. As a result, it is possible that a JP2 that passes each of <em>jpylyzer</em>’s tests will nevertheless fail to render correctly in a viewer application.</p>
<h3 id="recommendations-for-use-in-quality-assurance-workflows">Recommendations for use in quality assurance workflows</h3>
<p>Because of the foregoing, a thorough JP2 quality assurance workflow should not rely on <em>jpylyzer</em> (or any other format validator) alone, but it should include other tests as well. Some obvious examples are:</p>
<ul>
<li><p>A rendering test that checks if a file renders at all</p></li>
<li><p>Format migration workflows (e.g. TIFF to JP2) should ideally also include some comparison between source and destination images (e.g. a pixel-wise comparison)</p></li>
</ul>
<p>Conversely, an image that successfully passes a rendering test or pixel-wise comparison may still contain problematic features (e.g. incorrect colour space information), so validation, rendering tests and pixel-wise comparisons are really complementary to each other.</p>
<h3 id="note-on-icc-profile-support">Note on ICC profile support</h3>
<p>The support of ICC profiles in JP2 was recently extended through an <a href="https://www.itu.int/rec/T-REC-T.800-201303-P!Amd6/en">amendment</a> to the standard. These changes are taken into account by <em>jpylyzer</em>, which is in line with the most recent version of the (updated) standard.</p>
<h2 id="outline">Outline of this User Manual</h2>
<p>We start by describing the <a href="#installation">installation process</a> of <em>jpylyzer</em> for Windows and Unix-based systems. We then explain its <a href="#using-jpylyzer">basic usage</a>, either as a command-line tool, or as an importable Python module. This is followed by a brief overview of <a href="#structure-jp2">the structure of the JP2 format</a> and its ‘box’ structure, and an explanation of <em>Jpylyzer</em>’s <a href="#output-format">output format</a>. The final sections give a detailed description of the tests that <em>jpylyzer</em> performs for validation, and the properties that are reported in the output. The <a href="#jp2-box-by-box">penultimate section</a> does this for all ‘boxes’, except the ‘Contiguous Codestream’ box, which is given a <a href="#contiguous-codestream-box-chapter">section of its own</a>.</p>
<h2 id="funding">Funding</h2>
<p>The development of <em>jpylyzer</em> was funded by the EU FP 7 project SCAPE (SCAlable Preservation Environments). More information about this project can be found here:</p>
<p><a href="https://www.scape-project.eu/">https://www.scape-project.eu/</a></p>
<h2 id="license">License</h2>
<p><em>Jpylyzer</em> is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see:</p>
<p><a href="https://www.gnu.org/licenses/">https://www.gnu.org/licenses/</a></p>
<p>On Debian systems, the complete text of the GNU Lesser General Public License version 3 can be found in:</p>
<pre><code>/usr/share/common-licenses/LGPL-3</code></pre>
<h1 id="installation">Installation and set-up</h1>
<h2 id="obtaining-the-software">Obtaining the software</h2>
<p>To obtain the latest version of the software please use the download links at the <em>jpylyzer</em> homepage:</p>
<p><a href="https://jpylyzer.openpreservation.org/" class="uri">https://jpylyzer.openpreservation.org/</a></p>
<p>You have three options:</p>
<ol type="1">
<li><p>Install the software with the <em>Pip</em> package manager. This works on all platforms (Windows, Linux, Mac, etc.), but you need to have the Python interpreter available on your system. Jpylyzer is compatible with Python 2.7, and Python 3.2 and more recent (Python 3.0 and 3.1 are not supported).</p></li>
<li><p>Alternatively, for Windows users there is also a set of stand-alone binaries<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a>. These allow you to run <em>jpylyzer</em> as an executable Windows application, without any need for installing Python. This option is particularly useful for Windows users who cannot (or don’t want to) install software on their system.</p></li>
<li><p>For Linux users Debian packages are available.</p></li>
</ol>
<p>These options are described in the following sub-sections.</p>
<h2 id="installation-pip">Installation with Pip (Linux/Unix, Windows, Mac OS X)</h2>
<h3 id="general-installation-procedure">General installation procedure</h3>
<p>First make sure you have a recent version of <em>pip</em>. Then install <em>jpylyzer</em> with the following command:</p>
<pre><code>pip install jpylyzer</code></pre>
<h3 id="single-user-installation-linux">Single user installation (Linux)</h3>
<p>On most Linux systems the above command needs to be run as super user (see below). If you don’t want this use the below command for a single-user install:</p>
<pre><code>pip install jpylyzer --user</code></pre>
<p>This will install the software to the <code>.local</code> folder (hidden by default!) in your home directory (<code>~/.local</code>). Next try to run <em>jpylyzer</em> by entering:</p>
<pre><code>jpylyzer</code></pre>
<p>Most likely this will result in:</p>
<pre><code>jpylyzer: command not found</code></pre>
<p>If this happens, add the directory <code>~/.local/bin</code> (which is where the jpylyzer command-line tool is installed) to the <code>PATH</code> environment variable (you only need to do this once). To do this, locate the (hidden) file <code>.profile</code> in you home directory (<code>~/</code>), and open it in a text editor. Then add the following lines at the end of the file:</p>
<pre><code># set PATH so it includes the user's .local bin if it exists
if [ -d "$HOME/.local/bin" ] ; then
PATH="$HOME/.local/bin:$PATH"
fi</code></pre>
<p>Save the file, log out of your session and then log in again. Open a command terminal and type:</p>
<pre><code>jpylyzer</code></pre>
<p>If all went well you now see this:</p>
<pre><code>usage: jpylyzer [-h] [--format FMT] [--legacyout] [--mix {1,2}] [--nopretty]
[--nullxml] [--recurse] [--packetmarkers] [--verbose]
[--version] [--wrapper]
jp2In [jp2In ...]
jpylyzer: error: the following arguments are required: jp2In</code></pre>
<p>Which means that the installation was successful!</p>
<h3 id="global-installation-linux">Global installation (Linux)</h3>
<p>Simply enter:</p>
<pre><code>sudo -H pip install jpylyzer</code></pre>
<p>No further configuration is needed in this case.</p>
<h3 id="note-on-pre-releases">Note on pre-releases</h3>
<p>The above command lines will only install stable versions of jpylyzer. In order to install the latest pre-release, add the <code>--pre</code> switch. For example:</p>
<pre><code>sudo -H pip install jpylyzer --pre</code></pre>
<h2 id="installation-windows">Installation of Windows binaries (Windows only)</h2>
<p>Download the binary using the link on the <em>jpylyzer</em> homepage. Unzip the contents of this file to an empty folder on your PC. <em>Jpylyzer</em> should now be ready for use.</p>
<h3 id="testing-the-installation">Testing the installation</h3>
<p>To test your installation, open a Command Prompt (‘DOS prompt’) and type:</p>
<pre><code>%jpylyzerPath%\jpylyzer</code></pre>
<p>In the above command, replace <em>%jpylyzerPath%</em> with the full path to the <em>jpylyzer</em> installation directory (i.e. the directory that contains ‘jpylyzer.exe’ and its associated files). For example, if you extracted the files to directory <code>c:\tools\jpylyzer</code>, the command would become:</p>
<pre><code>c:\tools\jpylyzer\jpylyzer</code></pre>
<p>Executing this command should result in the following screen output:</p>
<pre><code>usage: jpylyzer [-h] [--format FMT] [--legacyout] [--mix {1,2}] [--nopretty]
[--nullxml] [--recurse] [--packetmarkers] [--verbose]
[--version] [--wrapper]
jp2In [jp2In ...]
jpylyzer: error: the following arguments are required: jp2In</code></pre>
<h3 id="running-jpylyzer-without-typing-the-full-path">Running jpylyzer without typing the full path</h3>
<p>Optionally, you may also want to add the full path of the <em>jpylyzer</em> installation directory to the Windows ’Path’ environment variable. Doing so allows you to run <em>jpylyzer</em> from any directory on your PC without having to type the full path. In Windows 7 you can do this by selecting ‘settings’ from the ‘Start’ menu; then go to ‘control panel’/’system’ and go to the ‘advanced’ tab. Click on the ‘environment variables’ button. Finally, locate the ‘Path’ variable in the ‘system variables’ window, click on ‘Edit’ and add the full <em>jpylyzer</em> path (this requires local Administrator privileges). The settings take effect on any newly opened command prompt.</p>
<h2 id="installation-debian">Installation of Debian packages (Ubuntu/Linux)</h2>
<p>For Linux, Debian packages of <em>jpylyzer</em> exist. To install, simply download the <em>.deb</em> file, double-click on it and select <em>Install Package</em>. Alternatively you can also do this in the command terminal by typing:</p>
<pre><code>sudo dpkg -i opf-jpylyzer_2.0.0_all.deb</code></pre>
<p>In both cases you need to have administrative privileges.</p>
<p>For <em>Ubuntu</em> and <em>Debian</em> alternative packages are available in the official release channels. To install simply run the following commands:</p>
<pre><code>sudo apt-get update
sudo apt-get install python-jpylyzer</code></pre>
<h1 id="using-jpylyzer">Using <em>jpylyzer</em></h1>
<h2 id="using-overview">Overview</h2>
<p>This section describes the general use of <em>jpylyzer</em>. The first sub-sections cover the use of <em>jpylyzer</em> as a command-line tool and as an importable Python module.</p>
<h2 id="command-line-usage">Command-line usage</h2>
<p>This section explains <em>jpylyzer</em>’s general command-line interface. For the sake of brevity, full paths to <em>jpylyzer</em> are omitted. This means that, depending on your system and settings, you may have to substitute each occurrence of ‘jpylyzer’ with its full path, the corresponding Windows binary, or a combination of both. The following examples illustrate this:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">This User Manual</th>
<th style="text-align: left;">jpylyzer</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Substitution example Linux</td>
<td style="text-align: left;"><code>/home/jpylyzer/jpylyzer</code></td>
</tr>
<tr class="even">
<td style="text-align: left;">Substitution example Windows binaries</td>
<td style="text-align: left;"><code>c:\tools\jpylyzer\jpylyzer</code></td>
</tr>
</tbody>
</table>
<p>Furthermore, command line arguments that are given between square brackets (example: <code>[-h]</code>) are optional.</p>
<h3 id="synopsis">Synopsis</h3>
<p><em>Jpylyzer</em> can be invoked using the following command-line arguments:</p>
<pre><code>usage: jpylyzer [-h] [--format FMT] [--legacyout] [--mix {1,2}] [--nopretty]
[--nullxml] [--recurse] [--packetmarkers] [--verbose]
[--version] [--wrapper]
jp2In [jp2In ...]</code></pre>
<h4 id="positional-arguments">Positional arguments</h4>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Argument</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><code>jp2In</code></td>
<td style="text-align: left;">input JP2 image(s), may be one or more (whitespace-separated) path expressions; prefix wildcard (*) with backslash (\) in Linux</td>
</tr>
</tbody>
</table>
<h4 id="optional-arguments">Optional arguments</h4>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Argument</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><code>[-h, --help]</code></td>
<td style="text-align: left;">show help message and exit</td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>[--format FMT]</code></td>
<td style="text-align: left;">validation format; allowed values are <code>jp2</code> (used by default) and <code>j2c</code> (which activates raw codestream validation)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>[--mix {1,2}]</code></td>
<td style="text-align: left;">report additional output in NISO MIX format (version 1.0 or 2.0)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>[--legacyout]</code></td>
<td style="text-align: left;">report output in jpylyzer 1.x format (provided for backward compatibility only)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>[--nopretty]</code></td>
<td style="text-align: left;">suppress pretty-printing of XML output</td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>[--nullxml]</code></td>
<td style="text-align: left;">extract null-terminated XML content from XML and UUID boxes(doesn’t affect validation)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>[--recurse, -r]</code></td>
<td style="text-align: left;">when analysing a directory, recurse into subdirectories (implies <code>--wrapper</code> if <code>--legacyout</code> is used)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>[--packetmarkers]</code></td>
<td style="text-align: left;">Report packet-level codestream markers (plm, ppm, plt, ppt)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>[--verbose]</code></td>
<td style="text-align: left;">report test results in verbose format</td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>[-v, --version]</code></td>
<td style="text-align: left;">show program’s version number and exit</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>[--wrapper, -w]</code></td>
<td style="text-align: left;">wrap output for individual image(s) in ‘results’ XML element (deprecated from jpylyzer 2.x onward, only takes effect if <code>--legacyout</code> is used)</td>
</tr>
</tbody>
</table>
<p>Note that the input can either be a single image, a space-separated sequence of images, a pathname expression that includes multiple images, or any combination of the above. For example, the following command will process one single image:</p>
<pre><code>jpylyzer rubbish.jp2</code></pre>
<p>The next example shows how to process all files with a ‘jp2’ extension in the current directory:</p>
<pre><code>jpylyzer *.jp2</code></pre>
<p>Note that on Unix/Linux based systems pathname expressions may not work properly unless you wrap them in quotation marks:</p>
<pre><code>jpylyzer "*.jp2"</code></pre>
<h3 id="output-redirection">Output redirection</h3>
<p>All output (except warning and system error messages) is directed to the standard output device (stdout). By default this is the console screen. Use your platform’s standard output redirection operators to redirect output to a file. The most common situation will be to redirect the output of one invocation of <em>jpylyzer</em> to an XML file, which can be done with the ‘>’ operator (both under Windows and Linux):</p>
<pre><code>jpylyzer jp2In > outputFile</code></pre>
<p>E.g. the following command will run <em>jpylyzer</em> on image ‘rubbish.jp2’ and redirects the output to file ‘rubbish.xml’:</p>
<pre><code>jpylyzer rubbish.jp2 > rubbish.xml</code></pre>
<p>The format of the XML output is described <a href="#output-format">here</a>.</p>
<h3 id="format-option">‘format’ option</h3>
<p>By default, <em>jpylyzer</em> validates against the <em>JP2</em> format specification. Starting with version 2.0, <em>jpylyzer</em> can also validate raw JPEG 2000 codestreams that are not wrapped inside a <em>JP2</em> container. For codestream validation, use the <code>--format</code> option with value <code>j2c</code>, e.g.:</p>
<pre><code>jpylyzer --format j2c rubbish.j2c > rubbish.xml</code></pre>
<h3 id="mix-option">‘mix’ option</h3>
<p>When this option is used, <em>jpylyzer</em> reports additional output in <a href="https://www.loc.gov/standards/mix/"><em>NISO MIX</em></a> format. This option takes one argument that defines whether <em>MIX</em> 1.0 or <em>MIX</em> 2.0 is used. For example, the following command will result in <em>MIX</em> 2.0 output:</p>
<pre><code>jpylyzer --mix 2 rubbish.jp2 > rubbish.xml</code></pre>
<p>The <em>MIX</em> output is wrapped inside a <em>file/propertiesExtension</em> element. Note that <em>MIX</em> output is <em>only</em> written for files that are valid JP2 (files that are not valid result in an empty <em>propertiesExtension</em> element). Also, the <code>--mix</code> option is ignored if <code>--format</code> is set to <code>j2c</code>, or if <code>--legacyout</code> (see below) is used.</p>
<h3 id="legacyout-option">‘legacyout’ option</h3>
<p>The output format of <em>jpylyzer</em> has changed in version 2.0, which may break existing workflows that expect output in 1.x format. For backward compatibility the <code>--legacyout</code> option results in output that follows the old 1.x format. Note that codestream validation is disabled if you use this option.</p>
<h3 id="recurse-option">‘recurse’ option</h3>
<p>If the <code>--recurse</code> option is used, <em>jpylyzer</em> will recursively traverse all subdirectories of a filepath expression. E.g:</p>
<pre><code>jpylyzer /home/myJP2s/*.jp2 > rubbish.xml</code></pre>
<p>In this case <em>jpylyzer</em> analyses all files that have a <em>.jp2</em> extension in directory <em>/home/myJP2s</em> and all its subdirectories.</p>
<h3 id="packetmarkers-option">‘packetmarkers’ option</h3>
<p>When this option is enabled, jpylyzer will report the properties of the following packet-level codestream markers:</p>
<ul>
<li>PLM (packet length, main header) marker</li>
<li>PPM (packed packet headers, main header) marker</li>
<li>PLT (packet length, tile-part header) marker</li>
<li>PPT (packed packet headers, tile-part header) marker</li>
</ul>
<p>By default these are excluded from the output, in order to prevent excessive output size.</p>
<h3 id="wrapper-option-deprecated">‘wrapper’ option (deprecated)</h3>
<p>This deprecated option is included for backward-compatibility, and only takes effect if <code>--legacyout</code> (see above) is used.By default, the <em>jpylyzer</em> 1.x releases would create a separate XML tree for each analysed image, without any overarching hierarchy. For multiple-image pathname expressions this resulted in output that was <strong>not</strong> well-formed XML. The <code>--legacyout</code> option still results in this is behaviour. For example:</p>
<pre><code>jpylyzer --legacyout rubbish.jp2 garbage.jp2 > rubbish.xml</code></pre>
<p>In this case, the file ‘rubbish.xml’ contains a succession of two XML trees, which by itself is not well-formed XML. The <code>--wrapper</code> option is provided to create valid XML instead:</p>
<pre><code>jpylyzer --legacyout --wrapper rubbish.jp2 garbage.jp2 > rubbish.xml</code></pre>
<p>In the above case the XML trees of the individual images are wrapped inside a ‘results’ element. When the <code>--recurse</code> option is used, jpylyzer will automatically wrap the output in a ‘results’ element, so there’s no need to specify <code>--wrapper</code> in that case.</p>
<p>Starting with version 2.0, <em>jpylyzer</em> <em>always</em> generates well-formed XML (unless the <code>--legacyout</code> option is used), which makes the <code>--wrapper</code> option largely obsolete, apart from cases where the ‘old’ behaviour is needed for backward-compatibility reasons.</p>
<h3 id="nullxml-option">‘nullxml’ option</h3>
<p>The <em>nullxml</em> option was added to enable extraction of XML content that is terminated by a null-byte. By default <em>jpylyzer</em> doesn’t report the XML in that case, because it throws an exception in the XML parser. Apparently some old versions of the Kakadu demo applications would erroneously add a null-byte to embedded XML, so this option can be used to force extraction for images that are affected by this.</p>
<h3 id="user-warnings">User warnings</h3>
<p>Under the following conditions <em>jpylyzer</em> will print a user warning to the standard error device (typically the console screen):</p>
<h4 id="no-images-to-check">No images to check</h4>
<p>If there are no input images to check (typically because the value of jp2In refers to a non-existent file), the following warning message is shown:</p>
<pre><code>User warning: no images to check!</code></pre>
<h4 id="unsupported-box">Unsupported box</h4>
<p>In some cases you will see the following warning message:</p>
<pre><code>User warning: ignoring 'boxName' (validator function not yet implemented)</code></pre>
<p>The reason for this: a JP2 file is made up of units that are called ‘boxes’. This is explained in more detail <a href="#structure-jp2">here</a>. Each ‘box’ has its own dedicated validator function. At this stage validator functions are still missing for a small number of (optional) boxes. <em>Jpylyzer</em> will display the above warning message if it encounters a (yet) unsupported box. Any unsupported boxes are simply ignored, and the remainder of the file will be analyzed (and validated) normally.</p>
<h4 id="error-while-processing-a-file">Error while processing a file</h4>
<p>In rare cases you may come across one of the following messages:</p>
<pre><code>User warning: memory error (file size too large)</code></pre>
<p>Memory errors may occur for (very) large images. If you get this warning, try using a machine with more RAM. Also, a machine’s chip architecture and the operating system may put constraints on the amount of memory that can be allocated.</p>
<p>The following warning indicates an input error:</p>
<pre><code>User warning: I/O error (cannot open file)</code></pre>
<p>Finally, the following messages most likely indicate a jpylyzer bug:</p>
<pre><code>User warning:runtime error (please report to developers)</code></pre>
<p>and:</p>
<pre><code>User warning: unknown error (please report to developers)</code></pre>
<p>If you ever run into either of these two errors, please get in touch with the jpylyzer developers. The easiest way to do this is to create a new issue at:</p>
<p><a href="https://github.com/openpreserve/jpylyzer/issues" class="uri">https://github.com/openpreserve/jpylyzer/issues</a></p>
<h4 id="unknown-box">Unknown box</h4>
<p>Occasionally, you may see this warning message:</p>
<pre><code>User warning: ignoring unknown box</code></pre>
<p>This happens if <em>jpylyzer</em> encounters a box that is not defined by JPEG 2000 Part 1. It should be noted that, to a large extent, JPEG 2000 Part 1 permits the presence of boxes that are defined outside the standard. Again, <em>jpylyzer</em> will simply ignore these and process all other boxes normally.</p>
<h2 id="using-as-python-module">Using <em>jpylyzer</em> as a Python module</h2>
<p>Instead of using <em>jpylyzer</em> from the command-line, you can also import it as a module in your own Python programs. To do so, install jpylyzer with <em>pip</em>. Then import <em>jpylyzer</em> into your code by adding:</p>
<pre><code>from jpylyzer import jpylyzer</code></pre>
<p>Subsequently you can call any function that is defined in <em>jpylyzer.py</em>. In practice you will most likely only need the <em>checkOneFile</em> function. The following minimal script shows how this works:</p>
<pre><code>#! /usr/bin/env python
from jpylyzer import jpylyzer
# Define JP2
myFile = "/home/johan/jpylyzer-test-files/aware.jp2"
# Analyse with jpylyzer, result to Element object
myResult = jpylyzer.checkOneFile(myFile)
# Return image height value
imageHeight = myResult.findtext('./properties/jp2HeaderBox/imageHeaderBox/height')
print(imageHeight)</code></pre>
<p>Here, <em>myResult</em> is an <em>Element</em> object that can either be used directly, or converted to XML using the <em>ElementTree</em> module<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a>. The structure of the element object follows the XML output that described <a href="#output-format">here</a>.</p>
<p>For validation a raw JPEG 2000 codestreams, call the <em>checkOneFile</em> function with the additional <em>validationFormat</em> argument, and set it to <code>j2c</code>:</p>
<pre><code># Define Codestream
myFile = "/home/johan/jpylyzer-test-files/rubbish.j2c"
# Analyse with jpylyzer, result to Element object
myResult = jpylyzer.checkOneFile(myFile, 'j2c')</code></pre>
<h2 id="java-integration">Java integration</h2>
<p>It is possible to integrate <em>jpylyzer</em> into Java applications. A test class that shows how this works is included in the source repo <a href="https://github.com/openpreserve/jpylyzer/tree/master/jpylyzer/java_demo/CallJpylyzer.java">here</a>. This requires <a href="https://www.jython.org/">Jython</a>. Note that you may run into performance issues with (very) large images in this case, as Jython does not support <a href="https://docs.python.org/3/library/mmap.html">memory mapping</a>, so make sure you’ve got plenty of RAM available.</p>
<h1 id="structure-jp2">Structure of a JP2 file</h1>
<h2 id="structure-scope">Scope of this section</h2>
<p>This section gives a brief overview of the JP2 file format. A basic understanding of the general structure of JP2 is helpful for appreciating how <em>jpylyzer</em> performs its validation. It will also make it easier to understand <em>jpylyzer</em>‘s extracted properties, as these are reported as a hierarchical tree that corresponds to the internal structure of JP2.</p>
<p>For an exhaustive description of every detail of the format you are advised to consult Annex I (‘JP2 file format syntax’) and Annex A (‘Codestream syntax’) of ISO/IEC 15444-1.</p>
<h2 id="general-format-structure">General format structure</h2>
<p>At the highest level, a JP2 file is made up of a collection of <em>boxes</em>. A <em>box</em> can be thought of as the fundamental building block of the format. Some boxes (‘superboxes’) are containers for other boxes. The Figure below gives an overview of the top-level boxes in a JP2 file.</p>
<figure>
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAAKACAYAAABqjYrAAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAQPwAAED8BPG+2XgAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAACAASURBVHic7N15fEzX/z/w12RPRHaJIGJP7Uto7TuxFq09JUqraG1VSoXatdaiVR9UKVU7VaRUiX3fEiSIXSIRW3aynd8f+eV+58xMkpnIZvp6Ph7zeOTcc869596ZzPvec889owIgQERERG81k8JuABEREb05s8w/Hj16hOLFixdmW4iIiMgAcXFxKFOmDAC1gF68eHHY2dkVWqOIiIgo99jlTkREZAQY0ImIiIwAAzoREZERYEAnIiIyAgzoRERERoABnYiIyAgwoBMRERkBBnQiIiIjwIBORERkBBjQiYiIjAADOhERkRFgQCciIjICDOhERERGgAGdiIjICJjlXMR4JScn49GjR3jx4gUAwNbWFo6Ojnj48KFSxsPDA66urko6ODgYycnJAABTU1PUqVOnYBtNRESkg8EBXQiBefPmSctGjBiB4sWLK+nVq1fj2bNnWa7DxcUF3t7eWQbD5ORknD17FkePHkVYWBiePHmC58+fw87ODtWqVcP777+Pli1bGtp0xZEjRzBu3DhcunQJ6enpyvImTZqgZ8+eGDt2rLJs2bJl+OKLL5R0165dcf/+fQAZvyEfGxub63YQERHlFYMDenp6OiZOnCgt++ijj6SAvnDhQoSGhua4rurVq+Onn35CixYtlGVJSUlwcXFBYmKizjr79+/H4sWL4ePjg82bN8Pe3t6g9oeFhaFjx45ISkoyqB4REVFRVqhd7teuXUO7du2wb98+tG3bFkBGD0BWwVzd/v370a9fP+zbt8+gbf7+++9SMG/dujU+/vhjWFpawsXFBTdu3ICjo6OSb2VlZdD6iYiICkOBBPQhQ4agcuXKSE5Oxo0bN7B161blPnRKSgpGjBiBGzduQKVSKXXKlSuHsWPHokOHDnBzc8OtW7fw9ddf49ChQ0qZgIAABAcHo2bNmnq35cGDB1La398frVq1UtKtWrXCsGHDcrurREREhaJAAnrv3r3Rvn17Jd2rVy90795dSd+6dQshISGoVq0aTE1NsWrVKvj5+cHc3FwpU79+fezcuRPly5fH8+fP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DzZs2IBHjx7pvY6sCCHw4YcfYuvWrVp5hw4dQqdOnQxa39y5czF58mSppwMAHj9+jJ49e2otVz/mujx//hxffvklFi1aZFA7svMmn8fExER07twZwcHBOvOnTZsGX19f3Lt3T2f+9evX4ePjI/Wq5Yavry927typtfz48ePw8fHROs5r1qxB586dcf36dZ3ri4uLw9y5c9G5c2fl/97ExATr16+Hm5sbgIzPypAhQ5QemRUrVmDfvn3KOr744gt07979jfarIDCg01vj5s2byv3aTOpBT1NgYCCcnJx0vtT/Wa9du4bU1FQlrVKp0KpVK2ldr1690nlikNOXtr42bdqEO3fuKOnatWtLgfL+/ftSefV765kcHR2ldGadzEfbsquruSyzTkJCgtb9a82ymmnNtmZH80vy3LlzGDBgADw8PFCyZEn069cPGzZsyNVx3rRpE/bv36+kTU1NMXLkSPz6668YPHgwrl69atD6rl27hrJly2LixIkYPny4NE7gwYMH0raAjHEagwYNwvbt23H27FncvXsXwcHBWLx4MaysrJRys2bNUoJU8+bNMXToUK3u3/79+2Po0KHKS7OrPtObBPSIiAjcvHkTTk5O8PHxQefOnZXP1NGjRzFjxgylbJkyZbB161aEhYVh27ZtSmBMTU3FoEGDpFsVhgoNDUWPHj2wevVq+Pv7S49iBgUFYdmyZUr63r17GD58uHLbAAA++ugj/PHHH5g3b5702Tx48CAWLFigpEuWLIn169crtwkiIiIwYsQI3LhxA1999ZVSrl69epg/f36u96egscu9iGGX+/+Nmm7btq1o27ateO+997QeazI1NRVBQUFKfUNGue/atUup9+eff2p10WmaNWuWzvU4ODi88XE5deqUsLGxUdZZrFgxab+EEGLcuHHSdkePHq21nlGjRkllxo0bJ4QQYvv27dLyBg0aaNXdvHmzVKZhw4ZCCCEiIiK09jk5OVmq+/DhQylfpVKJ1NRUvfY9PT1dr5H7Dg4OYv369Vr1s+tyb9++vZQ3Z84cqe6YMWMM6nJ3cnKSunwnTJgg5U+fPl2qn93jg8OHD5fqnjp1SsrXd5S7Zpe75i0HQ7rc8f+7tZ8+farkZ76Pml3ggYGB0nrWr18v5S9atCjLfdek2eXerVs36TbEpk2btLr2M02cOFHK8/X1ldZ98OBBKd/d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6Oho5XjXrl0bvr6+Sn6FChWwcuVKrF69Wlm2YcMGjBw5Uu/9oreHCv9/dpmYmBjpTJYKT506dXDlyhUcOXIk11+qRPqKi4uDpaVltkE3v/n5+eG3334DAHh6euLOnTtZDuAyMzNT7v1XrVpVerY8MTERFhYWWf5yXVZevHih8xfh8sqrV69gYmJi0DEWQuDly5ews7NTxhmQcfL398fs2bMxfvx4zJs3z6C6sbGxygUBr9CJ/uMKc8KRxMREBAYGYuvWrcqyMWPG5Dqw2tjY5KpefndBG/ILdplUKhW7xskgDOhEVChKlCiBp0+fSsvKli2rTDZDRIbhY2tEVCSUKVMGe/bsyfVVNtF/Ha/QiahQTJkyBUlJSTAzM0P58uXRqVMnvbqmN23apAwW47gfov/DgE5EhWLUqFG5qtezZ888bgmRcWCXOxERkRFgQCciIjICDOhERERGgPfQi7DFixdj06ZNhd0MIiLKR2fPns2T9TCgF2G7du0q7CYQEdFbggG9CBo9erTyAw1ERPTf0LBhwzeqz7nciYiI3lLqc7lzUBwREZERYEAnIiIyAgzoRERERoABnYiIyAgwoBMRERkBBnQiIiIjwIBORERkBBjQiYiIjAADOhERkRFgQCciIjICDOhERERGgAGdiIjICDCgExERGQEGdCIiIiPA30MvgrZu3YqnT58WdjOIiKgA1a1b941+E50BvQiaPXs2rly5UtjNICKiAjR+/HgGdGPVtm1buLq6FnYziIgoHwUFBeHq1atvvB4G9CJsypQpaN68eWE3g4iI8pG/v3+eBHQOiiMiIjICDOhERERGgAGdiIjICDCgExERGQEGdCIiIiPAgE5ERGQEGNCJiIiMAAM6ERGREWBAJyIiMgKcKY7eSEJCApKTk5W0tbU1rKyslPSrV6+QlJSUZX17e3uYmOR8XpmamoqwsDA8efIET548gUqlQtmyZVGrVi1YWlrmqu2JiYl4/fq1kraysoK1tbVWudevXyMxMVFJm5ubw9bWNlfbLEiLFy/Gvn37lPTChQtRq1atQmyRttGjR+P69etKevfu3Trfg7fRlStX8NVXXwEAihcvji1btsDMjF+52bl06RImTJigpHv06IERI0YUYotydurUKUydOhUAUKJECWzYsEGv77T8IgCImJgYQUVD7dq1BQBx5MiRwm5KjgYNGiQyP0MAxPTp06X8+fPnS/maL5VKJapUqSJGjRol7t69q7X+bdu2iU6dOonixYvrrG9vby/Gjx8vEhISDG77yJEjpXWNHz9eZ7lffvlFKte2bVuDt1UYPv30U6ndgYGBhd0kLY0aNZLaGBsbW9hNyjNt27ZV9mvChAmF3Zy3wsGDB6XPw+jRowu7STlKTk4W5cqVU9q8du1ag9cxefLkbL+DshMTE6Nsm13uVKiEELh58yaWLl2KmjVrIiAgQMrfsWMH9u3bh7i4OJ31Y2JiMH/+fPj4+CAlJaUgmkyUo4CAABw8eBBARs/Pl19+Wcgtovxibm6u9MQAGfOyZ9crmZ8Y0KlAWVhYwNHREY6OjrCwsJDy4uPj0bdvX0RFRWnVK168OHr16oXp06djwoQJqFixopR//PhxrF69Ol/bTqSvBQsWKH936dIFbm5uhdgaym++vr7KrcZHjx5h8+bNhdIO3tChAtW9e3flw56eno4tW7ZgwIABSE1NBQDExsbi999/V65o7Ozs4O/vj7Fjx8LJyUlZz7Rp09C4cWNcvnxZWbZ3714MHz68APdGW3p6Oq5evYrbt2/j1atXcHZ2RoMGDeDo6JhtvYcPH+Lu3bt4+fIl4uPjYW5urowRyOme8uvXr3H8+HFER0fD3d0dTZo0MfhebUREBC5duoTY2FjY2NigWrVqqFy5ss6yqampUo+JpaUlbGxskJaWhpMnT+LRo0coX778G/2u8927d3H58mWkp6fD29sb5cqVy7HOgwcPcOXKFcTHx8PKygqVK1dG9erVoVKppHIpKSmIj49X0mZmZihevLhUJjk5GQkJCUrakHETN2/exOHDh5V03759syybmJiIkJAQPH78GPHx8bCzs4OrqyuqVasGGxubbNukOV4lLS0NsbGxStrCwgLFihVT0prjXezs7GBqaoqoqCicOXMGr169Qo0aNVCtWrUc9/Hp06e4cOECnj9/DisrK1SqVAk1atTQOtZARi/cy5cvlXTm8RZC4Pz58wgLC4Obmxtat26d5fZSUlJw4sQJREZGwtXVFU2bNtW6IND0+vVrXLp0CQ8fPkRqaipKlCiB+vXrw8HBQatsXFyc8h0EALa2tjA3N5fKxMTEID09XUlnHj8AcHBwQMeOHbFz504AwIoVKzBo0KBs25dfeA+9iDHme+i9e/fWWscHH3wglRk4cKCSl5aWluW2f/zxR6le48aNDWp7Xt5DT09PF0uWLBGlSpXSus9vamoqfH19RVRUlFa9bdu2CScnpyzHGBQvXlyMGTMmyzECe/bsESVLlpTqeHh4iAMHDuh1D/348eOiadOmOrddt25dnXXOnDkjlRs8eLA4efKkdB/xgw8+yOnwCyG076E/ePBA9OnTR6hUKmmcxYABA0RiYqLOdfzzzz/C29tb5z6ULVtW/O9//5PKx8fHi6pVqyplrKysRHBwsJKfnp4u2rRpI21/7969eu2PEEL4+/srdc3NzXW2OyUlRYwfP15YW1vrbLeZmZmoWbOm9L28bt06qczMmTOldYaGhkr5H374oZSv+b968uRJMWbMGGFmZiYtb9eunYiMjNS5b9euXROdOnWS3p/MV8WKFcW2bdu06kRFRUnlWrduLUJDQ5XvOQCiXr16Qgjd99B3794t3N3dpeXu7u4iICBAZxvj4+PF2LFjha2trVYbTUxMxIcffiju3Lkj1dE8tn379pXyjx49KkxNTZX8hg0biuTkZKnM2rVrpXXcuHFDZ/t0yat76AzoRdB/LaBrrkPznykrS5culep99NFHBrU9rwJ6Wlqa6N27d5ZBOfPl6ekpwsPDpborVqzIsR4A0blzZ612HTp0SJibm+ssb2FhIWrVqpVtQN+4caPWl7muwLJlyxapnmZAb968ubC3t5eW5Tag169fP8u2dOnSRaSnp0v1V65cKUxMTHI8fp999plULygoSAqmdevWFa9fvxZCCLF48WK9PhdZadKkiVLX29tbZ5lJkybp9b4/ffpUqaMZdGbNmiWt09CAnt2xrlWrlkhKSpLqHz58WBQrVizb9qpUKrFw4UKpnmZAr127tihbtqy0rG7dukII7YBeu3btLD+jFhYW4ujRo9K2Xr58KZ0oZPVycnISV65cker6+flJZf744w8hREbAVD9ZdXR01DmANyQkRKq/YsUKne+9LgzoRuy/FNDv378vXFxcpDKTJ0/OcbsJCQmiRo0aUr2///7boLZrBnR9X5oBXTMA1KpVS2zfvl2cPHlSTJo0Sbqa6dChg1R3xYoVonbt2mLu3Lli586d4tSpU+LkyZNi5cqVWl966l9eqampomLFilJ+1apVxaxZs8SECROEg4ODVrvVA/qdO3eEpaWlkmdraysWLVokTp8+LX777Tfpqr9YsWLSiYhmQFf/omvWrJmoVatWrgM6ANGpUycxb9484efnp3UlqH5ycf36da0v+549e4off/xRjBo1Sisv8ws6088//yzlf/PNN+Lq1avCyspKWabrSiw7SUlJwsLCQqk/bNgwneXKlCkjBdaAgABx/vx5sW/fPrF8+XLRvXt3YW1tnW1Anz17trROQwN65v599913YtSoUdLnAZBPGGJiYqT/UzMzMzF16lRx4sQJsWPHDlGlShUlz9TUVFy4cEGpqxnQM1/FixcXjRo1EvXr1xf169cXQmgHdADC2dlZTJw4UcycOVO88847Wp959ZM8zaDs7u4uZsyYIRYuXKjVi+Pl5SVSU1OVunFxcdL6nZycRHh4uNY6d+zYofM9TU9PF3Z2dko5X1/fnD4uCgZ0I2bMAb1ChQpi6NCh4tNPPxUdO3bUOuM3MTERly9fznabqamp4sMPP5TqDR482OC250VAT09Pl7rZixcvrtVd6evrK9VX797VvApSt3v3bqmev7+/kqf5xVe6dGnpf/js2bNawVA9oI8ZM0bKW7NmTbbbnjJlipKnK6D7+vpKXcvx8fH6vAVaAb1v377SF/Ts2bOl/Hbt2il5w4YNk/I++eQTad0rV66U8jODhrpevXpJgUj9JMnBwUHnlVh27t69m+3/Qyb1xzCnTZums0x8fLxISUlR0poBfc6cOVJ5QwP6u+++q/RKCJFx+0c939PTU8lbsmRJlp8HIYQIDg6W8gcMGKDk6Qrobdq0Ec+ePZP2VQjtz7WJiYl0Jf3y5UutW0yZJ7qPHz+WusXNzc1FWFiYUjcpKUl4eXlJdXft2iXtx+XLl6UTOvUTFQDiiy++0PleZVIv37Rp02zLqsurgM5BcVSg7ty5g5UrV2aZ/80336B27dpZ5ickJKBv377Ys2ePsqxLly5Yvnx5nrZTX6GhoYiIiFDSpUuXxp9//imVSUtLk9KBgYGoUaMGgIxHmiIjI7Ft2zaEhIQgIiICT5480ZrMBsgYPZvp5MmTUt5HH30EOzs7Jd2gQQO8++67OHPmjM52Hzp0SEq/ePFCel80HxNUH+SlydnZGT///LM0eE99MJYhvvjiC2lg1YgRI+Dv7w8hBADg9OnTSl5gYKBU9/PPP5fSfn5+GDNmjHIcL168iNjYWOk4rVq1ChcuXMCdO3eQlpaG27dvK3m//PKLXoPx1EVHR0tp9YGc6qpUqYILFy4AAKZPn46tW7eiYcOGqFWrFry9vVG3bt0cj+GbTl7y2WefSQPLPvjgA7i7u+Px48cAgPv37yM8PBylS5fW+rykpqZq/R9bWloqEzVl93kxNzfH6tWrpWOT1b62aNFCmgzJ3t4evr6+WLhwobLs1KlTaNasGY4dOyb9r7Vv3156GsbKygqDBg3CpEmTlGWBgYHo1q2bkq5duzYWLVqkTGZz8+ZNJa9u3brS0wu6qO/TkydPsi2bHxjQqUioWrUqJk+eDF9f3yzLPHnyBF26dMG5c+eUZb1798aGDRu0RqTmxqeffoqJEydqLd+6davO5QCkYA5kBPjPPvss2+2Eh4crf2/cuBGffvqpVvDWRb2M5qN95cuX1ypfoUKFLAO6ZrvHjRund5s1eXt7a40Szy3NxxEdHBzg5OSEZ8+eAcg40YiPj4etra3WPlSoUEFKW1hYwMPDAzdu3ACQ8QTC48ePpYBub2+P3377DU2bNpXq+vn54YMPPjC4/ZknHpl0jfoGgJEjRyqjoIUQuHbtGq5du6bk29raYsSIEZgzZ44ykjqvaR5rlUqF8uXLKwEdACIjI1G6dGmtYz137txs1/348WOkp6frPOkoX7683idKmu+prnZntle93frW1fW5Hj58OP766y9pTgwTExP88ccfOc5Kqf5+a34WCgIDOhWoRo0aYezYsUrazs4OXl5eOf6D37x5E506dZKuoEaNGoVFixbl2Reeg4ODzi+BEiVKZFlH8/GwzEe4spP5Tx8REYEhQ4bg1atXynIfHx/UrFkTJiYmiIqKwtq1a3WuQ/OLUv2Rm0zZTbSj3m6VSqXzUR512X2Rubu7Z1vXELrarLlvme+35vuuq67mMl2fFc0eFSCjB+P58+dZXmFnRfOz8vz5c53l/Pz84OrqiqVLl+LkyZPS42ZAxpwM8+bNg4uLC8aPH69zHZmfm0yavQM5MeR4aR43BweHLE9W1Nel63NjyOdFn8/1m3wedD3eGR4eLl00ABkngzt27JCu7nXJPPEEAFdX12zL5gcGdCpQHh4e6NWrl0F1Tp06hffffx9Pnz4FkBHM5s+fXyRm3/L09JTSDRs21OoKzsrBgwelL+XPPvsMP//8s5Leu3dvlgHdw8NDSoeEhGiVUZ8jXZOnpyciIyOlsiVLltSr3Zry8gry+vXr0r49evQIMTExStrFxUXp2vf09MSLFy+kus2aNVPSsbGx0m0KCwsLlC5dWtpeQECAzm7Uhw8f4uOPP8auXbtyDFzqSpYsCXNzcyVwqB9jTR07dkTHjh2Rnp6OW7duISQkBCdOnMDixYuVruMDBw4oAV2zF0rzJEAzCOXk+vXraNu2rZJOTk6WTphVKpXyXpQrV0663REQEJDreQYM+bzo+gxrLitbtiwA7f9Fff4nNC8k0tLS4Ovrq3zXqJs6dSpatGiBxo0b62yrEEJ6vzX/RwsCZ4qjIm337t1o06aNFMznzp2L7t27486dO9Lr/v37Bd6+cuXKoWrVqkr65MmTOHXqlM6y4eHh0hSRml/I6gFVCJHtWIOWLVtK6Q0bNuDOnTtKeuvWrdkG9A4dOkjbyure4KtXr7BmzRosLcLrAAAgAElEQVQcO3Ysy3Xlpe+++045yRFCYObMmVK++n6r70NmXfUrsHnz5kkTqTRv3ly6zx8REQE/Pz+la7RixYoYOXKkkr97924sW7bMoPZbW1vD29tbSWfeJ9d0+PBh5RaKiYkJvLy80L17d8yfP1/6PKmfkGhe/f/999/KRDO3b9/GokWLDGrrjz/+KF1RLl26VOpRqFGjBpydnQFoH+sFCxbo7FJOTU3Ftm3bsGvXLoPakpVz585h7969SvrWrVvYuHGjVKZFixYAgGbNmkm9Y0ePHsXRo0eV9OPHj7FmzRqpro+Pj5SeMWMGjhw5oqT9/f3h4uICIGPf+vfvL51Eqrt165b0P92kSRO99jEv8QqdirQ1a9ZI8yKnp6fj66+/xtdff61V1s3NLdsrovzy7bffKrOBpaSkoG3btvDz80PdunVhamqKe/fu4fjx4zh69CjS09OV4PnOO+9I61m4cCFMTEzg5uaGrVu3KnOB69KgQQM0bNhQuWqKiYmBt7c32rdvj7i4OBw4cCDbNo8cORI//fSTcqK0cOFCBAUFoVOnTnByckJ0dDTOnz+PgIAAxMTEFNhUloGBgahZsyYaNWqE69evSwFRpVLhiy++UNKjRo3CihUrlFnI9u3bh/r166NJkya4ceOGNJDLxMQEU6ZMUdKZV2KZ3dRmZmZYv349vL29cfLkSWW7EyZMQNOmTVGvXj2996Fly5bK+3L58mW8fv1aq+t53LhxCAsLQ8eOHeHl5YUyZcrA3NwcgYGBuHr1qlKuSpUqyt/169eHlZWVcsJz/fp1eHl5oXz58rh48aJe4zDU3bp1CzVr1kTr1q0RHh6u1bM0atQo5e9+/fph7ty5yniE7du3o2HDhujZsyfc3Nzw8uVLXLp0CQEBAYiKisL3339vUFuy06NHD7Rv3x7FihXD/v37pQGbzZs3VwbR2tvbY8yYMZgzZw6AjBNCHx8fdO3aFXZ2dti7d6/0/dCyZUvlZADIOMmaPXu2ku7YsSNmzJiB+vXro3v37gAyBgoOGTIEO3bs0Gqn5ngVzZPugsLH1oqYt+mxtb59+2b7KI0+E8tkp1u3bno/Tubm5mbQuvNyprhp06bpnD1L86VSqZQ6aWlpomHDhlmW7dOnT7bH7tq1a8LR0VFnXWdnZ9GiRQtpmebEMidOnBDOzs56HdvNmzcr9XTNFJdbmo+tac4aqP4aNWqUVv1//vlHevZX18vU1FQsWbJEqvftt99KZb799lslLzQ0VHqcsnLlygb9CtzVq1elde/evVurTN26dXM85lZWVuL06dNSvdGjR2dZvl+/flI6p8fWsjvWnTp10pql8caNG9IEK9m9vv/+e6WerpnisqL52FqbNm20Ji1S/4yHhIRI9VNSUrLdr8xXtWrVREREhNRG9dnoSpQoIR4/fqzkf/bZZ1L9H3/8Uavt6o9A1qlTJ8t91IW/tkZFgvrIXABKF12mzIFmmS9DB4q4ublJ9bN7ad5Dy4mzs7NUP6sBUMWLF5fK6RrU8+233yIwMBBdunTRGhSnUqlQqVIlDB8+XOqKNDExwZ49e9CnTx/p/mipUqWwYsUKTJkyJdtjV61aNRw7dgzNmzdX7vOqVCq0atUKx48fR+PGjaX6mnPCN27cGEFBQRgzZgxKlSqltU+Ojo7o0aMH/ve//6FNmzbKcktLS2m92Q0azEmpUqWkda1ZswbTp0+X5r53dnbGvHnz8MMPP2jVb9u2LS5duoTBgwdrvX9WVlbo3Lkzjh49Kl1tBgcHY+PGjco2O3bsCH9/fyXfy8sLS5YsUfLT0tIMuuKsXr26dC9/06ZNWmX8/PzQtm1b2Nvba+VZWVmha9euOH78ON577z0pb/78+RgzZow0h7uHhwd+/fVXzJo1SzqWOf0gzKRJk7Bq1SppXEGxYsXw5ZdfYvv27VoDL6tUqYLLly9j6tSpOgeP2trawsfHBz/88IP0tIqpqWmO/z+ZrK2tpbItWrTA8ePHdX7Gjx07ptXLZWZmhm3btmHt2rXw9vbW2ody5cph+vTpOHPmjNSOadOmSdtetWqVdAts0aJFaNKkiZK/fPly3Lt3T8mPjY2VHqUdNmxYlvuY3wTAK/Si5G24Qk9PTxfz5s3TOvO9ePFiYTet0KWkpIg7d+6IixcvikePHuk101hycrK4fv26uHv3brbz12clKipKXLlyRURHR+emyUIIIcLDw0VQUJC4ceNGrn5fPi8lJyeL0NBQERISIk2ukp20tDRx7949cfHiRXHr1i3x6tWrfG5l1nbt2qX8TxQrVkya8U3TixcvxI0bN0RQUJB48uSJXutPSEgQV69eFbdv39b786J5hX7u3DkhRMZxu337trh69WqW8+XrEhUVJa5evSquX79eIPHjyZMn4sqVK3ofIyEyJqIJCQkRQUFB0hV3XlOfwrlkyZJ6T6yUiRPLUKFp1aoVLly4oDX5SL169VCnTp1CalXRYWZmpvO58OyYm5tLg6EM5erq+saPyZQqVUrnlXphMDc3h5eXl0F1TExM4OnpaXBPTX7o1q0bmjdvjqNHjyIhIQFLlizBjBkzdJZ1cHDI8bFBTTY2NqhevXpeNBUmJiY6r7hzkhefOUOUKFHC4N4ge3t7nb0geSktLU0aVDpt2rRcT6z0phjQyWAPHz7UCuaOjo5Yu3atQY/4EBmzBQsWKD/ne/LkSaSkpOTJBEhUtJw8eRL29vbw9vaGm5sbhgwZUmhtYUCnN2JjY4OePXtixowZReLKiKioaNCgAc6fP1/YzaB81qxZsyLzPjOgk8HWrVuH1NRUlChRAlWqVNE52xIRFS29evWSBpGVKVOmEFtD+YHfxGSwwpgwgYjeTKdOndCpU6fCbgblIz62RkREZAQY0ImIiIwAAzoREZER4D30IuyPP/6QfuGIiIiMT1Y/6GQoBvQibMWKFYXdBCIiekswoBdBvXr1yvVvDRMR0dupUaNGb1RfhYw5YBETEwM7O7u8aBMREREVgNjYWGV6Ww6KIyIiMgIM6EREREaAAZ2IiMgIMKATEREZAQZ0IiIiI8CATkREZAQY0ImIiIwAAzoREZERYEAnIiIyAgzoRERERoABnYiIyAgwoBMRERkBBnQiIiIjwIBORERkBPh76EXQiRMnEBsbW9jNICKiAlShQgV4eXnluj5/D70IqlOnDq5cuVLYzSAiogI0fvx4zJs3z6A66r+Hziv0IqxGjRo8ySIiMnIPHjzAo0eP3ng9DOhF2E8//YTmzZsXdjOIiCgf+fv7Y/bs2W+8Hg6KIyIiMgIM6EREREaAAZ2IiMgIMKATEREZAQZ0IiIiI8CATkREZAQY0ImIiIwAAzoREZERYEAnIiIyApwpjnRKTU3F/fv38fz5c6hUKri4uKBcuXKF3axcW7ZsGa5evaqkv/vuOzg6OhZii/5bIiMjER0djaSkJFhbW6Ny5cqwsrIq0DaEhoZi8eLFSrpFixbo379/gbaB8tbhw4exadMmJe3r6/ufnl2TAZ0k//zzD5YtW4bAwEDExcVJec7OzujUqRNGjBiBhg0bFlILZX///bfSTpVKhZ49e+osFxAQgICAACXt7+/PgJ7PwsPDsXjxYuzatQu3b9+W8szMzNCoUSN89NFHGDhwYIEE9/DwcKxcuVJJm5qaFmpADw0NRXBwsJJ+99134enpWWjteRtdvXpVek/r1avHgE4UFxeHIUOGYOvWrVmWefbsGdavX48jR47g/v37Bdi6rI0dOxahoaEAMoJEVgGdCtbvv/+Ozz77DAkJCTrzU1NTcezYMfw/9s47rIrjffs3HaSDVAXFAqigKLaoEVRsUewFS6yxoYkVjbHEKBo16jeJxl5i70ZjYm9o7FgQCxYUsADSpHfm/YPf2ffM2d0DiBEkz+e6zgUzs/fM7Jw9++zMzjxz6dIlODo6olOnTh+5hmXP4cOHMXPmTCG8fft2MuhEqSCDTiA7OxtffPEF/vnnHy5eW1sb9erVg6mpKWJjY/HkyRMwxsqolqVj+PDh8PLyEsJmZmZlWJuKzcaNGzFq1ChRfLVq1eDo6Ij09HQ8fvxY1tgTBPF+kEEnMHfuXJEx9/f3x4IFC2BhYSHExcTEYMuWLdw7K1UKCgrw9OlTJCQkQFdXFw4ODrCxsSlxnTIyMhAWFobc3FzUq1cPRkZGJc5Dmb59+xbruOzsbDx58gQAULNmTVSqVKlU5ZYU1fZzdHSEtbX1v15uUlISoqOj8e7dO5iamqJy5crv9b09fvwY/v7+XFy9evWwceNG7jVNbm4ujh8/jh9//FFtfvHx8YiMjERWVhYsLS1Ru3ZtaGlpFet8wsLCYGxsDFdXV2hrl/xWFxkZiZiYGACFDyO2trZFajIzMxETE4Po6GgYGBjAwsICVapUea/yi8OzZ88QExMDJycnVKlSRZQeFxeHyMhI5OTkwNbWFjVq1Cgyz5ycHLx58wZJSUlIS0tDpUqVUKNGjfd6RRUbG4sXL17AxsYGTk5OXFp+fj7CwsKQkpICZ2dnWFpaljh/ORhjePz4MZKSklCtWjXY29sXS/f8+XO8ffsWGhoasLOzg6Oj4wer08eCAWDJycmMKB80aNCAAWBBQUH/ellxcXGsUqVKTHEdAGATJkxQq0lJSRHFxcbGsgkTJjBzc3MuLwCsbt26bP369aygoECk8/LyYubm5sInPT2dzZkzhxkbGwt6PT09NnPmTJafny/ofH19mbm5OdPS0uLKUs6rRo0awvF9+/bl0l69esXVIz8/nwUGBjJTU1MhLyMjIzZjxgz27t07Tuvl5cVpFeet+Fy7do1L37x5M5e+YcMGUTvExMQwf39/ZmZmJtl+GzZskGw/BwcHId86deqI0rt3786V/fbtWy5969atrHbt2qIyATBra2vWuXNnFhMTI8pXjsGDB3N5VKlSRVSmMgUFBSw1NVUUt2XLFla/fn1RnUxMTNiYMWPYmzdvJPN79+4dGzp0KNPW1hY0NjY2bP369ezMmTNcXuPGjRPpMzMzWWBgIHNwcBCV7e7uzvbu3StZbmhoKOvQoYPoegTADAwMWPPmzdnhw4cZY4zt2rWLmZubMwMDA+44Q0ND7rs6duwYY4yxgwcPcvHLli1j169fZ25uboJ22rRpXPtt3ryZS1d8HBwc2PLly1leXp7oHLZu3crc3Ny4tlP+1K9fn23fvl3y/F1dXYX6OTg4sMTERNa/f3+mqakp6Fu1asUiIiIYY4zt37+fa2MtLS02fPhwlpmZKZm/HL/++itXx7Vr17KjR4+yGjVqCHEaGhqsU6dOLDIyUjKPtLQ0Nnv2bGZnZyc6Z0dHR/bjjz+y7OxsTjNp0iTuO1m7di2XfuTIES7dz89P7XnMmjWLAWABAQElOn/GGEtOTlauMxn08sbHNOg7duwQ3VTevXtXojzCwsJYlSpVJG8Cyp8+ffqIbiQNGzbkjunWrZusfunSpYKuTZs2RZZnYWEhHN+5c2cuLSoqiqvHhAkTZPPx9fXlwg0bNuS0I0aM4NIvX77Mpa9Zs4ZLX7lyJZf+8OFDZm9vX+T59OvXj3uoYYxxDz729vai76Zdu3ZcHsrG+ffffy+yTADs8ePH6r5+gdzcXO6BCAD77bffiqVVkJ+fzwYNGlRknWxsbFhoaCinzcnJYS1atJDVqF4DqgY9MTGReXp6Flm26k33zZs3kg+yqp/58+czxhjbsmVLsdr9yJEjjDHGdu/ezcX7+fkxQ0NDLm7q1KmMMcby8vJYv379isy7c+fOLCcnhzuPb7/9tlj1WrBggeh7UzaGlSpVkv0enJ2d2caNG2XzHjNmTImuF1WD3rFjR+4hQvlTvXp10cPl27dvWb169Yo8588++4x78ExLS2Ourq5CuqGhIXv69CljrLBzY21tLaTZ2dmx2NhYtefxoQw6rUP/j3P9+nUu/Pnnn8PU1LTY+ry8PPTs2ROvX78W4mrVqoWJEydi2LBh3OzlAwcOYPHixWrz+/PPP2Fvbw9fX1/REOKKFSuEd/jOzs7w9PTk8tfQ0ICnp6fwadCgQbHO4ezZs1i1ahUX16pVK4wfPx4eHh44evRosfJRrkdxyc3NRc+ePfHmzRshrnbt2pg0aRKGDh0KPT09IX7fvn346aefPki5ALB69Wrh/ypVqmDVqlU4ePAg1q1bh++++w5NmzYtUZ5hYWFITk7m4rp27VqiOq1YsQI7d+4Uwrq6uhg8eDAmT54MV1dXIT42NhY9e/ZETk4Op71y5YoQ1tLSQo8ePTBmzBg4OjpyqxykGDlyJG7duiWEvb298fvvv2PTpk1wd3cX4n/66SccPHhQCO/atQtJSUkAAE1NTUydOhUHDhzA9u3bsXDhQvTu3Zt7dWNpaQlPT0/R9e3k5MRdv3LzPPbs2YP09HRoaWnB0dERhoaGwu9i4cKF2Ldvn3Csq6sr1qxZgx07dqBDhw5C/PHjx/HDDz+I8nZ0dMTkyZPx66+/4sCBA9ixYwcmTZrEXYeBgYHCqwgpMjIycOXKFbi5ucHX1xe6urpC2pMnT/DVV19BS0sLbdq0wWeffcZpt2zZgsTERNm8i+LkyZMwNzfHsGHDMGjQIBgaGgppERERmD59Onf8kCFD8ODBAyFsa2sLf39/jBkzhnvFcPXqVXzzzTdC2NDQEHv37hXuP+np6RgyZAjy8vLw1Vdf4e3btwAKr8GdO3d+lNdmChhAPfTyxMfsofv5+XFPomPHji2Rft++fZzexcWF6+GfPn2aSzc1NWVZWVlCumoPvWnTpsK1mJiYyGxsbLj08PBwrnzlp2RtbW3Zeqrroffs2ZNLGz16tDC8nZuby7p06cKlF9VDv3r1Kpeuroe+a9cuLq1OnTrcb/H48eNcuoWFBdezUu6hV61aVXTe6nrojo6Osr1OBVFRUSwtLU22XZU5d+4cV5aWlpbkawI5cnNzWeXKlSV7qYwxlpqaytzd3bn0bdu2SZ4PALZ582YhLT4+nlWvXp1LV+6h37t3j0tr3rw5y83NFdLj4uK40Qfla2DatGlCfLVq1STPOT09XTTk++OPP3Jlyg1nq/bQAbBBgwYJ10lOTg6LiopiGRkZ3PVgY2PD4uPjhXzy8vKEewtQ+EpJ+buNjo4WjQApWLhwodq6qg5X+/n5CXktWrRIVP8tW7YwxgpfD7Rt25ZLO3XqlGQdpFDtoSv3lBlj7OrVq1yPXU9PjyUmJjLGGLt16xanNTMzYy9fvhS0jx49Ynp6etz1rDqyp/rbbt26NReeO3dusc6DeujEB4GpzFovaS/v1KlTXHjs2LFcD9/HxweNGjUSwsnJybh586ZsfvPmzYOJiQkAwNzcHM2aNePS4+LiSlS/4nDp0iUu/N133wntoK2tLXqqL4qStKFq+/n7+wvnDwCdOnXiRhoSExMRHBxc6nIBcBOkfvnlF3Ts2BHz5s3DoUOHhGWJDg4OXC9HHQUFBaWqz507dxAfHy+E69ati27duglhIyMjjB8/ntMo2i8iIgJRUVFCvL29PYYOHSqELS0tMXr0aNmyVb+Hhg0b4sKFCzhz5gzOnDmDu3fvco6V7t69K1yLNWvWFOIjIyPRoEEDTJo0CZs2bcKdO3eQm5uLSpUqfbAJVtWqVcOmTZuE60RHRwcODg64cuUK5zuifv36uHPnjnAO58+f5+qalpbGjWjY2toiLS0NBw8exMKFCzFx4kQMHDgQ/fr1w19//cXV4cWLF2rrOGvWLGhqFpqXpk2bcmkODg4YMmQIgMJrpGXLlly68jVQUvr3749atWoJ4ebNm8Pb21sIZ2dnC6OSqt/54MGDUbVqVSHs6urKXX/5+fk4e/Yspxk7diw34fbixYvC/15eXpg7d+57n8v7QLPc/+NUrlyZC798+bJEetXjXVxcRMe4uLjg9u3bQjgyMhKtWrWSzE/Z+AMQGZO8vLwS1a8ocnNzuRuIgYGB6MarPNT7oSlu+4WEhAjhyMhI0VAlUHID+uWXX+LChQsACmc2nzp1irvJValSBd988w2mTZsm3JzVYWVlxYXz8vIQHR1d7BnGxW0LZRRGXPmVD1BoZFXrLJWfaj4K1qxZgzVr1sgezxhDVFQUrKys4Ovri5kzZ+Ldu3cAgNDQUM5hjIGBAXr37o2ffvqpWDPli6J9+/bcELjcOZw+fRqnT59Wm5eyP4k9e/bA399feH2gjrS0NNk0TU1Nrq2VH1CBwt+T8nejupIkNze3yPLlkPqturq64ty5c0L41atXAIp3vanmp9rGALBhwwbcuHGDa0sLCwvs3LmzWCsyPiTUQ/+P4+npyYUvXbpUovXBqj18qRu/6kWtqlFGeZkcgH/dg5iWlhZX57y8PFH9srOzS5Sn6vGKG70UH7L9pOqp7uY8YsQIHDx4EA0bNpR8GHj9+jVmzJiBZcuWyeahjKurq+gB7MSJE8XSAuIevlRbqMYpNMVpR3UPJequSTkUv5MqVarg2rVr6Nevn+T1mpmZiR07dqBr164fxI+Dci9SmdKcQ1hYGIYMGcJdL56enhg8eDBGjx6N9u3bFztPQ0ND6OjoCGHVJXuqy9/y8/NLXG85ivO9K9pJtb2kjK/c9aZMbGys6L1/SkoKIiIiilXnDwkZ9P84nTp14iatJCcnF7k2WHkikurEHlUXnwDw9OlTLix3Q5KipL3OkqKpqQkHBwchnJubi4cPH3LHqHtFAIhvBKoPRPfu3ZPVqrbfs2fPRMeoaz/lslXLzcjIkMxPmV69euH27dtITEzE6dOnsWrVKgwaNIi7kSlPAFOHrq6uyOPbokWLRC6EVVFcT8VpC9U4xXdnZ2fHxT9//lx0w1bXFqplL1u2DImJiWo/LVq0EI53cXHB3r17kZKSglu3buH3339HQEAANxnq1q1b3E3+fa9tuV6f6jkMHTq0yHMYO3YsAOCPP/7gesYzZsxAcHAwtm/fjnXr1qF3797vVVcp/s3fdHF+P4oRo/f57SnfK4DCh2g/Pz/RNZ6Xl4eBAweWaoLf+0AG/T+OnZ0dvvrqKy5u0aJF+P7775GVlcXFZ2ZmYuPGjWjTpo0Q165dO+6Y9evXc7obN27gxo0bQtjQ0FD0Xrw0KL8yyMvLEw29FoeOHTty4YCAAME4RkdH4/vvv1erVx1VUB7eu337tlqDqNp+69at43raV65c4d6ZGxsbc+8klctOS0vjVi0sWbIEKSkpsmU/efJE6HGYmZnBx8cH48ePx44dO/D5558LxxX1vlSZ2bNncw8D4eHh6NChg+CsR5nr16/D19dXaK/GjRtzM7tDQkIQFBQkhHNycrBu3TouD0X71ahRgzPqL1++xKFDh4RwWloaNm7cKFtv1e9h3759MDIygrm5ueiTmpqK06dPCz3PN2/eCDd0HR0dNGrUCEOHDsXSpUsxb948Ll9lg67qSEVqOLcktGzZEgYGBkL45MmTyM3NlTwHDQ0NHDhwQBi6V52b4uHhIfzPGMPevXtLVbePxZ49exAdHS2E79+/jzNnzghhbW1t4f7Ttm1bTrtjxw7OAL98+RKHDx8WwhoaGty9DwCmTZuGO3fuCGF/f3/hgSUqKgojRoz46N41GWiWe7niY85yZ6zQUYycEw8fHx/Wq1cv1qJFC8ERhqOjo6DNzs5mTk5OolnggYGBbOrUqczExIRLmzlzJle26ix31bWxqjPI//nnHy5d1ZGJtbU1a9u2LfPx8WH/+9//hOPUzXJ/+PAhN5tVce7u7u5MX19f1C6qs9wPHjzIpWtoaLCuXbuyXr16idYLA/ws98zMTFatWjUuvVGjRiwwMJBNmTKFm7UMgM2ZM4crW3WVgqWlJRs8eDBr2bKlqFyAn+Xu4+PDHBwc2JQpU9j69evZsWPH2Pnz59nixYu59vD09CzupcQYY2zx4sWicjU1NVmjRo1Yr169WMeOHTm/BcePHxe08+bNE81anjRpElu0aBFr0qQJl1a1alWWkZEhaOfOncul6+rqshEjRrDvvvuO1alTR1Qn1XXoPj4+XHrz5s3Zli1b2IULF9ixY8fYsmXLBOcxvXv3FnTr169nBgYGzM/Pj/3888/s0KFD7MKFC2zXrl3cKgwA3AxsVUc3Ojo6rEWLFszHx4d17txZOE51lrvUOnAFAQEB3LE1a9ZkK1euZOfOnWMnT55kq1evZv3792cGBgac4yXV2eIuLi5s//797K+//mI9evQQtd306dO5cpVnuRsbG3Npt2/f5rT9+/fn0gMDA7n0rVu3yp6fKqr1BgqdGU2dOpV98803Iv8AqmV//vnnovaaO3cumzVrlsi3Rr9+/Tit6u9+0KBBjDHGJk+ezMX/8ssvRZ4HOZapwHxsg85Y4ZIVLy8vSSOg+lE26IwV/mAtLCyK1Pn4+Ig8LpXWoKsu61L+KDupKMqxzIYNG5iGhoZkPjNnzuTCqgY9KyuL80ylashU21XVsUxwcHCxHJN07NhR1D7//POPrCMNe3t75uLiwsWpGvTifN87d+5Ud+lIsnTpUlmPY6ofZYMutUxQ6mNqairyyJeeni5a1qb8adWqFRdWNejR0dGi9pL7qBr04mi6desmum5Ul9opPnp6esJxJTHoWVlZrH379sWqj7JBj4+PFy0ZVP54e3tz4fJq0OUeZIHCh33lZWmMMfby5UvRckapj5ubG0tISBB0L1684H6zjo6OLCkpSfgOlDtIenp67NatW2rPg5atER8UW1tbnD17Fjt27ECzZs0k39Mp3pEqOyQBCpf43L59G4MGDeLexyuws7PDkiVLcPz4ccn00tCpUyfs2rULLVq0KJXzhq+++gqnT5+Gt7c3DAwMYGBggBYtWuDQoUMYMWIEd6yq4x09PT389ddfcHNz4+Lt7Oxw4MAB+Pn5qS3b09MTt2/fxsCBA2Xb76effsJff/3FTTYCCodZN27cKKpT69atcenSJbXzFby9vVGnTvzmwzUAACAASURBVB3ZyWIuLi7YvXv3e20xGhAQgLt37+LLL7+UdVTk4uKCwMBAbsa+trY2jhw5ghUrVkjWXUdHB/369cPt27dFr24qVaqEM2fOiJzZGBgYYOHChUW+OrG1tcXNmzcxY8YMWb/idnZ2GD58OOev3tnZWTTcrYyZmRkmT54s2gNBT08PZ86cQZ8+feDk5CT6bt8HPT09HD9+HD///LPId7oCU1NT9O7dG/PnzxfiLC0tcfLkSdGsbiMjI/z888+YMGFCqev2Mfjyyy+xdetW0WuwJk2aICgoSHRNVa1aFbdu3cKECRMk94swNTXF9OnTce3aNSHP3NxcDBgwgHMmtG3bNuF1kZ6eHnbt2iVcD3Lv2f8NNFBo2ZGcnCxaXkCUDR4eHsL7w7La2zc5ORkPHz4U3inZ2Nigbt26RW5WkpmZibt37yI+Ph46OjpwdHREnTp1/vXJbf8mO3bswJdffimEx44dK7mkqaCgACEhIXj58iWsra3RuHHjEm/KkZGRgZCQEMTFxUFXVxfVqlWDq6trke2Xnp6O4OBgpKSkwMXFBc7OzsUuMzk5GZGRkYiPj0daWhpsbW1RtWrVYi83KwrFJhwxMTFITk6GhYUFnJ2di5X/48ePERERgaysLFSuXBkeHh7FWhcfERGB+/fvw8jICJ6enjA2Ni5RnQsKCvDo0SO8evUKOTk5sLOzg729Pezs7GS/i7y8PISHhyMuLg4JCQmwsLAQNiX5EMb6fXjx4gWeP3+O1NRUWFtbC9+r3HVZUFCA8PBwPH78GGZmZvD09JR9UCnPZGdnIzg4GImJiahRowbq1atXpCY3NxchISGIjY0VNmepX7/+R1l6Nnv2bCxcuBABAQFYunRpibQpKSnCQzMZ9HJIeTDo/zUULmlHjBjB9fQvXLiAAQMGcK4uz58/zzmrIAiCKA0fyqDTkDtBoHDN9cyZM2FjYwNra2u4u7vDzMwMbdq04Yz5sGHDyJgTBFEuIU9xBKFCXFycaBmPrq4upkyZwr13JAiCKE+QQScIAD/88APatWuHf/75BzExMYiPj4e+vr7wLrxHjx4fdcckgiCIkkIGnSBQ6KClR48e6NGjR1lXhSAI4r2gd+gEQRAEUQEgg04QBEEQFQAy6ARBEARRAaB36OWY8+fPc0umCIIgiIrHo0ePPkg+ZNDLMao7NREEQRCEHGTQyyEtW7aEra1tWVeDIAiC+Ii4uLiUSk+uXwmCIAjiE4VcvxIEQRBEBYMMOkEQBEFUAMigEwRBEEQFgAw6QRAEQVQAyKATBEEQRAWADDpBEARBVADIoBMEQRBEBYAMOkEQBEFUAMigEwRBEEQFgAw6QRAEQVQAyKATBEEQRAWADDpBEARBVADIoBMEQRBEBYAMOkEQBEFUAMigEwRBEEQFgAw6QRAEQVQAyKATBEEQRAWADDpBEARBVADIoBMEUWYwxsAYK+tqEESFgAw6QRBlwr59+2BpaQkLCwvs2bOnrKtDEJ88GgAYACQnJ8PExKSMq0MQxH+BgoICWFpa4t27dwAAMzMzJCQkQFOT+hgEURJSUlJgamoKgHroBEGUEQUFBdz/NPROEKWDDDpBEB8dTU1NrF69GsbGxjA2NsaqVaugpaVV1tUiiE8aGnInCKLMyM/PBwAy5gTxnigPuWuXcV0IgvgPQ4acID4cNOROEARBEBUAMugEQRAEUQEgg04QRJlw7949dO3aFV27dkVISEhZV4cgPnnoHTpBEGVCr169EB4eDgAICwvDs2fPyrhGBPFpQz10giA+Onl5eYiKihLCUVFRyM3NLcMaEcSnDxl0giA+Otra2vD39xfCY8eOhY6OThnWiCA+fWgdOkEQZcaNGzfAGEOzZs3KuioE8UlC69AJgigXNG3atKyrQBAVBhpyJwiCIIgKABl0giAIgqgA0JA7QRBlQkpKCjZu3AjGGEaNGkVzeAiilJBBJwiiTOjRowfOnz8PADh69CguXLhQthUiiE8cmuVOEMRHJy8vD3p6esKe6JqamsjKyqKlawRRQpRnudM7dIIgPjra2tpo06aNEPb29iZjThClhIbcCYIoEw4fPowNGzYI79AJgigdNOROEARBEJ8oNOROEARBEBUMMugEQRAEUQEgg04QRJlx7do1XL16tayrQRAVAjLoBEGUCRMmTMBnn32GFi1acDuvEQTxftCkOIIgPjp5eXmoVKmSsAe6jo4O0tPTaekaQZQQmhRHEESZoq2tDScnJyFcvXp1MuYEUUrIoBMEUSb88ccf6NmzJ3r06IE//vijrKtDEJ88NOROEARBEJ8oNOROEARBEBUMMugEQRAEUQEgg04QBEEQFQAy6ARBEARRASCDThAEQRAVADLoBEEQBFEBIINOEARBEBUAMugEQRAEUQEgg04QBEEQFQAy6ARBEARRASCDThAEQRAVADLoBEEQBFEBIINOEARBEBUA7bKuAFE8Dh06hD179sim161bF/PmzRPFp6amYuTIkWrz/t///ocqVaqI4lesWIFr167J6r744gsMGzZMFH///n3Mnz9fVqejo4OdO3dKpk2cOBHR0dGy2nHjxqFNmzai+L///htbt26V1dWqVQuLFi0Sxefk5GDw4MGyOgBYvHgxatSoIYr/7bffEBQUJKtr164dxowZI4p/+vQpZs2apbbM3bt3Q0tLSxQ/ffp0REREyOpGjBiBTp06ieLPnDmD9evXy+ocHBywfPlyybT+/fuDMSar/eGHH1CnTh1R/MaNG3Hq1ClZXatWrfDNN9+I4iMjIxEQECCrA4CtW7fCwMBAFD9nzhw8fvxYVjd48GB069ZNFH/x4kWsWrVKVmdtbS2bPmTIEGRlZclqZ82ahQYNGojit2/fjqNHj8rqmjRpItkOMTExku2mzPr162FmZiaKDwwMxL1792R1ffr0Qb9+/UTx169fl70+AMDU1BQbNmyQTBs1ahSSk5NltdOmTUPTpk1F8fv27cOBAwdkdfXr18fs2bNF8UlJSZK/O2VWrlwJGxsbUfzSpUsRHBwsq+vW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" alt="Top-level overview of a JP2 file. Boxes with dashed borders are optional." /><figcaption aria-hidden="true">Top-level overview of a JP2 file. Boxes with dashed borders are optional.</figcaption>
</figure>
<p>A number of things here are noteworthy to point out:</p>
<ul>
<li><p>Some of these boxes are required, whereas others (indicated with dashed lines in the Figure) are optional.</p></li>
<li><p>The order in which the boxes appear in the file is subject to some constraints (e.g. the first box in a JP2 must always be a ‘Signature’ box, followed by a ‘File Type’ box).</p></li>
<li><p>Some boxes may have multiple instances (e.g. ‘Contiguous Codestream’ box), whereas others must be unique (e.g. ‘JP2 Header’ box).</p></li>
</ul>
<p>More specific details can be found in the standard. The important thing here is that requirements like the above are something that should be verified by a validator, and this is exactly what <em>jpylyzer</em> does at the highest level of its validation procedure.</p>
<h2 id="general-box-structure">General structure of a box</h2>
<p>All boxes are defined by a generic binary structure, which is illustrated by the following Figure:</p>
<figure>
<img src="data:image/png;base64,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NPnPyZMnAYiKimLTpk3ExsbSs2dPihQpwtKlSzEzM6NPnz7ExcWxYcMGSpYsSbt27bhw4QK//vor1apVo0GDBhw9epTQ0FAaN26Ml5cXP/30E5cuXaJz5844OTmxevVq7t69y4ABA0hJSWHFihXY2dnRtWtXrl69yo4dO/Dw8KBZs2acOnWKgwcPUqdOHWrWrMm+ffs4c+YMr7/+OqVLl2bz5s3cuHGDt956C2tra7777juMjY3p27cvt2/fJigoiBIlStC+fXvCw8P55ZdfqFKlCj4+Phw7dow//viDRo0aUbFiRX7++WciIyPp2LEjxYoVY82aNSQmJuLv78/Dhw/5/vvvKVq0KN26deP69ets27aNsmXL0qJFC/7++2+Cg4OpXbs2tWrV4vfff+eff/6hVatWuLu7s2XLFmJiYujRowc2NjYsW7YMnU5Hv379iI+PZ/369RQvXpw33niDixcvsmfPHipXrsyrr75KSEgIISEh+Pr6UqlSJXbv3k1ERAQdOnTAxcWFdevWcefOHfr374+IsHz5cmxtbenevTvR0dFs3bqVMmXK0LJlS/755x9+//13vL298fb25sCBA4SFhdGiRQvKli3Ltm3buH79Ot27d8fW1pbly5cjIvTv35+EhATWrl2Li4sLHTp0ICIigt27d1OpUiV8fX0JDw8HIDw8nE2bNuXloawoBdajbVFEvdQrp6+goCCpVauWABIVFSUiIiYmJuLk5CQiIqdOnRJAmjZtKiIia9asEUDeffddERGZMGGCAPLdd9+JiEjbtm0FkOPHj4uIiJubmwCSnJwsN2/eFEAqVaokIiK//fabANKtWzcREZkzZ44A8tlnn4mIiL+/vwCyfft2ERGpU6eOABIZGSkiIubm5mJnZyciIv/8848A0rhxYxERWb9+vQAycuRIERGZNGmSALJ48WIREXnjjTcEkCNHjoiIiLu7uwBy//59uX37tgBSoUIFERHZv3+/APLmm2+KiMj8+fMFkKlTp4qIyKBBgwSQLVu2iIhI/fr1BZDw8HAREbGyshIbGxsRETl79qwA8uqrr4qIyA8//CCADBs2TEREPv74YwHkm2++ERGRTp06CSDBwcEiIlKuXDkBJDExURISEgQQDw8PEREJDg4WQDp16iQiIt98840A8vHHH4uIyNChQwWQjRs3ioiIj4+PAHLu3DkR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" alt="General structure of a box." /><figcaption aria-hidden="true">General structure of a box.</figcaption>
</figure>
<p>Most boxes are made up of the following three components:</p>
<ol type="1">
<li><p>A fixed-length ‘box length’ field that indicates the total size of the box (in bytes).</p></li>
<li><p>A fixed-length ‘box type’ field which specifies the type of information that can be found in this box</p></li>
<li><p>The box contents, which contains the actual information within the box. Its internal format depends on the box type. The box contents of a ‘superbox’ will contain its child boxes (which can be parsed recursively).</p></li>
</ol>
<p>In some cases a box will also contain an ‘extended box length field’. This field is needed if the size of a box exceeds 2<sup>32</sup>-1 bytes, which is the maximum value that can be stored in the 4-byte ‘box length’ field.</p>
<h2 id="defined-boxes">Defined boxes in JP2</h2>
<p>The following Table (taken from Table I.2 in ISO/IEC 15444-1, with minor modifications) lists all boxes that are defined in the standard. Addition signs in the ‘box name’ column indicate boxes that are children of a ‘superbox’.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Box name</th>
<th style="text-align: left;">Superbox</th>
<th style="text-align: left;">Required?</th>
<th style="text-align: left;">Purpose</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">JPEG 2000 Signature box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Identifies the file as being part of the JPEG 2000 family of files.</td>
</tr>
<tr class="even">
<td style="text-align: left;">File Type box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Specifies file type, version and compatibility information, including specifying if this file is a conforming JP2 file or if it can be read by a conforming JP2 reader.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">JP2 Header box</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Contains a series of boxes that contain header-type information about the file.</td>
</tr>
<tr class="even">
<td style="text-align: left;">+ Image Header box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Specifies the size of the image and other related fields.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">+ Bits Per Component box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the bit depth of the components in the file in cases where the bit depth is not constant across all components.</td>
</tr>
<tr class="even">
<td style="text-align: left;">+ Colour Specification box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Specifies the colourspace of the image.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">+ Palette box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the palette which maps a single component in index space to a multiple-component image.</td>
</tr>
<tr class="even">
<td style="text-align: left;">+ Component Mapping box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the mapping between a palette and codestream components.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">+ Channel Definition box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the type and ordering of the components within the codestream, as well as those created by the application of a palette.</td>
</tr>
<tr class="even">
<td style="text-align: left;">+ Resolution box</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Contains the grid resolution.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">++ Capture Resolution box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the grid resolution at which the image was captured.</td>
</tr>
<tr class="even">
<td style="text-align: left;">++ Default Display Resolution box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies the default grid resolution at which the image should be displayed.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Contiguous Codestream box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Required</td>
<td style="text-align: left;">Contains the codestream.</td>
</tr>
<tr class="even">
<td style="text-align: left;">Intellectual Property box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Contains intellectual property information about the image.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">XML box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Provides a tool by which vendors can add XML formatted information to a JP2 file.</td>
</tr>
<tr class="even">
<td style="text-align: left;">UUID box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Provides a tool by which vendors can add additional information to a file without risking conflict with other vendors.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">UUID Info box</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Provides a tool by which a vendor may provide access to additional information associated with a UUID.</td>
</tr>
<tr class="even">
<td style="text-align: left;">+ UUID List box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies a list of UUIDs.</td>
</tr>
<tr class="odd">
<td style="text-align: left;">+ URL box</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">Optional</td>
<td style="text-align: left;">Specifies a URL.</td>
</tr>
</tbody>
</table>
<p>A JP2 file may contain boxes that are not defined by the standard. Such boxes are simply skipped and ignored by conforming reader applications.</p>
<h1 id="output-format">Output format</h1>
<p>This section explains <em>jpylyzer</em>’s output format.</p>
<h2 id="output-format-overview">Overview</h2>
<p><em>Jpylyzer</em> generates its output in XML format, which is defined by <a href="https://jpylyzer.openpreservation.org/jpylyzer-v-2-1.xsd">the schema that can be found here</a>. The following Figure shows the output structure:</p>
<figure>
<img src="data:image/png;base64,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ErC3t39pGxnRoUOHLNehlEIplekEmZCQkKV2M+r5d1m8eHEsLS0BKFeu3Cu3u3PnDrGxseke5xo1ahAUFMSqVavo27fvS+tJTU3l6tWrPH36FFtbW/Lly6cTm1IKCwsLQkNDSU5OpmLFihgYGBAbG0toaChlypShYMGCOnUqpbhx4wapqanY2tq+9slJbiIJXYj/CA8PRymFh4eHvkPJFlu2bHmt7Xx9fZk/fz7R0dG4uLjg6+vLli1bSE5Oxt/fP035kJAQPDw8iI+Pp2DBgly7do0ZM2YwePDgdOufPHkyp0+fxt7ent27d/P48WMAfv/9d2rWrImLiwsPHjxg+vTprFy5kpCQEPbs2UOfPn3Imzcv5ubm3Lp1i+nTpzN06NDX2keAChUqpEkWmRUaGsr169dxc3PDzMwsw9vdunWLS5cuZantjJg2bRqLFi0iNjYWFxcX5syZw5o1a8ibNy+rV69OU/7UqVN4enqSmJhIgQIFuH79OnPmzKF///5aGSsrK7799lvGjh1LmzZtKFy4cLptBwUF4eHhQXJyMlZWVly7do2ZM2cyZMgQAD777DMiIiKAZ4/CvXnzJvXr12fcuHEMGDAAAwMDwsLC2LRpE23atAEgMDCQPn36YGFhgYmJCffv32fZsmW0a9cuuw/du0XlAFOnTlWAOn36tL5DEUK1adNGWVhY6DuMbGNubq5at279Wtt+++23ysHBQfvco0cP5enpqZRS6tdff1UGBgZKKaWSk5PVBx98oPr166eSk5OVUkpt27ZNGRkZqbNnzyqllNq6dasCVHh4uFJKqUmTJikzMzO1YMECpZRSSUlJqlatWuqjjz7S2itevLi2PioqShUoUECNHTtWW79q1SplaGiotZEZCxYsUIDat29fprf9r3HjxilAXb16NVPbzZ8/XwFq//79WY7hVb7++mvl5OSkfe7atavq1auXUkqp9evXqzx58iillEpMTFS2trZq4MCBKiUlRSml1ObNm5WxsbG6ePGiUkqpadOmqfr166uUlBRVp04d1adPH63epUuXKnt7e+2zu7u78vT0VKmpqUoppZYvX65MTEzUw4cPlVJKffrppypv3rwqICBAKaXUwYMHFaCaNGmiYmNjlVJKdenSRTVt2lQppdSjR4+UlZWV+vrrr7U25s6dqywtLdWDBw+y8YildeTIEQWoOXPm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lpbedLsNaceOHbq0ezO+//57bQ790qVLZGRkEBUVxfbt24mMjOTHH3/E29u7zjne3t6cPn2akydP4uLiQmBgIK+++irTp09n0aJFtGnTRo9baXB5eXksWrTI4utUVVXx7bffMm7cONLT07nnnnswmUxkZ2eTkJDABx98QFhYGC1btiQnJ0c7rlOnTtjZ2bF7927Gjh3LBx98QOfOnSWhC9Ec/bby/cKFC3WSnK2tbZ39zs7OnD9/vs62c+fOAWgFc3Dl6YBf//vixYs4OTlhNBoB+PLLLwkICKhznV+39dt2b6RVq1YYjUbKysrq7bs6D9ujRw8KCgooLS1l7dq1zJs3jzVr1tRJpHPnzr3pNpurFi1aMG7cOObOncvy5cuJjIy87mfCxsZG+yxdvHiRFStWEBISwrJlyxgzZkydL4p/VqtXr2b16tUWX6ddu3acO3eOBx54ALPZTMuWLVm1ahVHjhyhc+fOmM1m3NzcyM7O5pdffqFjx46YzWbatGnDhg0bOHv2LPfeey9msxlfX19J6EI0R3v27Knz+sCBAzes6g8KCqKwsLDOtqKiIry8vOok9D179hAYGAhAWVkZNTU1+Pv74+/vj52dHSUlJXTp0kU7fv/+/b/7NMH1HrsLCgrif//7HydOnKBDhw7a9uLiYkJDQzl58iT79++nW7duBAQEMGXKFKKionjwwQc5deqUdnxKSgrh4eE3jOH3LFmyhBUrVpCZmXlLi76sXbuW999/36K2b5czZ85w9OhR3NzcgOt/Jvz8/LQvZtOnT8fR0ZGvvvqKiIgIkpKSmD59+m2PvaElJCQ0SGHlmTNncHV1JTIyEicnJ4YPH05RUREA4eHhuLi48MQTT7B7925atGjBvffei7u7OyNGjGDgwIE4ODgQHByMp6cno0aNkoQuRHNUXFxMWloaffv25auvvmLHjh1aNfq1TJw4kUceeYT33nuPAQMGUFxczLx583j11VfrHPf+++9z11134e7uTmJiIh06dKB79+5YW1vz3HPPkZiYiKurK8HBwWRlZfHyyy/z+eef06NHj2u2azQaqaioYOvWrfj7+9fZ16NHDyIiInjqqaeYO3cuRqORjIwMli1bxrfffssvv/xC7969SUpKol+/ftTU1JCRkUFISIg2YgAQERFBdHS0Be8mfPXVVwB069YNPz+/mz6vpKTEonYb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" alt="Jpylyzer’s XML output structure. ‘box’ elements under ‘tests’ and ‘properties’ contain further sub-elements." /><figcaption aria-hidden="true">Jpylyzer’s XML output structure. ‘box’ elements under ‘tests’ and ‘properties’ contain further sub-elements.</figcaption>
</figure>
<p>The root element (<em>jpylyzer</em>) contains the following child elements:</p>
<ol type="1">
<li><p>one <em>toolInfo</em> element, which contains information about <em>jpylyzer</em></p></li>
<li><p>one or more <em>file</em> elements, each of which contain information about about the analysed files</p></li>
</ol>
<p>The XML output is pretty-printed. You can use the <code>--nopretty</code> switch to disable pretty-printing (this produces smaller files and may give a slightly better performance).</p>
<h2 id="toolinfo-element">toolInfo element</h2>
<p>This element holds information about <em>jpylyzer</em>. Currently it contains the following sub-elements:</p>
<ul>
<li><p><em>toolName</em>: name of the analysis tool (i.e. <em>jpylyzer</em> or <em>jpylyzer.exe</em>, depending on the platform used)</p></li>
<li><p><em>toolVersion</em>: version of <em>jpylyzer</em> (<em>jpylyzer</em> uses a date versioning scheme)</p></li>
</ul>
<h2 id="file-element">file element</h2>
<p>The <em>file</em> element contains the following sub-elements:</p>
<ol type="1">
<li><p><em>fileInfo</em>: general information about the analysed file</p></li>
<li><p><em>statusInfo</em>: information about the status of <em>jpylyzer</em>’s validation attempt</p></li>
<li><p><em>isValid</em>: outcome of the validation</p></li>
<li><p><em>tests</em>: outcome of the individual tests that are part of the validation process (organised by box)</p></li>
<li><p><em>properties</em>: image properties (organised by box)</p></li>
<li><p><em>propertiesExtension</em>: wrapper element for NISO <em>MIX</em> output (only if the <code>--mix</code> option is used)</p></li>
</ol>
<h2 id="fileinfo-element">fileInfo element</h2>
<p>This element holds general information about the analysed file. Currently it contains the following sub-elements:</p>
<ul>
<li><p><em>filename</em>: name of the analysed file without its path (e.g. “rubbish.jp2”)</p></li>
<li><p><em>filePath</em>: name of the analysed file, including its full absolute path (e.g. “d:\data\images\rubbish.jp2”)</p></li>
<li><p><em>fileSizeInBytes</em>: file size in bytes</p></li>
<li><p><em>fileLastModified</em>: last modified date and time</p></li>
</ul>
<h2 id="statusinfo-element">statusInfo element</h2>
<p>This element holds general information about about the status of <em>jpylyzer</em>’s attempt at validating a file. It tells you whether the validation process could be completed without any internal <em>jpylyzer</em> errors. It contains the following sub-elements:</p>
<ul>
<li><p><em>success</em>: a Boolean flag that indicates whether the validation attempt completed normally (“True”) or not (“False”). A value of “False” indicates an internal error that prevented <em>jpylyzer</em> from validating the file.</p></li>
<li><p><em>failureMessage</em>: if the validation attempt failed (value of <em>success</em> equals “False”), this field gives further details about the reason of the failure. Examples are:</p>
<ul>
<li><code>memory error (file size too large)</code></li>
<li><code>runtime error (please report to developers)</code></li>
<li><code>unknown error (please report to developers)</code></li>
</ul></li>
</ul>
<h2 id="isvalid-element">isValid element</h2>
<p>This element contains the results of the validation. If a file passed all the tests (i.e. all tests returned “True”, see <a href="#tests-element">here</a>) it is most likely valid, and the value of <em>isValid</em> will be “True”. Its value is “False” otherwise. The element has a <em>format</em> attribute, which defines the validation format (set by the <code>--format</code> command-line option). The <em>format</em> attribute can have the following values:</p>
<ul>
<li>“jp2” (JP2 validation)</li>
<li>“j2c” (raw codestream validation)</li>
</ul>
<h2 id="tests-element">tests element</h2>
<p>This element is reserved to hold the outcomes of all the individual tests that <em>jpylyzer</em> performs to assess whether a file is valid JP2. The results are organised in a hierarchical tree that corresponds to JP2’s box structure. Each individual test can have two values:</p>
<ul>
<li><p>“True” if a file passed the test.</p></li>
<li><p>“False” if a file failed the test.</p></li>
</ul>
<p>If a file passed <em>all</em> tests, this is an indication that it is most likely valid JP2. In that case, the <a href="#isvalid-element"><em>isValid</em> element</a> has a value of “True” (and “False” in all other cases). These tests are all explained <a href="#jp2-box-by-box">here</a> and <a href="#contiguous-codestream-box-chapter">here</a>.</p>
<h3 id="default-and-verbose-reporting-of-test-results">Default and verbose reporting of test results</h3>
<p>By default, <em>jpylyzer</em> only reports any tests that failed (i.e. returned “False”), including the corresponding part of the box structure. For a valid JP2 the tests element will be empty. If the –verbose flag is used, the results of <em>all</em> tests are included (including those that returned “True”)<a href="#fn3" class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</sup></a>.</p>
<h2 id="properties-element">properties element</h2>
<p>This element contains the extracted image properties, which are organised in a hierarchical tree that corresponds to JP2’s box structure. See <a href="#jp2-box-by-box">here</a> and <a href="#contiguous-codestream-box-chapter">here</a> for a description of the reported properties.</p>
<h2 id="propertiesExtension-element">propertiesExtension element</h2>
<p>This optional element is reserved for output in alternative formats. Currently it is used to wrap output in NISO <em>MIX</em> format if the <code>--mix</code> option is used. See the <a href="https://www.loc.gov/standards/mix/"><em>MIX</em> documentation</a> for a description of the reported elements.</p>
<h1 id="jp2-box-by-box">JP2: box by box</h1>
<p>The following two sections provide a detailed explanation of <em>jpylyzer</em>’s functionality and its output. In particular, the following two aspects are addressed:</p>
<ol type="1">
<li><p>The reported properties</p></li>
<li><p>The tests that <em>jpylyzer</em> performs to establish the validity of a file.</p></li>
</ol>
<h2 id="about-properties-tests-trees">About the properties and tests trees</h2>
<p>The ‘properties’ element in <em>jpylyzer</em>’s output holds a hierarchical tree structure that contains all extracted properties. The ‘tests’ tree follows the same structure. The hierarchy reflects JP2’s box structure (explained <a href="#structure-jp2">here</a>): each box is represented by a corresponding output element that contains the corresponding property entries. If a box is a superbox, the output element will contain child elements for each child box. For some boxes, the output contains further sub-elements. This applies in particular to the Contiguous Codestream box, since its contents are more complex than any of the other boxes. Also, if a Colour Specification box contains an embedded ICC profile, the properties of the ICC profile are stored in a separate sub-element. In addition to this, one ‘property’ that is reported by <em>jpylyzer</em> (the compression ratio) is not actually extracted from any particular box. Instead, it is calculated from the file size and some properties from the Header boxes. As a result, it is reported separately in the root of the properties tree.</p>
<h3 id="naming-of-properties">Naming of properties</h3>
<p>The naming of the reported properties largely follows the standard (ISO/IEC 15444-1). Some minor differences follow from the fact that the standard does have any consistent use of text case, whereas <em>jpylyzer</em> uses lower camel case. In addition, some parameters in the standard are compound units that aggregate a number of Boolean ‘switches’, where no names are provided for each individual switch. An example of this is the <em>Scod</em> (coding style) parameter in the codestream header, which contains three switches that define the use of precincts, start-of-packet markers and end-of-packet markers. For cases like these <em>jpylyzer</em> uses its own (largely self-descriptive) names (which are all documented in these sections).</p>
<h2 id="jpeg2000-signature-box">JPEG 2000 Signature box</h2>
<p>This box contains information that allows identification of the file as being part of the JPEG 2000 family of file formats.</p>
<h3 id="element-name">Element name</h3>
<p>signatureBox</p>
<h3 id="reported-properties">Reported properties</h3>
<p>None (box only holds JPEG 2000 signature, which includes non-printable characters)</p>
<h3 id="tests">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box contents equals 4 bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">signatureIsValid</td>
<td style="text-align: left;">Signature equals 0x0d0a870a</td>
</tr>
</tbody>
</table>
<h2 id="file-type-box">File Type box</h2>
<p>This box specifies file type, version and compatibility information, including specifying if this file is a conforming JP2 file or if it can be read by a conforming JP2 reader.</p>
<h3 id="element-name-1">Element name</h3>
<p>fileTypeBox</p>
<h3 id="reported-properties-1">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">br</td>
<td style="text-align: left;">Brand</td>
</tr>
<tr class="even">
<td style="text-align: left;">minV</td>
<td style="text-align: left;">Minor version</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cL<sup>*</sup></td>
<td style="text-align: left;">Compatibility field (repeatable)</td>
</tr>
</tbody>
</table>
<h3 id="tests-1">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">(Size of box – 8) /4 is a whole number (integer)</td>
</tr>
<tr class="even">
<td style="text-align: left;">brandIsValid</td>
<td style="text-align: left;"><em>br</em> equals 0x6a703220 (“jp2”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">minorVersionIsValid</td>
<td style="text-align: left;"><em>minV</em> equals 0</td>
</tr>
<tr class="even">
<td style="text-align: left;">compatibilityListIsValid</td>
<td style="text-align: left;">Sequence of compatibility (<em>cL</em>) fields includes one entry that equals 0x6a703220 (“jp2”)</td>
</tr>
</tbody>
</table>
<h2 id="jp2-header-box">JP2 Header box (superbox)</h2>
<p>This box is a superbox that holds a series of boxes that contain header-type information about the file.</p>
<h3 id="element-name-2">Element name</h3>
<p>jp2HeaderBox</p>
<h3 id="reported-properties-2">Reported properties</h3>
<p>Since this is a superbox, it contains a number of child boxes. These are represented as child elements in the properties tree:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#image-header-box">imageHeaderBox</a></td>
<td style="text-align: left;">Properties from Image Header box (required)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#bits-per-component-box">bitsPerComponentBox</a></td>
<td style="text-align: left;">Properties from Bits Per Component box (optional)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#colour-specification-box">ColourSpecificationBox</a></td>
<td style="text-align: left;">Properties from Colour Specification box (required)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#palette-box">paletteBox</a></td>
<td style="text-align: left;">Properties from Palette box (optional)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#component-mapping-box">componentMappingBox</a></td>
<td style="text-align: left;">Properties from Component Mapping box (optional)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#channel-definition-box">channelDefinitionBox</a></td>
<td style="text-align: left;">Properties from Channel Definition box (optional)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#resolution-box">resolutionBox</a></td>
<td style="text-align: left;">Properties from Resolution box (optional)</td>
</tr>
</tbody>
</table>
<h3 id="tests-2">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">containsImageHeaderBox</td>
<td style="text-align: left;">Box contains required Image Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;">containsColourSpecificationBox</td>
<td style="text-align: left;">Box contains required Colour Specification box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">containsBitsPerComponentBox</td>
<td style="text-align: left;">Box contains Bits Per Component Box, which is required if <em>bPCSign</em> and <em>bPCDepth</em> in Image Header Box equal 1 and 128, respectively (test is skipped otherwise)</td>
</tr>
<tr class="even">
<td style="text-align: left;">firstJP2HeaderBoxIsImageHeaderBox</td>
<td style="text-align: left;">First child box is Image Header Box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOneImageHeaderBox</td>
<td style="text-align: left;">Box contains no more than one Image Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;">noMoreThanOneBitsPerComponentBox</td>
<td style="text-align: left;">Box contains no more than one Bits Per Component box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOnePaletteBox</td>
<td style="text-align: left;">Box contains no more than one Palette box</td>
</tr>
<tr class="even">
<td style="text-align: left;">noMoreThanOneComponentMappingBox</td>
<td style="text-align: left;">Box contains no more than one Component Mapping box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOneChannelDefinitionBox</td>
<td style="text-align: left;">Box contains no more than one Channel Definition box</td>
</tr>
<tr class="even">
<td style="text-align: left;">noMoreThanOneResolutionBox</td>
<td style="text-align: left;">Box contains no more than one Resolution box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">colourSpecificationBoxesAreContiguous</td>
<td style="text-align: left;">In case of multiple Colour Specification boxes, they appear contiguously in the JP2 Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;">paletteAndComponentMappingBoxesOnlyTogether</td>
<td style="text-align: left;">Box contains a Palette box (only if Component Mapping box is present); box contains a Component Mapping box (only if Palette box is present)</td>
</tr>
</tbody>
</table>
<h2 id="image-header-box">Image Header box (child of JP2 Header box)</h2>
<p>This box specifies the size of the image and other related fields.</p>
<h3 id="element-name-3">Element name</h3>
<p>imageHeaderBox</p>
<h3 id="reported-properties-3">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">height</td>
<td style="text-align: left;">Image height in pixels</td>
</tr>
<tr class="even">
<td style="text-align: left;">width</td>
<td style="text-align: left;">Image width in pixels</td>
</tr>
<tr class="odd">
<td style="text-align: left;">nC</td>
<td style="text-align: left;">Number of image components</td>
</tr>
<tr class="even">
<td style="text-align: left;">bPCSign</td>
<td style="text-align: left;">Indicates whether image components are signed or unsigned</td>
</tr>
<tr class="odd">
<td style="text-align: left;">bPCDepth</td>
<td style="text-align: left;">Number of bits per component</td>
</tr>
<tr class="even">
<td style="text-align: left;">c</td>
<td style="text-align: left;">Compression type</td>
</tr>
<tr class="odd">
<td style="text-align: left;">unkC</td>
<td style="text-align: left;">Colourspace Unknown field (“yes” if colourspace of image data is unknown; “no” otherwise)</td>
</tr>
<tr class="even">
<td style="text-align: left;">iPR</td>
<td style="text-align: left;">Intellectual Property field (“yes” if image contains intellectual property rights information; “no” otherwise)</td>
</tr>
</tbody>
</table>
<h3 id="tests-3">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box contents equals 14 bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">heightIsValid</td>
<td style="text-align: left;"><em>height</em> is within range [1, 2<sup>32</sup> - 1]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">widthIsValid</td>
<td style="text-align: left;"><em>width</em> is within range [1, 2<sup>32</sup> - 1]</td>
</tr>
<tr class="even">
<td style="text-align: left;">nCIsValid</td>
<td style="text-align: left;"><em>nC</em> is within range [1, 16384]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">bPCIsValid</td>
<td style="text-align: left;"><em>bPCDepth</em> is within range [1,38] OR <em>bPCSign</em> equals 255 (in the latter case the bit depth is variable)</td>
</tr>
<tr class="even">
<td style="text-align: left;">cIsValid</td>
<td style="text-align: left;"><em>c</em> equals 7 (“jpeg2000”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">unkCIsValid</td>
<td style="text-align: left;"><em>unkC</em> equals 0 (“no”) or 1 (“yes”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">iPRIsValid</td>
<td style="text-align: left;"><em>iPR</em> equals 0 (“no”) or 1 (“yes”)</td>
</tr>
</tbody>
</table>
<h2 id="bits-per-component-box">Bits Per Component box (child of JP2 Header box)</h2>
<p>This (optional) box specifies the bit depth of the components in the file in cases where the bit depth is not constant across all components.</p>
<h3 id="element-name-4">Element name</h3>
<p>bitsPerComponentBox</p>
<h3 id="reported-properties-4">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">bPCSign<sup>*</sup></td>
<td style="text-align: left;">Indicates whether image component is signed or unsigned (repeated for all components)</td>
</tr>
<tr class="even">
<td style="text-align: left;">bPCDepth<sup>*</sup></td>
<td style="text-align: left;">Number of bits for this component (repeated for all components)</td>
</tr>
</tbody>
</table>
<h3 id="tests-4">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">bPCIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>bPCDepth</em> is within range [1,38] (repeated for all components)</td>
</tr>
</tbody>
</table>
<h2 id="colour-specification-box">Colour Specification box (child of JP2 Header box)</h2>
<p>This box specifies the colourspace of the image.</p>
<h3 id="element-name-5">Element name</h3>
<p>colourSpecificationBox</p>
<h3 id="reported-properties-5">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">meth</td>
<td style="text-align: left;">Specification method. Indicates whether colourspace of this image is defined as an enumerated colourspace or using a (restricted) ICC profile.</td>
</tr>
<tr class="even">
<td style="text-align: left;">prec</td>
<td style="text-align: left;">Precedence</td>
</tr>
<tr class="odd">
<td style="text-align: left;">approx</td>
<td style="text-align: left;">Colourspace approximation</td>
</tr>
<tr class="even">
<td style="text-align: left;">enumCS (if meth equals “Enumerated”)</td>
<td style="text-align: left;">Enumerated colourspace (as descriptive text string)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">icc (if meth equals “Restricted ICC” or “Any ICC”<a href="#fn4" class="footnote-ref" id="fnref4" role="doc-noteref"><sup>4</sup></a>)</td>
<td style="text-align: left;">Properties of ICC profile as child element (see below)</td>
</tr>
</tbody>
</table>
<h3 id="reported-properties-of-icc-profiles">Reported properties of ICC profiles</h3>
<p>If the colour specification box contains an embedded ICC profile, <em>jpylyzer</em> will also report the following properties (which are all grouped in an “icc” sub-element in the properties tree). An exhaustive explanation of these properties is given in the ICC specification (ISO 15076-1 / ICC.1:2004-10). Note that <em>jpylyzer</em> does <em>not</em> validate embedded ICC profiles (even though it does check if a specific ICC profile is allowed in JP2)!</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">profileSize</td>
<td style="text-align: left;">Size of ICC profile in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">preferredCMMType</td>
<td style="text-align: left;">Preferred CMM type</td>
</tr>
<tr class="odd">
<td style="text-align: left;">profileVersion</td>
<td style="text-align: left;">Profile version. Format: “majorRevision.minorRevision.bugFixRevision”</td>
</tr>
<tr class="even">
<td style="text-align: left;">profileClass</td>
<td style="text-align: left;">Profile/device class</td>
</tr>
<tr class="odd">
<td style="text-align: left;">colourSpace</td>
<td style="text-align: left;">Colourspace</td>
</tr>
<tr class="even">
<td style="text-align: left;">profileConnectionSpace</td>
<td style="text-align: left;">Profile connection space</td>
</tr>
<tr class="odd">
<td style="text-align: left;">dateTimeString</td>
<td style="text-align: left;">Date / time string. Format: “YYYY/MM/DD, h:m:s”</td>
</tr>
<tr class="even">
<td style="text-align: left;">profileSignature</td>
<td style="text-align: left;">Profile signature</td>
</tr>
<tr class="odd">
<td style="text-align: left;">primaryPlatform</td>
<td style="text-align: left;">Primary platform</td>
</tr>
<tr class="even">
<td style="text-align: left;">embeddedProfile</td>
<td style="text-align: left;">Flag that indicates whether profile is embedded in file (“yes”/”no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">profileCannotBeUsedIndependently</td>
<td style="text-align: left;">Flag that indicates whether profile can<em>not</em> (!) be used independently from the embedded colour data (“yes”/”no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">deviceManufacturer</td>
<td style="text-align: left;">Identifies a device manufacturer</td>
</tr>
<tr class="odd">
<td style="text-align: left;">deviceModel</td>
<td style="text-align: left;">Identifies a device model</td>
</tr>
<tr class="even">
<td style="text-align: left;">transparency</td>
<td style="text-align: left;">Indicates whether device medium is reflective or transparent</td>
</tr>
<tr class="odd">
<td style="text-align: left;">glossiness</td>
<td style="text-align: left;">Indicates whether device medium is glossy or matte</td>
</tr>
<tr class="even">
<td style="text-align: left;">polarity</td>
<td style="text-align: left;">Indicates whether device medium is positive or negative</td>
</tr>
<tr class="odd">
<td style="text-align: left;">colour</td>
<td style="text-align: left;">Indicates whether device medium is colour or black and white</td>
</tr>
<tr class="even">
<td style="text-align: left;">renderingIntent</td>
<td style="text-align: left;">Rendering intent</td>
</tr>
<tr class="odd">
<td style="text-align: left;">connectionSpaceIlluminantX</td>
<td style="text-align: left;">Profile connection space illuminant X</td>
</tr>
<tr class="even">
<td style="text-align: left;">connectionSpaceIlluminantY</td>
<td style="text-align: left;">Profile connection space illuminant Y</td>
</tr>
<tr class="odd">
<td style="text-align: left;">connectionSpaceIlluminantZ</td>
<td style="text-align: left;">Profile connection space illuminant Z</td>
</tr>
<tr class="even">
<td style="text-align: left;">profileCreator</td>
<td style="text-align: left;">Identifies creator of profile</td>
</tr>
<tr class="odd">
<td style="text-align: left;">profileID</td>
<td style="text-align: left;">Profile checksum (as hexadecimal string)</td>
</tr>
<tr class="even">
<td style="text-align: left;">tag<sup>*</sup></td>
<td style="text-align: left;">Signature of profile tag (repeated for all tags in the profile)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">description</td>
<td style="text-align: left;">Profile description (extracted from ‘desc’ tag)</td>
</tr>
</tbody>
</table>
<h3 id="tests-5">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">methIsValid</td>
<td style="text-align: left;"><em>meth</em> equals 1 (enumerated colourspace) or 2 (restricted ICC profile)</td>
</tr>
<tr class="even">
<td style="text-align: left;">precIsValid</td>
<td style="text-align: left;"><em>prec</em> equals 0</td>
</tr>
<tr class="odd">
<td style="text-align: left;">approxIsValid</td>
<td style="text-align: left;"><em>approx</em> equals 0</td>
</tr>
<tr class="even">
<td style="text-align: left;">enumCSIsValid (if meth equals “Enumerated”)</td>
<td style="text-align: left;"><em>enumCS</em> equals 16 (“sRGB”), 17 (“greyscale”) or 18 (“sYCC”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">iccSizeIsValid (if meth equals “Restricted ICC”)</td>
<td style="text-align: left;">Actual size of embedded ICC profile equals value of profileSize field in ICC header</td>
</tr>
<tr class="even">
<td style="text-align: left;">iccPermittedProfileClass (if meth equals “Restricted ICC”)</td>
<td style="text-align: left;">ICC profile class is “input device” or “display device”<a href="#fn5" class="footnote-ref" id="fnref5" role="doc-noteref"><sup>5</sup></a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">iccNoLUTBasedProfile (if meth equals “Restricted ICC”)</td>
<td style="text-align: left;">ICC profile type is not N-component LUT based (which is not allowed in JP2)</td>
</tr>
</tbody>
</table>
<h2 id="palette-box">Palette box (child of JP2 Header box)</h2>
<p>This (optional) box specifies the palette which maps a single component in index space to a multiple-component image.</p>
<h3 id="element-name-6">Element name</h3>
<p>paletteBox</p>
<h3 id="reported-properties-6">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">nE</td>
<td style="text-align: left;">Number of entries in the table</td>
</tr>
<tr class="even">
<td style="text-align: left;">nPC</td>
<td style="text-align: left;">Number of palette columns</td>
</tr>
<tr class="odd">
<td style="text-align: left;">bSign<sup>*</sup></td>
<td style="text-align: left;">Indicates whether values created by this palette column are signed or unsigned (repeated for all columns)</td>
</tr>
<tr class="even">
<td style="text-align: left;">bDepth<sup>*</sup></td>
<td style="text-align: left;">Bit depth of values created by this palette column (repeated for all columns)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cP<sup>**</sup></td>
<td style="text-align: left;">Value for this entry (repeated for all columns, and for the number of entries)</td>
</tr>
</tbody>
</table>
<h3 id="tests-6">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">nEIsValid</td>
<td style="text-align: left;"><em>nE</em> is within range [0,1024]</td>
</tr>
<tr class="even">
<td style="text-align: left;">nPCIsValid</td>
<td style="text-align: left;"><em>nPC</em> is within range [1,255]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">bDepthIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>bDepth</em> is within range [1,38] (repeated for all columns)</td>
</tr>
</tbody>
</table>
<h2 id="component-mapping-box">Component Mapping box (child of JP2 Header box)</h2>
<p>This (optional) box specifies the mapping between a palette and codestream components.</p>
<h3 id="element-name-7">Element name</h3>
<p>componentMappingBox</p>
<h3 id="reported-properties-7">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">cMP<sup>*</sup></td>
<td style="text-align: left;">Component index (repeated for all channels)</td>
</tr>
<tr class="even">
<td style="text-align: left;">mTyp<sup>*</sup></td>
<td style="text-align: left;">Specifies how channel is generated from codestream component (repeated for all channels)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">pCol<sup>*</sup></td>
<td style="text-align: left;">Palette component index (repeated for all channels)</td>
</tr>
</tbody>
</table>
<h3 id="tests-7">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">cMPIsValid</td>
<td style="text-align: left;"><em>cMP</em> is within range [0,16384]</td>
</tr>
<tr class="even">
<td style="text-align: left;">mTypIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>mTyp</em> is within range [0,1] (repeated for all channels)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">pColIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>pCol</em> is 0 if <em>mTyp</em> is 0 (repeated for all channels)</td>
</tr>
</tbody>
</table>
<h2 id="channel-definition-box">Channel Definition box (child of JP2 Header box)</h2>
<p>This (optional) box specifies the type and ordering of the components within the codestream, as well as those created by the application of a palette.</p>
<h3 id="element-name-8">Element name</h3>
<p>channelDefinitionBox</p>
<h3 id="reported-properties-8">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">n</td>
<td style="text-align: left;">Number of channel descriptions</td>
</tr>
<tr class="even">
<td style="text-align: left;">cN<sup>*</sup></td>
<td style="text-align: left;">Channel index (repeated for all channels)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cTyp<sup>*</sup></td>
<td style="text-align: left;">Channel type (repeated for all channels)</td>
</tr>
<tr class="even">
<td style="text-align: left;">cAssoc<sup>*</sup></td>
<td style="text-align: left;">Channel association (repeated for all channels)</td>
</tr>
</tbody>
</table>
<h3 id="tests-8">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">nIsValid</td>
<td style="text-align: left;"><em>n</em> is within range [1, 65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">(Size of box – 2) / equals 6*<em>n</em></td>
</tr>
<tr class="odd">
<td style="text-align: left;">cNIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>cN</em> is within range [0, 65535] (repeated for all channels)</td>
</tr>
<tr class="even">
<td style="text-align: left;">cTypIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>cType</em> is within range [0, 65535] (repeated for all channels)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cAssocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>cAssoc</em> is within range [0, 65535] (repeated for all channels)</td>
</tr>
</tbody>
</table>
<h2 id="resolution-box">Resolution box (child of JP2 Header box, superbox)</h2>
<p>This (optional) box contains the grid resolution.</p>
<h3 id="element-name-9">Element name</h3>
<p>resolutionBox</p>
<h3 id="reported-properties-9">Reported properties</h3>
<p>Since this is a superbox, it contains one or two child boxes. These are represented as child elements in the properties tree:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#capture-resolution-box">captureResolutionBox</a></td>
<td style="text-align: left;">Properties from Capture Resolution box</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#display-resolution-box">displayResolutionBox</a></td>
<td style="text-align: left;">Properties from Default Display Resolution box</td>
</tr>
</tbody>
</table>
<h3 id="tests-9">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">containsCaptureOrDisplayResolutionBox</td>
<td style="text-align: left;">Box contains either a Capture Resolution box or a Default Display Resolution box, or both</td>
</tr>
<tr class="even">
<td style="text-align: left;">noMoreThanOneCaptureResolutionBox</td>
<td style="text-align: left;">Box contains no more than one Capture Resolution box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOneDisplayResolutionBox</td>
<td style="text-align: left;">Box contains no more than one Default Display Resolution box</td>
</tr>
</tbody>
</table>
<h2 id="capture-resolution-box">Capture Resolution box (child of Resolution box)</h2>
<p>This (optional) box specifies the grid resolution at which the image was captured.</p>
<h3 id="element-name-10">Element name</h3>
<p>captureResolutionBox</p>
<h3 id="reported-properties-10">Reported properties</h3>
<p>Resolution information in this box is stored as a set of vertical and horizontal numerators, denominators and exponents. <em>Jpylyzer</em> also reports the corresponding grid resolutions in pixels per meter and pixels per inch, which are calculated from these values.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">vRcN</td>
<td style="text-align: left;">Vertical grid resolution numerator</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRcD</td>
<td style="text-align: left;">Vertical grid resolution denominator</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRcN</td>
<td style="text-align: left;">Horizontal grid resolution numerator</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRcD</td>
<td style="text-align: left;">Horizontal grid resolution denominator</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRcE</td>
<td style="text-align: left;">Vertical grid resolution exponent</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRcE</td>
<td style="text-align: left;">Horizontal grid resolution exponent</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRescInPixelsPerMeter</td>
<td style="text-align: left;">Vertical grid resolution, expressed in pixels per meter<a href="#fn6" class="footnote-ref" id="fnref6" role="doc-noteref"><sup>6</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;">hRescInPixelsPerMeter</td>
<td style="text-align: left;">Horizontal grid resolution, expressed in pixels per meter<a href="#fn7" class="footnote-ref" id="fnref7" role="doc-noteref"><sup>7</sup></a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRescInPixelsPerInch</td>
<td style="text-align: left;">Vertical grid resolution, expressed in pixels per inch<a href="#fn8" class="footnote-ref" id="fnref8" role="doc-noteref"><sup>8</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;">hRescInPixelsPerInch</td>
<td style="text-align: left;">Horizontal grid resolution, expressed in pixels per inch<a href="#fn9" class="footnote-ref" id="fnref9" role="doc-noteref"><sup>9</sup></a></td>
</tr>
</tbody>
</table>
<h3 id="tests-10">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box contents equals 10 bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRcNIsValid</td>
<td style="text-align: left;"><em>vRcN</em> is within range [1,65535]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRcDIsValid</td>
<td style="text-align: left;"><em>vRcD</em> is within range [1,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRcNIsValid</td>
<td style="text-align: left;"><em>hRcN</em> is within range [1,65535]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRcDIsValid</td>
<td style="text-align: left;"><em>hRcD</em> is within range [1,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRcEIsValid</td>
<td style="text-align: left;"><em>vRcE</em> is within range [-127,128]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRcEIsValid</td>
<td style="text-align: left;"><em>hRcE</em> is within range [-127,128]</td>
</tr>
</tbody>
</table>
<h2 id="display-resolution-box">Default Display Resolution box (child of Resolution box)</h2>
<p>This (optional) box specifies the default grid resolution at which the image should be displayed.</p>
<h3 id="element-name-11">Element name</h3>
<p>displayResolutionBox</p>
<h3 id="reported-properties-11">Reported properties</h3>
<p>Resolution information in this box is stored as a set of vertical and horizontal numerators, denominators and exponents. <em>Jpylyzer</em> also reports the corresponding grid resolutions in pixels per meter and pixels per inch, which are calculated from these values.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">vRdN</td>
<td style="text-align: left;">Vertical grid resolution numerator</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRdD</td>
<td style="text-align: left;">Vertical grid resolution denominator</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRdN</td>
<td style="text-align: left;">Horizontal grid resolution numerator</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRdD</td>
<td style="text-align: left;">Horizontal grid resolution denominator</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRdE</td>
<td style="text-align: left;">Vertical grid resolution exponent</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRdE</td>
<td style="text-align: left;">Horizontal grid resolution exponent</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vResdInPixelsPerMeter</td>
<td style="text-align: left;">Vertical grid resolution, expressed in pixels per meter<a href="#fn10" class="footnote-ref" id="fnref10" role="doc-noteref"><sup>10</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;">hResdInPixelsPerMeter</td>
<td style="text-align: left;">Horizontal grid resolution, expressed in pixels per meter<a href="#fn11" class="footnote-ref" id="fnref11" role="doc-noteref"><sup>11</sup></a></td>
</tr>
<tr class="odd">
<td style="text-align: left;">vResdInPixelsPerInch</td>
<td style="text-align: left;">Vertical grid resolution, expressed in pixels per inch<a href="#fn12" class="footnote-ref" id="fnref12" role="doc-noteref"><sup>12</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;">hResdInPixelsPerInch</td>
<td style="text-align: left;">Horizontal grid resolution, expressed in pixels per inch<a href="#fn13" class="footnote-ref" id="fnref13" role="doc-noteref"><sup>13</sup></a></td>
</tr>
</tbody>
</table>
<h3 id="tests-11">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box contents equals 10 bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRdNIsValid</td>
<td style="text-align: left;"><em>vRdN</em> is within range [1,65535]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">vRdDIsValid</td>
<td style="text-align: left;"><em>vRdD</em> is within range [1,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">hRdNIsValid</td>
<td style="text-align: left;"><em>hRdN</em> is within range [1,65535]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRdDIsValid</td>
<td style="text-align: left;"><em>hRdD</em> is within range [1,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">vRdEIsValid</td>
<td style="text-align: left;"><em>vRdE</em> is within range [-127,128]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">hRdEIsValid</td>
<td style="text-align: left;"><em>hRdE</em> is within range [-127,128]</td>
</tr>
</tbody>
</table>
<h2 id="codestream-box">Contiguous Codestream box</h2>
<p>This box contains the codestream. See <a href="#contiguous-codestream-box-chapter">here</a>.</p>
<h2 id="intellectual-property-box">Intellectual Property box</h2>
<p>This (optional) box contains intellectual property information about the image. The JP2 format specification (ISO/IEC 15444-1) does not provide any specific information about this box, other than stating that “the definition of the format of [its] contents […] is reserved for ISO”. As a result, <em>jpylyzer</em> does not currently include a validator function for this box, which is now simply ignored. <em>Jpylyzer</em> will display a user warning message in that case.</p>
<h2 id="xml-box">XML box</h2>
<p>This (optional) box contains XML formatted information.</p>
<h3 id="element-name-12">Element name</h3>
<p>xmlBox</p>
<h3 id="reported-properties-12">Reported properties</h3>
<p>If the contents of this box are well-formed XML (see ‘tests’ below), the ‘xmlBox’ element in the properties tree will contain the contents of the XML box. Note that, depending on the character encoding of the original XML, it may contain characters that are not allowed in the encoding that is used for <em>jpylyzer</em>’s output. Any such characters will be represented by numerical entity references in the output. If the box contents are not well-formed XML, no properties are reported for this box.</p>
<h3 id="tests-12">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">containsWellformedXML</td>
<td style="text-align: left;">Contents of box are parsable, well-formed XML</td>
</tr>
</tbody>
</table>
<p>Note that <em>jpylyzer</em> does not check whether the XML is <em>valid</em>, as this is not required by the standard. Besides, doing so would make <em>jpylyzer</em> significantly slower for XML that contains references to external schemas and DTDs.</p>
<h2 id="uuid-box">UUID box</h2>
<p>This (optional) box contains additional (binary) information, which may be vendor-specific. Some applications (e.g. Kakadu and ExifTool) also use this box for storing XMP metadata (see Section 1.1.4 in Part 3 of the XMP specification<a href="#fn14" class="footnote-ref" id="fnref14" role="doc-noteref"><sup>14</sup></a>).</p>
<h3 id="element-name-13">Element name</h3>
<p>uuidBox</p>
<h3 id="reported-properties-13">Reported properties</h3>
<p>If the value of <em>uuid</em> indicates the presence of XMP metadata and the contents of this box are well-formed XML, (see ‘tests’ below), the ‘uuidBox’ element in the properties tree will contain the XMP data. Note that, depending on the character encoding of the original XML, it may contain characters that are not allowed in the encoding that is used for <em>jpylyzer</em>’s output. Any such characters will be represented by numerical entity references in the output. In all other cases, the ‘uuidBox’ element will contain a standard string representation the of UUID.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">Standard string representation of UUID (<strong>only</strong> if uuid has value other than <em>be7acfcb-97a9-42e8-9c71-999491e3afac</em>). For an explanation of UUIDs see e.g. Leach <em>et al</em>., 2005.</td>
</tr>
<tr class="even">
<td style="text-align: left;">XMP data</td>
<td style="text-align: left;">XMP metadata (<strong>only</strong> if uuid has value <em>be7acfcb-97a9-42e8-9c71-999491e3afac</em>)</td>
</tr>
</tbody>
</table>
<p>Note that except for the XMP case, <em>jpylyzer</em> will not be able to report any information on the actual contents of this box, since it is defined outside of the scope of JPEG 2000.</p>
<h3 id="tests-13">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box contents is greater than 16 bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">containsWellformedXML</td>
<td style="text-align: left;">Contents of box are parsable, well-formed XML (this test is <strong>only</strong> performed if uuid has value <em>be7acfcb-97a9-42e8-9c71-999491e3afac</em>)</td>
</tr>
</tbody>
</table>
<h2 id="uuid-info-box">UUID Info box (superbox)</h2>
<p>This (optional) box contains additional information associated with a UUID.</p>
<h3 id="element-name-14">Element name</h3>
<p>uuidInfoBox</p>
<h3 id="reported-properties-14">Reported properties</h3>
<p>This is a superbox which contains two child boxes. These are represented as child elements in the properties tree:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#uuid-list-box">uuidListBox</a></td>
<td style="text-align: left;">Properties from UUID List box</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#data-entry-url-box">urlBox</a></td>
<td style="text-align: left;">Properties from Data Entry URL box</td>
</tr>
</tbody>
</table>
<h3 id="tests-14">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">containsOneListBox</td>
<td style="text-align: left;">Box contains exactly one UUID List box</td>
</tr>
<tr class="even">
<td style="text-align: left;">containsOneURLBox</td>
<td style="text-align: left;">Box contains exactly one Data Entry URL box</td>
</tr>
</tbody>
</table>
<h2 id="uuid-list-box">UUID List box (child of UUID Info box)</h2>
<p>This (optional) box specifies a list of UUIDs.</p>
<h3 id="element-name-15">Element name</h3>
<p>uuidListBox</p>
<h3 id="reported-properties-15">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">nU</td>
<td style="text-align: left;">Number of UUIDs</td>
</tr>
<tr class="even">
<td style="text-align: left;">uuid<sup>*</sup></td>
<td style="text-align: left;">Standard string representation of UUID (repeated <em>nU</em> times)</td>
</tr>
</tbody>
</table>
<h3 id="tests-15">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxLengthIsValid</td>
<td style="text-align: left;">Size of box equals <em>nU</em> * 16 + 2</td>
</tr>
</tbody>
</table>
<h2 id="data-entry-url-box">Data Entry URL box (child of UUID Info box)</h2>
<p>This (optional) box specifies a URL.</p>
<h3 id="element-name-16">Element name</h3>
<p>urlBox</p>
<h3 id="reported-properties-16">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">version</td>
<td style="text-align: left;">Version number</td>
</tr>
<tr class="even">
<td style="text-align: left;">loc</td>
<td style="text-align: left;">Location, which specifies a URL of the additional information associated with the UUIDs in the UUID List box that resides in the same UUID Info box</td>
</tr>
</tbody>
</table>
<h3 id="tests-16">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">flagIsValid</td>
<td style="text-align: left;">Three bytes that make up “flag” field equal 0x00 00 00 (‘flag’ is not reported to output because it only contains null bytes)</td>
</tr>
<tr class="even">
<td style="text-align: left;">locIsUTF8</td>
<td style="text-align: left;">Location (URL) can be decoded to UTF-8</td>
</tr>
<tr class="odd">
<td style="text-align: left;">locHasNullTerminator</td>
<td style="text-align: left;">Location (URL) is a null-terminated string</td>
</tr>
</tbody>
</table>
<h2 id="unknown-box-section">Unknown box</h2>
<p>An image may contain boxes that are not defined by ISO/IEC 15444-1. Although <em>jpylyzer</em> ignores such boxes, it will report some minimal info that will allow interested users to identify them to a limited extent.</p>
<h3 id="element-name-17">Element name</h3>
<p>unknownBox</p>
<h3 id="reported-properties-17">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">boxType</td>
<td style="text-align: left;">Four-character text string that specifies the type of information that is found in this box (corresponds to <em>TBox</em> in section I.4 of ISO/IEC 15444-1).</td>
</tr>
</tbody>
</table>
<h2 id="top-level-tests-properties">Top-level tests and properties</h2>
<p>This sub-section describes the tests and output for the top file level.</p>
<h3 id="element-name-18">Element name</h3>
<p>properties</p>
<h3 id="reported-properties-18">Reported properties</h3>
<p>The metrics that are listed here are not ‘properties’ in a strict sense; instead they are secondary or derived metrics that are calculated by combining information from different parts / boxes of the file.</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">compressionRatio</td>
<td style="text-align: left;">Compression ratio</td>
</tr>
</tbody>
</table>
<p>The compression ratio is calculated as the ratio between the size of the uncompressed image data and the actual file size:</p>
<p><math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>compressionRatio</mi> <mo>=</mo> <mfrac> <mrow> <mi>sizeUncompressed</mi> </mrow> <mrow> <mi>sizeCompressed</mi> </mrow> </mfrac> </mrow> </math></p>
<p>Here, <em>sizeCompressed</em> is simply the file size (<em>fileSizeInBytes</em> in output file’s ‘fileInfo’ element). The uncompressed size (in bytes) can be calculated by multiplying the number of bytes per pixel by the total number of pixels:</p>
<p><math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>sizeUncompressed</mi> <mo>=</mo> <mfrac> <mrow> <mn>1</mn> </mrow> <mrow> <mn>8</mn> </mrow> </mfrac> <munderover> <mo>∑</mo> <mrow> <mi>i</mi> <mo>=</mo> <mn>1</mn> </mrow> <mi>nC</mi> </munderover> <msub> <mi>bPCDepth</mi> <mi>i</mi> </msub> <mo>•</mo> <mi>height</mi> <mo>•</mo> <mi>width</mi> </mrow> </math></p>
<p>With:</p>
<dl>
<dt>nC</dt>
<dd>number of image components (from Image Header box)
</dd>
<dt>i</dt>
<dd>component index
</dd>
<dt>bPCDepth<sub>i</sub></dt>
<dd>bits per component for component <em>i</em> (from Image Header box or Bits Per Component box)
</dd>
<dt>height</dt>
<dd>image height (from Image Header box)
</dd>
<dt>width</dt>
<dd>image width (from Image Header box)
</dd>
</dl>
<p>In addition, the root of the properties tree contains the elements for all top-level boxes:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#jpeg2000-signature-box">signatureBox</a></td>
<td style="text-align: left;">Properties from JPEG 2000 Signature box</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#file-type-box">fileTypeBox</a></td>
<td style="text-align: left;">Properties from File Type box</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#jp2-header-box">jp2HeaderBox</a></td>
<td style="text-align: left;">Properties from JP2 Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#contiguous-codestream-box-chapter">contiguousCodestreamBox</a></td>
<td style="text-align: left;">Properties from Contiguous Codestream box</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#intellectual-property-box">intellectualPropertyBox</a></td>
<td style="text-align: left;">Properties from Intellectual Property box (optional)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#xml-box">xmlBox</a></td>
<td style="text-align: left;">Properties from XML box (optional)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#uuid-box">uuidBox</a></td>
<td style="text-align: left;">Properties from UUID box (optional)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#uuid-info-box">uuidInfoBox</a></td>
<td style="text-align: left;">Properties from UUID Info box (optional)</td>
</tr>
</tbody>
</table>
<h3 id="tests-17">Tests</h3>
<p>The tests that <em>jpylyzer</em> performs at the root level fall in either of the following two categories:</p>
<ol type="1">
<li><p>Tests for the presence of required top-level boxes, the order in which they appear and restrictions on the number of instances for specific boxes</p></li>
<li><p>Tests for consistency of information in different parts of the file. In particular, a lot of the information in the Image Header box is redundant with information in the codestream header, and <em>jpylyzer</em> performs a number of tests to verify the consistency between these two.</p></li>
</ol>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">containsSignatureBox</td>
<td style="text-align: left;">File root contains a JPEG 2000 Signature box</td>
</tr>
<tr class="even">
<td style="text-align: left;">containsFileTypeBox</td>
<td style="text-align: left;">File root contains a File Type box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">containsJP2HeaderBox</td>
<td style="text-align: left;">File root contains a JP2 Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;">containsContiguousCodestreamBox</td>
<td style="text-align: left;">File root contains a Contiguous Codestream box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">containsIntellectualPropertyBox</td>
<td style="text-align: left;">File root contains an Intellectual Property box, which is required if <em>iPR</em> field in Image Header Box equals 1 (test is skipped otherwise)</td>
</tr>
<tr class="even">
<td style="text-align: left;">firstBoxIsSignatureBox</td>
<td style="text-align: left;">First box is JPEG 2000 Signature box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">secondBoxIsFileTypeBox</td>
<td style="text-align: left;">Second box is File Type box</td>
</tr>
<tr class="even">
<td style="text-align: left;">locationJP2HeaderBoxIsValid</td>
<td style="text-align: left;">JP2 Header box is located after File Type Box and before (first) Contiguous Codestream box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOneSignatureBox</td>
<td style="text-align: left;">File root contains no more than one JPEG 2000 Signature box</td>
</tr>
<tr class="even">
<td style="text-align: left;">noMoreThanOneFileTypeBox</td>
<td style="text-align: left;">File root contains no more than one File Type box</td>
</tr>
<tr class="odd">
<td style="text-align: left;">noMoreThanOneJP2HeaderBox</td>
<td style="text-align: left;">File root contains no more than one JP2 Header box</td>
</tr>
<tr class="even">
<td style="text-align: left;">heightConsistentWithSIZ</td>
<td style="text-align: left;">Value of <em>height</em> from Image Header Box equals <em>ysiz –yOsiz</em> from codestream SIZ header</td>
</tr>
<tr class="odd">
<td style="text-align: left;">widthConsistentWithSIZ</td>
<td style="text-align: left;">Value of <em>width</em> from Image Header Box equals <em>xsiz</em> –<em>xOsiz</em> from codestream SIZ header</td>
</tr>
<tr class="even">
<td style="text-align: left;">nCConsistentWithSIZ</td>
<td style="text-align: left;">Value of <em>nC</em> from Image Header Box equals <em>csiz</em> from codestream SIZ header</td>
</tr>
<tr class="odd">
<td style="text-align: left;">bPCSignConsistentWithSIZ</td>
<td style="text-align: left;">Values of <em>bPCSign</em> from Image Header box (or Bits Per Component box) are equal to corresponding <em>ssizSign</em> values from codestream SIZ header</td>
</tr>
<tr class="even">
<td style="text-align: left;">bPCDepthConsistentWithSIZ</td>
<td style="text-align: left;">Values of <em>bPCDepth</em> from Image Header box (or Bits Per Component box) are equal to corresponding <em>ssizDepth</em> values from codestream SIZ header</td>
</tr>
</tbody>
</table>
<h1 id="contiguous-codestream-box-chapter">Contiguous Codestream box</h1>
<h2 id="codestream-structure">General codestream structure</h2>
<p>The Contiguous Codestream box holds the JPEG 2000 codestream, which contains the actual image data in a JP2.</p>
<h3 id="markers-and-marker-segments">Markers and marker segments</h3>
<p>A codestream is made up of a number of functional entities which are called <em>markers</em> and <em>marker segments</em>. A <em>marker</em> is essentially a 2-byte delimiter that delineates the start or end position of a functional entity. A <em>marker segment</em> is the combination of a marker and a set of associated parameters (<em>segment parameters</em>). However, not every marker has any associated parameters.</p>
<h3 id="general-structure-of-the-codestream">General structure of the codestream</h3>
<p>The codestream is made up of a number of components. The Figure below gives an overview.</p>
<figure>
<img src="data:image/png;base64,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qVOn0ooVKygqKop69uxJFhYW1KdPH7p58yZL7t69ezR27Fiys7Oj9u3b09ChQyk5OZm5zufzydPTk65evUpTpkxh5q5jx44EgDp16iR2vES194ynpyfduXOHli5dStbW1mRvb09//PEH1dTU0Jo1a8jOzo4cHBxo9erVLOelwsJCWrhwIXXq1IksLCzIy8uLTpw4wWo/ICCANm3aRDt27CArKys6deoU3b59mwDQhQsXGLmsrCzy9vam0NBQpuzixYvUt29fatOmDTk4OFBQUBArZ+iBAwdo4MCBlJaWRp07d6ZJkyZJnOuoqCgaNGgQ2dnZkYuLC02ePJkyMzNZMhcvXiQfHx+mv8WLF7P6E8p4eXmRjY0NjRw5krKysmjatGm0atUqIqr9jnl6etLt27fp559/pvbt21OHDh1oy5YtVFNTQ+vXr6cOHTqQg4MDrVixgjWfAoGA1q5dS25ubmRubk49evQQSW8XGBhI69atoxs3bpC3tzcz7zExMUREFB0dLfYebggu12QTJSUlhQCIJFmtC2eIcfwv+VINscePHzPG0bBhwyg3N1ei7P379xnZnTt3ipX58ccfCQBJS0uLGGrvMsROnDhBAOjs2bMSddi5cyfJycnRypUr6dy5c/THH3+Qubk5eXp6EhHR/v37SUdHh9zc3Gjbtm309OlTKioqIgMDA3JycqIjR47QqVOnyNvbmxQVFenRo0dEVJuzkcfjkY+PDzk5OVFQUBDdvn2b5syZQwBo4cKFIgmh6zJ48GBSVFSkdevWUWRkJK1atYrk5OQYT+O///6bRo4cSQDot99+Ezt+4UMVAP30009MPtWOHTvSwIEDiUjUEHv79i05ODiQkZER7d27ly5cuEATJ04kaWlpOn/+vER9iYjc3NzIysqKHBwcKCwsjMLDw8na2pqUlZUpJyeHiIjy8vJIU1OTOnfuTMePH6eTJ09St27dSF1dnZ4+fUpE/80x6+PjQ25ubrR48WJKSEigKVOmEABatmyZ2PES1RrIAKhLly40Z84cOnnyJA0cOJAA0OjRo2n8+PF04sQJCggIIAAUERHB1O3cuTMZGhrS7t276dy5c8zc1fWodnR0JC8vL2rdujUtWLCAEhISRAyxly9fUtu2balnz55MXswjR46QlJQUTZo0iS5cuEB79uwhIyMjcnd3Z3J+rlmzhpSVlaln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" alt="General structure of a JPEG 2000 codestream." /><figcaption aria-hidden="true">General structure of a JPEG 2000 codestream.</figcaption>
</figure>
<p>From top to bottom, the Figure shows the following components:</p>
<ol type="1">
<li><p>A <em>start of codestream</em> (SOC) marker, which indicates the start of the codestream</p></li>
<li><p>A main codestream header (which includes a number of header marker segments)</p></li>
<li><p>A sequence of one or more <em>tile parts</em>. Each tile part consists of the following components:</p>
<ol type="a">
<li><p>A <em>start of tile-part</em> (SOT) marker segment, which indicates the start of a tile part, and which also contains index information of the tile part and its associated tile</p></li>
<li><p>Optionally this may be followed by one or more additional tile-part header marker segments</p></li>
<li><p>A <em>start of data</em> (SOD) marker that indicates the start of the bitstream for the current tile part</p></li>
<li><p>The bitstream</p></li>
</ol></li>
<li><p>An ‘end of codestream’ (EOC) marker that indicates the end of the codestream.</p></li>
</ol>
<h2 id="limitations-codestream-validation">Limitations of codestream validation</h2>
<p>It is important to stress here that <em>jpylyzer</em> currently doesn’t support the full set of marker segments that can occur in a codestream. As a result, the validation of codestreams is somewhat limited. These limitations are discussed in this sub-section.</p>
<h3 id="main-codestream-header">Main codestream header</h3>
<p>Annex A of ISO/IEC 15444-1 lists a total of 13 marker segments that can occur in the main codestream header. Most of these are optional. The current version of <em>jpylyzer</em> only offers full support (i.e. reads and validates) for the following main header marker segments (which includes all the required ones):</p>
<ul>
<li><p>Start of codestream (SOC) marker segment (required)</p></li>
<li><p>Image and tile size (SIZ) marker segment (required)</p></li>
<li><p>Coding style default (COD) marker segment (required)</p></li>
<li><p>Coding style component (COC) marker segment (optional)</p></li>
<li><p>Region-of-interest (RGN) marker segment (optional)</p></li>
<li><p>Quantization default (QCD) marker segment (required)</p></li>
<li><p>Quantization component (QCC) marker segment (optional)</p></li>
<li><p>Progression order change (POC) marker segment (optional)</p></li>
<li><p>Component registration (CRG) marker segment (optional)</p></li>
<li><p>Comment (COM) marker segment (optional)</p></li>
</ul>
<p>In addition the codestream header may also contain any of the following marker segments, which are all optional:</p>
<ul>
<li><p>Packet length, main header (PLM) marker segment (optional) <sup>*</sup></p></li>
<li><p>Packed packet headers, main header (PPM) marker segment (optional) <sup>*</sup></p></li>
<li><p>Tile-part lengths (TLM) marker segment (optional) <sup>*</sup></p></li>
</ul>
<p>The optional markers that are marked with an asterisk above are only minimally supported at this stage.</p>
<h3 id="tile-parts">Tile parts</h3>
<p>The tile part validation has similar limitations. The standard lists 11 marker segments that can occur in the tile part header. Currently, <em>jpylyzer</em> only fully supports the following ones:</p>
<ul>
<li><p>Start of tile part (SOT) marker segment (required)</p></li>
<li><p>Coding style default (COD) marker segment (optional)</p></li>
<li><p>Coding style component (COC) marker segment (optional)</p></li>
<li><p>Region-of-interest (RGN) marker segment (optional)</p></li>
<li><p>Quantization default (QCD) marker segment (optional)</p></li>
<li><p>Quantization component (QCC) marker segment (optional)</p></li>
<li><p>Progression order change (POC) marker segment (optional)</p></li>
<li><p>Comment (COM) marker segment (optional)</p></li>
<li><p>Start of data (SOD) marker segment (required)</p></li>
</ul>
<p>In addition the following optional marker segments may also occur:</p>
<ul>
<li><p>Packet length, tile-part header (PLT) marker segment (optional) <sup>*</sup></p></li>
<li><p>Packed packet headers, tile-part header (PPT) marker segment (optional) <sup>*</sup></p></li>
</ul>
<p>The optional markers that are marked with an asterisk above are only minimally supported at this stage: if <em>jpylyzer</em> encounters them, it will include the corresponding element in the <em>properties</em> element of the output. However, <em>jpylyzer</em> does not analyse the contents of these marker segments, which means that the respective elements in the output will be empty.</p>
<h3 id="bit-streams">Bit streams</h3>
<p>In addition to the above limitations, <em>jpylyzer</em> can <em>not</em> be used to establish whether the data in the bitstream are correct (this would require decoding the compressed image data, which is completely out of <em>jpylyzer</em>’s scope)<a href="#fn15" class="footnote-ref" id="fnref15" role="doc-noteref"><sup>15</sup></a>. As a result, if <em>jpylyzer</em> is used as part of a quality assurance workflow, it is recommended to also include an additional check on the image contents<a href="#fn16" class="footnote-ref" id="fnref16" role="doc-noteref"><sup>16</sup></a>. Also, <em>jpylyzer</em> does not perform any checks on marker segments within the bit-stream: start-of packet (SOP) and end-of-packet (EPH) markers.</p>
<h3 id="detection-of-incomplete-or-truncated-codestreams">Detection of incomplete or truncated codestreams</h3>
<p>A JP2’s tile part header contains information that makes it possible to detect incomplete and truncated codestreams in most cases. Depending on the encoder software used, this method may fail for images that only contain one single tile part (i.e. images that do not contain tiling).</p>
<h3 id="current-limitations-of-comment-extraction">Current limitations of comment extraction</h3>
<p>Both the codestream header and the tile part header can contain comment marker segments, which are used for embedding arbitrary binary data or text. <em>Jpylyzer</em> will extract the contents of any comments that are text.</p>
<h2 id="structure-reported-output">Structure of reported output</h2>
<p>The Figure below illustrates the structure of <em>jpylyzer</em>’s codestream-level output.</p>
<figure>
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAAJXCAYAAABltqZXAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAOKQAADikB1CGL5gAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAACAASURBVHic7N15eEzn+z/w92QmiwiRhGwEiSzEFsRaRCJFLbGvbaml5aMtbT+U6qdKaVFVitpVN7rEWluRhKp9ja22REgiIpZIIpJJMrl/f/jN+RoTRCRGpu/Xdc118ZxnnnOfmZO5z/I8z1EBEBARPUdjx47Fl19+aeowiMyKBgBsbW1Rq1YtU8dCRGYuIyMDFy5cMHUYRGZJAwC1atXCkSNHTB0LEZm5qKgotG3b1tRhEJklC1MHQERERM+OCZ2IiMgMMKETERGZASZ0IiIiM8CETkREZAaY0ImIiMwAEzoREZEZMPuEfuDAAQwfPhzr1q0zdSgvlLy8POTn5z+39V27dg3Dhw/HnDlznts6iYj+Tcw+oV+8eBFLlizB4cOHTR2KSYkI1q5di7CwMFSsWBGWlpawtrZGlSpV0KNHD2zZsgUiJTcLcGpqKpYsWYItW7aU2Dr+LU6cOIHAwECjV9OmTdGlSxeMHj0a+/fvN3WYRPScmVVCHz16NDp37mxQ1rFjRxw5cgRvv/22iaIyvbS0NLzyyivo2bMnNm/eDG9vbwwcOBB9+/aFs7Mz1q1bh06dOqFLly64d++eqcMtNv7+/vjmm29MHUaxu3v3Lo4ePYpz584ZlGu1Wuzfvx9z585FixYt8Omnn5ooQiIyBY2pAyhOu3btQoUKFQzKnJyc4OTkZKKITC8/Px99+vTB9u3bERAQgJ9//hm1a9c2qHPo0CH0798fmzdvxpgxY7BgwQITRVt8EhMTcfbsWWRnZ5s6lBJTr1497Nu3z6BMp9Nh1apVGDJkCKZOnYrXX38d3t7eJoqQiJ6nYknoOp0Omzdvxv79+3Hv3j14e3ujV69ecHNzM6p79+5drFu3DidOnEBWVhZcXV0RGhqK5s2bG9SLi4vDjh070KRJEwQEBGDHjh3YuXMnsrOz4ePjg169eqFSpUoAgJMnT2Lfvn04c+YMvLy8sGTJEpQvXx79+vXDxYsXsXPnTgQEBKBJkyYG69i+fTv27NkDnU6HBg0aoFu3brhx4wY2btyIOnXqoEWLFgCAnTt34uLFi+jUqRMqV65s0MapU6ewf/9+NG/eHHXr1jVYdunSJWzYsAGXL1+GSqWCl5cXunfvDg8PD4N6O3bsQFxcHMLCwuDq6mqw7Pjx4zh8+DBatmwJf39/pTw7Oxvr169HTEwMMjIy4OzsjFatWhlt48qVK7F9+3Z4eHggMjISjo6ORt9JkyZNEBkZidq1a2P79u1ITU2Fg4ODsjw9PR3r1q3DqVOnkJ2dDVdXV7Rv3x6NGzc2agsADh48iI0bNyItLQ2enp7o27dvgfX0MjMzsX79ehw/fhxarRZVq1ZFWFgY/Pz8jOqKCCIjI3HixAmkpKSgfPnyCAgIQPv27aHR3N+dN23ahB07dgC4f7CyZMkS5fuMiIjApUuX0L9/f1y8eBG//vorfH19MWzYMGUdqampWLt2Lc6cOQOdTgdPT090794d1apVKzD+hIQErFu3DvHx8cr33KFDB3h6ehrUO3LkCI4dO4ZXXnkFDg4OWLlyJc6cOQMHBwd0794dAQEBAIBjx45h/fr1yMjIQK1atdCvXz+UL1/+sZ+hnlqtxuuvv47ly5fjr7/+QnR0tFFCz8nJwR9//IEjR44gLS1N2Xfatm0LlUoF4P7+9dNPP8HCwgKDBg1SPlu9vXv34syZM2jQoMEj9wMiev6kUaNGUlQpKSnSpEkTASBqtVocHR0FgNja2sqqVasM6u7bt09cXFwEgFSuXFnq168vtra2AkB69eol2dnZSt0//vhDAMjEiRNl2LBhAkCqVKmi1HdxcZErV66IiMhXX30luP8YWOXl7e0tIiI//vijAJCPPvpIaTs3N1d69uyp1K1SpYpYW1tLixYt5OeffxYAMmbMGKX+wIEDBYBs377daPtnzZolAGTWrFkG5TNmzBCNRiMWFhZSq1Yt8fPzE5VKJVZWVrJgwQKDur169RIAsmfPHqP2p0yZIgAM3rN7925xdnYWAOLg4CAeHh5iZWUlAKRbt24Gn2OzZs0EgKxYseKR36FefHy8UdmuXbukYsWKAkA8PDykXr16UqZMGQEgr776quTk5BjUnzp1qqhUKlGr1VKnTh2pWrWq2Nvby/LlywWAvPzyywb1Dxw4IG5ubgJAKlWqJD4+PqJWq0WtVsunn35qUDc5OVkaNmyo7F/Vq1dX9gdfX19lfwgJCTHaH0aPHi0iIgMGDBAA8scffyjvfeWVV5R1/Pnnn+Lg4CAAxN3dXby8vMTCwkKsrKzk22+/Nfp8vv76a1Gr1WJhYSGVK1cWV1dXASBWVlby008/GdSdPHmyAJAffvhB6tatK2XLllXWpdFoZNu2bbJw4UKxsLAQFxcXsbS0FABSt25dg+90z549AkCaN2/+yO8yODhYAMiuXbsMys+ePSs1atRQPu8GDRpI+fLlBYAEBQVJamqqUnfkyJECQGbOnGnQxrVr18TBwUGcnJzk6tWrj4yhIJGRkQJAxo4d+1TvI6Ine+aE3rFjRwEg06dPl3v37omIyLFjx8TZ2VmsrKzk3LlzIiJy+/ZtcXZ2FktLS1mzZo3y/vT0dOnatasAkAkTJijl27ZtEwDi6ekpISEhkpSUJCIi2dnZ0r9/f6OkGxsbKwCkdevWBvEVlNAXLlwoACQwMFASExNFROTWrVsSFhYmVatWNYrlaRP6pk2bBID4+flJTEyMUn7mzBmpXLmyWFhYyMGDB5Xyp03o/v7+YmlpKdu2bVPK7ty5oxz46OtmZGSIRqMRtVotaWlpRm0/yfXr18XR0VFsbGxk48aNSnlqaqq88sorAkCmTJmilJ84cUIsLCzE2dlZ+d5FRDZv3qwcgDyY0G/evCkuLi5ibW0tv//+u1J+5coVCQwMFACyevVqpfydd94RADJ58mTlQCI3N1eWLFkiKpVKevXqpdSdO3eusl8+6I033hAA0qJFCxkxYoQcP35cLly4ICIily5dEjs7O6lQoYLBd/3PP/+Ir6+vWFhYGHxHp06dEpVKJR4eHnLx4kWlfPfu3WJtbS1ly5aV27dvK+XTp08XAFK1alWZOnWq5ObmiojI7Nmzlf3F19dXTp8+rXzODRo0EACydu1apZ0nJfSDBw+KtbW1eHl5iVarVcpzcnKkZs2aAkC+/fZb0el0InL/b2r48OECQF5//XWlfmZmpvj5+Ymtra3BftynTx8BIOHh4QWu/3GY0IlKzjMl9NOnTwsAqV27ttGyb775Rjw8PGTRokUi8n8/sAMGDDCqGxcXJxYWFuLo6Kj8UEdERAgAsbOzk+TkZIP6u3btEgDSsWNHpexpEnrz5s0FgGzevNmgbkZGhlSqVEm5MqD3tAldf4ZY0A/enDlzBIAMHDhQKXuahJ6XlycqlUo8PT2N6t69e1d++OEHOXXqlIjcP4DQHxQVxYwZMwSADB061GjZ2bNnBYC4uroqiWHMmDECQD755BOj+oMGDTJK6PoE9+GHHxrVj46OVhKvXlBQkACQ2NhYo/pr1qyRyMhI5f+PSuj6g55mzZoZtTF69GgBILNnzzZatnXrVgEgPXv2VMoOHjwo7733ntGVKBGRHj16CADZtGmTUjZz5kwBII0bNzaoq9VqlSssD7f1zTffGG2HPqG7u7vLuHHjlNeoUaPklVdeEY1GI4GBgXL+/HmDttavXy8ApGXLlkbxZmRkiJ2dnWg0GklJSVHKDx06JJaWlhIaGir5+fmyceNGASCDBg0yaqMwmNCJSs4z9XLftWsXgPs9yR82atQoxMfHY/jw4QCAv/76CwDQo0cPo7rVq1dHnTp1cPv2baOeu40bN4aLi4tRfeD+2OanpdPpcPz4cWg0GrRr185gmZ2dHbp37/7UbT4oNzcX+/btg1qtRlhYmNFyfS/8hzszFZZarYanpyfi4uLw5ZdfIiMjQ1lWtmxZDBw4EHXq1AEAZVm5cuWKtK7HfWc1a9aEj48PkpOTcenSJQBQvrvQ0FCj+l26dDEqi4yMBACjkQkAUL9+fbi7u+PQoUPIysoCAPj4+AAAxo8fj6tXrxrU79GjB0JCQp64Tfp7xL169XqqeEJCQmBtba18JsD9vgezZ89G//79jepXrVoVwP378Q97+HngVlZWqFixIgCgTZs2Bsvc3d0BANevXzdqJykpCTNmzFBec+fOxdatW1GuXDk0bdrUqEOgPvaC9nE7Ozu0adMGeXl5OHTokFLeuHFj/O9//0NERATmz5+PkSNHonr16pg7d65RG0RkWs/UKS4+Ph4AjBJuQRISEgD83w/Uw1xdXXHy5EkkJiYadC57uBMaAJQpUwYAijQxyp07d5CdnQ1nZ2ejjj4AjHqAP60bN24gOzsbLi4usLKyMlqu7yiYmJhY5HUsXboU3bt3x7hx4/DJJ5+gVatW6NatG7p3727weel796enpxdpPYX5zi5evIjExER4e3sjKSkJAODs7GxUt6AOkleuXAEAfPTRR8p3+qDMzEzk5eUhISEBvr6+mDx5Mvbs2YPw8HCEh4cjICAAXbp0Qc+ePVG/fv2n2rYqVao8Mp7hw4fDwsL4WNfCwgI3b95ERkaGcpB04cIFLFq0CKdOncLly5dx69YtAFAOQqSAsf0Pd3wE7id1lUpl9Lek34cK2tcbN26Mbdu2GZSlpqZi3759mDx5MpYuXYqVK1cqBy/6v9fHfZ+A8b45YcIEbN26FaNGjYJarcbOnTsL3UmPiJ6fZ0roWq0WAGBjY1PoumXLli1wub5cX09PrVY/S4hGdDrdY+MoKLE8jSdtp42NDdRqNbRaLUREOWN8GiEhIbh06RLCw8Pxyy+/YNeuXYiMjMTo0aMxePBgzJs3D2XKlIGbmxssLCwQHx+PtLQ02NvbF+u2PPyd6Q8cCvoMC9pHcnJyAAAODg4Fvkd/BcXS0hLA/UQUHR2NrVu3YtWqVdiyZQumTJmCKVOmoEWLFvj555+NepY/SkFXLfTxODo6Fvi96M/c8/LyANw/4+3QoQPy8vLQrVs3DB48GE5OTlCpVFi9erXS0/5hBR0sFGbZwzQajcFoBOD+Z+nl5YWXXnoJ3t7eGDFiBLp27QpLS0tl++zs7Aps71F/gxqNBrVr18aBAwdga2v7yN7+RGRaz5TQ9Qnixo0bz1w3JSUFAIzGkRc3JycnqNXqAi+FPhhHYT08EcuTtvPWrVvQ6XSoUKFCoZL5oyZ6cXJywogRIzBixAikpaVh69at+OKLL7B8+XI4OTlhxowZKFu2LF566SX8/fffWLNmDYYMGfLYdR0+fBi2trbKVYoHt0V/uftBD39nlSpVQkxMDFJTU41+9Au6ZOzg4IDLly/j888/R7169Z7wSdxnbW2Nbt26oVu3bsjNzcXff/+NefPmYf369ejduzeOHDlSqHYK4uDggOTkZHz77bcFXmV42NixY5GdnY3ffvsNffr0MVh24sSJRyb058HT0xNeXl6IiYnBhQsXULt27SL/DW7ZsgXfffcdOnTogMjISAwaNAiRkZFPdfBBRCXvmf4i9T/8J0+eNFp27tw5TJs2Tbkvqf/BPn36tFHdvLw8XLhwASqV6pkveT+JWq2Gs7Mz0tLSCvxhe/AeqZ7+7LGg+ufPnzf4v6OjI6pUqYKMjAzlEu6D/vnnHwBQ7nM/2H5BBxMPt18Qe3t79OvXT/mR3bx5s7Ls9ddfBwBMmjTpkQcxwP2z6z59+qB+/fo4e/YsgMd/Z1qtFrGxsbCwsFDGx+svq8fGxhrVL2gf0bd/6tSpJ25jQSwtLRESEoK1a9ciICAAR48eLfDAobAet70FiY6Oho2NDXr37m20bO/evUWOozjodDrls9Bf4dDfynrU9hW0b968eRPDhg1DlSpV8Ouvv+Kjjz7Crl278PXXX5dk+ERUBM+U0Nu3b4+yZcti8+bNyv05vblz52LChAlKQurZsycAYPny5colS71169bhxo0baN26tTJZzNPSX5rX37t8nObNm0NEsHLlSoPyyMhIREVFGdXXTwSj/8HTu3z5MtasWWNUX3/PcsmSJUbL9GX6zwP4vw5UD7d/4cIFbNy40aAsKioKnp6ej53S9MF790OHDkWrVq2QkJCA9u3b4/Lly0b14+PjERISgsuXL2PIkCGoVauWQYzLli0zuof722+/IS0tDe3atVMuXzdr1gwAsGrVKoO6Wq0WK1asAGB4T1l/Vvv1118b7RNJSUmoU6cOpk6dCgC4ffs26tevb/C5PUylUin9IvT7w9PMFKeP56uvvjK69/3PP//A39/fYBY9R0dH5OTkGPVRWLhwodJB8M6dO4Vef3HJzc3F+PHjkZGRAR8fH+XqSs+ePWFhYYGVK1ciMzPT4D0HDx7EiRMnUKNGDWWCGwD4z3/+g2vXrmHx4sWwt7fHxx9/jLp16+J///tfgQdpRGRazzQOXT+G1svLSxYsWCC//vqrDBs2TFQqlfj7+0t6erpSVz9+tWPHjrJ582bZu3evzJw5U+zt7aVMmTJy5MgRpa5+2FpBw2OuX78uAKR+/fpKWXZ2tlhZWYlGo5GvvvpK5s+fL1qttsBha3v37hW1Wi02NjYyevRo+f7772X8+PHi4OAgb7/9ttGwNf0wITs7O5k1a5Zs3rxZZs+eLW5ubvL6668LAJk2bZpSPyUlRSpXriwajUY++ugj+fvvv2X79u0ydOhQASD16tWTrKwspf6OHTsEgNjb28ucOXNk8+bN8tVXX4mLi4u8+uqrAkDmzJkjIveHF1WuXFksLS3l/fffl/Xr18v27dtl2bJlyqQr8+fPN/i8rl27Ji1atBAAYm1tLd26dZOJEyfKJ598Ij169FCGTL3++usGE5iIiHTp0kUASNeuXWXr1q2yZ88emTZtmtjZ2UnZsmWVIXIi98eV6ycWGjp0qKxevVp+/vlneemll6R9+/bK5CV6+fn5yhwEISEhsmbNGtm5c6fMnTtXqlWrJmq1WjZs2KDU7969uxLLqlWrZMeOHfL7778rw/66d++u1NXPBVCjRg1ZtmyZMs79zTffLHDIosj9Me36IY3du3eXDRs2SFRUlMycOVOcnZ3F2tpa9u3bp9QfPHiwAJAOHTrItm3bZMOGDTJo0CDx8PCQr7/+WgBIaGioHDhwQPLy8pRha3PnzjVad/Xq1UWlUhmVb9iwwWBiHJH/2x9dXFzkrbfeUl5DhgyRTp06KRP1lC9fXvbu3WvQ3tixY5Ux7GvXrpX9+/fLwoULxc3NTdRqtcEwO/3fzsN/g4cOHRK1Wm004U1hcNgaUcl55oQuIrJo0SJxd3dXZuWysLCQvn37SkJCgkE9rVYr48ePlwoVKhjUbd26tRw+fNig7tMmdBGRadOmiYWFhZK47t69W2BCF7k/E52/v78A92e4a968uezevVu+++47AWA0S9n06dOlbNmyStyVKlWSFStWKGN7J02aZFA/Li5OwsLCRKPRKO+xtbWVIUOGyK1bt4y2afLkycoMbPj/47tXrVolq1atEgDy5ZdfKnVjY2MlLCxMmUlM/6pWrZrRLHQPfvbz5s2TgIAAg/dYWFhIUFDQIycJycrKkg8++ECZTUz/nuDgYImOjjaqf/DgQaldu7ZSV6PRyOuvvy6JiYkFjv/Ozs6WcePGKTOm6V+NGjUySrr37t2Td955x2D/0R8IjRo1SjIzM5W6ubm5BjPGtWvXTkQen9BF7k90NHLkSLGzs1Peq1KppGXLlkbzBKSkpEibNm0M6gUHB0tsbKykpaVJvXr1BIBYWlpKZmZmsSf0gl7ly5eXevXqyQcffGD09ydy/yBq5syZyoyN+lfDhg0N5lm4cuWK2Nvbi5ubm8HkOHoffvihAJAPPvigwM/xUZjQiUqO6v//eD5TZyLg/qXUK1euIDMzE97e3rC2tn5kXZ1Oh7i4OGRnZ8Pd3b3A+cWLKj09HRkZGXB3dy9Up7OsrCxoNBrlPuO0adMwYcIEzJo1Cx988IFR3PHx8cjLy4Onp2eBw94elpGRgYSEBKjValSvXv2xn0teXh6uXLkCEYGnp+cTe/hnZ2fj+vXryMjIQJUqVQrdoTA7OxsJCQmwsLCAh4dHgcPrCootLi4OWq22UOtKSEhAWloaqlatWqghTjqdDpcvX0ZWVtYT94m8vDykpKTg1q1bqFSpUoHDwPSSk5NhZWX11PtYbm4u4uLikJeXh8qVKz92hEBaWhoSExPh6upq9CCg9PR02NnZvXAdyPR/r+np6XB1dS1UJ8DiEBUVhbZt22Ls2LH48ssvn8s6if4tii2hlyb79+/Hli1b8PLLL6N169YGy9q2bYuoqChERkYWaqISIio8JnSikvNinTY8J5mZmZg6dSoGDhyIv/76Czk5OUhKSsKECRMQFRWF2rVrIygoyNRhEhERFZpZPQ+9sEJDQzFnzhxMmDDBaKrNevXqYfXq1cU+oQ0REVFJ+lcmdAAYPXo0Bg4ciF27diE+Ph42NjaoW7cumjVr9sLd7yQiInqSf21CB+7PDPasD2MhIiJ6EfBUlIiIyAxogPtPcnrUnOFERMXl4Qe/EFHx0QDA8ePHH/lELSIiInrxaVq1amXqGIjoKURHRyMjIwOl+W/Xy8vL1CEQmR2VyENPoSCiF1rTpk1x6NAh6HQ6jsggIgV/DYiIiMwAEzoREZEZYEInIiIyA0zoREREZoAJnYiIyAwwoRMREZkBJnQiIiIzwIRORERkBpjQiYiIzAATOhERkRn4Vz8PnYiK7scff8SdO3dMHYbZ8fLyQufOnU0dBpVCTOhEVCRTpkxBTEyMqcMwO2FhYUzoVCRM6ERUZGXKlMGiRYtMHYZZSE1NxXvvvWfqMKgUY0InoiKztLTEwIEDTR2GWbh69SoTOj0TdoojIiIyA0zoREREZoAJnYiIyAwwoRMREZkBJnQiIiIzwIRORERkBpjQicisZWVlITU1FTk5OaYOhahEMaETkVn74osv4OjoiJUrV5o6FKISxYRORGatRo0aCA0Nhbu7u6lDISpRnCmOiMzaG2+8gTfeeMPUYRCVOJ6hExERmQEmdCIqlaKjo9G/f394enrC2toaLi4uaNmyJX766SeDegsXLkRgYCA2btyolIWEhCAwMPCRr7/++ut5bw7RM+MldyIqdY4ePYqXXnoJZcqUwWuvvQYPDw+kp6cjPDwcAwcORFJSEsaNGwcASEpKwtGjR3Hz5k3l/dWqVUNmZqZBm1qtFn/88QcAID8///ltDFExYUInolJnxYoV0Gq1+OWXX9C9e3elfMKECWjWrBnWr1+PsWPHwsKi4IuQK1asMCobNWoUAGDAgAEIDg4umcCJShATOhGVOvqz63v37hmU29ra4uTJk0/d3po1azBv3jz4+flh8eLFxRIj0fPGe+hEVOr07NkTKpUKw4YNwzvvvIPt27dDq9UWqa1Lly5h6NChKFOmDH7//XfY2dkVc7REzwfP0IlKqdTU1EdeUn4eTHmfuXPnzvjxxx/x+eef49tvv8W3336L8uXLo1OnThgyZAhCQ0ML1Y5Wq0WfPn2QlpaGpUuXol69eiUcOVHJYUInKqUqVqxo6hBQrlw5k637tddew2uvvYajR49i3bp12L59O3755Rf88ssvmDhxIiZPnvzENsaMGYOjR4/i1VdfxbBhw55D1EQlhwmdqJRq27YtVCqVyda/b98+k65fr1GjRmjUqBGmTp2KY8eOoUOHDpg6dSpGjBgBNze3R75vzZo1mD9/PmrWrIlFixY9x4iJSgYTOlEptX37dpNecvfx8UFKSspzX69Op8P+/fuRm5tr1Bu9YcOG6NSpE77//nvExsY+MqHHxsZi6NChsLW15X1zMhtM6ERUqlhYWGDo0KG4fv06oqKi0LBhQ2XZzZs3sXv3bmg0Gvj6+hb4fq1Wi759+yItLQ3Lli1D3bp1n1foRCWKvdyJqFRRqVRYsGAB8vLyEBgYiMaNG6Nbt25o06YNqlWrhri4OMyYMQPOzs4Fvn/nzp04evQoAGDs2LFwdHQ0en322WfPc5OIigXP0Imo1Gnbti3OnDmDn376CadPn8bNmzdRsWJFvP322+jXr5/BWXurVq0wbtw45Uzc09NTmUXuUZo0aVKi8ROVBJWIiKmDIKLCa9q0KQ4dOgSdTvdC3ENPS0szWQzm5OrVq6hSpQrCwsKwYcMGU4dDpRAvuRMREZkBJnQiIiIzwIRORERkBpjQiYiIzAATOhERkRlgQiciIjIDHIdOREWm1Woxffp0U4dhFtLT000dApVyTOhEVGRarRYfffSRqcMgIjChE1ERzZ8/HxkZGaYOw+y4u7ubOgQqpZjQiahI2rdvb+oQiOgB7BRHRERkBpjQiYiIzAATOhERkRlgQiciIjID7BRHREVy+/Zt5OXlmToMs2NtbQ17e3tTh0GlEBM6ERVJ06ZNERMTY+owzA6fh05FxYROREWm0Wjw8ssvmzoMs6DVahEVFWXqMKgUY0InoiKztbXFli1bTB2GWbh69SqqVKli6jCoFGOnOCIiIjPAhE5ERGQGmNCJiIjMABM6ERGRGWBCJyIiMgNM6ERERGaACZ2IiMgMMKETET3CDz/8gJdffhl//vmnqUMheiImdCKiR7h06RIiIiJw9epVU4dC9ERM6ERERGaACZ2IiMgMcC53Iio1Lly4gJ9//hkXLlxA2bJlERAQgCFDhqBs2bJGdf/++29s2LAB8fHxUKvV8PX1Rd++feHv729UNyMjA4sXL8bRo0eh0WjQsGFDDBky5HlsElGx4Rk6EZUK33//PerUqYPPP/8cR48eRWRkJEaNGgVfX1+Dx7jm5+djyJAhaN26NZYtW4Zbt27h6tWr+PLLL1G3bl3Mnj3boN3bt2+jSZMmGDt2LA4dOoTExETMnDkTTZs2RVpa2vPeTKIiY0InohfemTNnMHz4cHh4eCAuLg4XMX+s6QAAIABJREFUL17E5cuX8d133yEpKQl9+/ZV6i5atAgrVqxA69atceXKFURGRmL37t04e/Ys3N3dMWbMGBw5ckSp/9lnn+HcuXN44403cOHCBezcuRNXr15Fv379sHjxYlNsLlGRMKET0Qtv4cKFyMnJwX//+19UrVpVKR88eDB69uwJOzs7XLt2DQAwf/58AMC0adNgb2+v1K1evTreffdd5OfnY+nSpUr5L7/8ApVKhU8++QRqtRoAoFKpMGHCBIP3E73oeA+dqJRaunQpVCqVydafnp7+3Nb1999/AwBCQ0ONlq1evVr5961bt3D27Fk4OjqiRYsWRnXbt2+PcePG4eDBgwCAtLQ0pKSkwMPDA15eXgZ1raysEBwcjF9//bU4N4WoxDChE5VSI0aMMHUIKFeu3HNZT2JiIgDAxcXlsfWSkpIAAG5ubgUu178/OTnZoH6lSpUKrO/q6vr0wRKZCBM6USm1aNEik56hf/LJJ8jOzn4u68rLywMAaDSP/8nS17O2ti5wub48NzcXAHDv3j0A98/GC6K/BE9UGjChE5VSb775JiwsTNcNZubMmc8toTs4OCA9PR3Xr183ujT+IEdHRwDA9evXC1yuL9fX05+x37p1q8D6KSkpRY6Z6HljpzgieuHVq1cPAAx6p+stWLAAY8aMwZUrV1C1alU4OjoiOTlZ6ST3oOjoaIP2XFxcoFarkZiYiMzMTKP6hw8fLs7NICpRTOhE9MLr168fAGDevHnQ6XRKeXJyMj755BMsXLgQlSpVgkqlQt++faHT6bBw4UKDNvLz85Wy/v37AwAsLS3RrFkzZGVl4bfffjOov337dpw7d64kN4uoWPGSOxG98Pr164fvvvsOkZGRCAoKQq9evZCRkYHly5fj9u3bmDt3LmxtbQEAkydPxubNm/HFF1/g5s2bCA4Oxr179/DTTz9h9+7d6NKlC3r27Km0/fHHH6NTp0549913cfLkSfj7+yMmJgaLFy9Gr169sHr1auTk5Jhq04kKT4ioVGnSpIkAEJ1OZ9I4vL29pXz58s9tfZmZmTJ27FhxdnYWAGJhYSH+/v6ycuVKo7qJiYkycOBAKV++vAAQAFK9enWZMmWK5OTkGNVfuXKleHp6KnVr1qwp69evl1WrVomXl5d89913Jb59iYmJAkDCwsJKfF1knlQiIiY8niCip9S0aVMcOnQIOp3OpJ3ifHx8kJKSYpLpUVNTU2Fra/vI3uwPunXrFqytrWFnZ/fEunfu3IGlpWWBc8OXtKtXr6JKlSoICwvDhg0bnvv6qfTjJXciKnUcHBwKXdfJyanQdStUqFCUcIheCOwUR0REZAaY0ImIiMwAEzoREZEZYEInIiIyA0zoREREZoC93ImoyPLz8xETE2PqMMzCo+afJyosJnQiKrK7d+/Cx8fH1GEQEZjQiaiIOnfuXOADUOjZBAYGmjoEKqWY0ImoSGbPnm3qEIjoAewUR0REZAaY0ImIiMwAEzoREZEZYEInIiIyA0zoREREZoC93ImoSCZMmMDJUEpAgwYN8M4775g6DCqFmNCJqEjCw8M5S1wJCAsLY0KnImFCJ6Iis7Ozw549e0wdhllISUlBu3btTB0GlWJM6ERUZBYWFqhfv76pwzALV69eNXUIVMqxUxwREZEZYEInIiIyA0zoREREZoAJnYiIyAwwoRMREZkBJnQiIiIzwIRORPQISUlJOHr0KG7evGnqUIieiAmdiOgRFi9ejMDAQGzYsMHUoRA9ERM6ERGRGWBCJyIiMgOc+pWISg0RQUxMDLKyslC1alVUqFABeXl5iI+Ph62tLVxdXY3ek56ejitXrsDOzg5Vq1aFWq0usG2tVouLFy9CrVbDy8sL1tbWJb05RMWKZ+hEVCrs2bMHPj4+8PX1Rf369eHs7Iy33noLJ0+eRI0aNfDmm28a1L9x4wb69euHihUrol69evDy8oKLiwtmz55t1PbChQvh4uKCunXrwt/fH25ubpg/f/7z2jSiYsEzdCJ64V27dg2dO3dGZmYmPv/8c4SGhuL27duYNWsWRo0aBQCwsrJS6mu1WrRr1w4nTpzA8OHDERISgnv37mHOnDn44IMPkJWVhQkTJgAANm7ciJEjR8LNzQ3z5s2Dv78/zp07h0mTJsHR0dEk20tUFEzoRKVUu3btoFKpTLb+pKQkaDTP5ydkwYIFSEtLwzvvvKMkYgAICQlBzZo1ARgm9GXLliE6OhpvvfUWFi5cqJR37twZXl5emD59Ot577z3Y2tpi+vTpyjq6desGAGjUqBEaN26MWrVqPY/NIyoWTOhEpVRkZKSpQ0C5cuWey3r0z1zv27evQbmVlRUGDhyIyZMnG9wbX7t2LQDgjTfeMKjv5OSEzZs3Q0QAAHl5eTh48CDKlSuHjh07GtT19fVFq1at8NdffxX35hCVCCZ0olLq5s2bsLAwXTeYwMDA5zbhSlJSEgDAy8vLaJmfn59R2ZkzZwAANWrUMFrWsmVL5d+JiYnQ6XSoXLmywRm+no+PDxM6lRpM6ESllIODg0kT+vNc9/Xr1wGgwHvaTk5ORmXp6emPrF9Quw4ODgUur1ix4lPFSWRK7OVORC+8smXLAgAyMzONlqWmphqV6YecZWRkFKrde/fuFbi8oLaJXlRM6ET0wnNzcwMApKSkGC2Lj483KqtWrRoAICEhwWjZjRs3cOfOnSe2+6j3E72omNCJ6IXn6+sLANi2bZvRsvDwcKOy4ODgRy5r3749HBwcEBsbC3t7e7i4uODatWs4efKkQb3U1FRERUUVR/hEzwUTOhG98F599VUAwNdff40TJ04AuD/WfMqUKbhy5YpR/XfeeQdlypTBN998gz///FOp/+mnn+L48eNo06aN0mFuwIABAICxY8cqZ+q3bt3C0KFDYW9vDwDQ6XQlu4FExYAJnYheeJ06dcKbb76JhIQEBAQEoGLFiqhQoQIWLVqEGTNmGNWvUaMGVq1aBQB45ZVXUK5cOdjZ2eGzzz5D/fr1lWUAMHHiRDRo0ADbt2+Hi4sL3Nzc4Orqips3b+K///0vgPsHA0QvOvZyJ6JSYcmSJejfvz+ioqJw9+5d+Pn5oXfv3jh16lSB9bt164aYmBisX78e58+fR/ny5REQEIAuXboY9NCvUKECDhw4gDVr1uDo0aOwtLREYGAgwsLCEBcXB3t7ezRv3vx5bSZRkTGhE1GpERwcrNwfLwz9fO9PYmVlhf79+6N///4G5b6+vsr9e6IXHS+5ExERmQEmdCIiIjPAhE5EpVqZMmXg5eUFZ2dnU4dCZFK8h05EpVrTpk0RGxtr6jCITI5n6ERERGaACZ2IiMgM8JI7ERVZVlaW0VAvKpqsrCxTh0ClHBM6ERVZbm4ufv31V1OHQURgQieiIoqIiEBOTo6pwzA7dnZ2pg6BSikmdCIqEv0jSonoxcBOcURERGaACZ2IiMgMMKETERGZASZ0IiIiM8CETkRFsm/fPmRkZEBEEBERgcOHDwMAEhISEBERgWvXrgEA9u/fj507dwIAbt++jYiICMTExAAATp06hYiICGRlZSEnJwcRERGIjo4GAFy6dAkRERG4efMmAGD37t3Ys2cPACAlJQURERG4fPkyAODYsWOIiIhAXl4e7t27h4iICJw+fRoAcOHCBURERODOnTsAgKioKBw4cAAAkJSUhIiICCQmJgIADh06hIiICABAeno6IiIicO7cOQDAP//8g4iICNy9exf5+fmIiIjAkSNHAADx8fGIiIhAcnKy8tn89ddfAIBbt24hIiJCmZ725MmTiIiIgFarhVarRUREBE6cOAEAiI2NVf5N9NSEiEqVJk2aCADR6XQmjcPX11eioqIkJydHAEiLFi1EROSbb74RAPLjjz+KiEjNmjWlXLlyIiISGRkpAGTcuHEiItK7d28BIHFxcZKSkiIApGPHjiIiMmnSJAEgGzduFBERV1dX8fDwEBGRNWvWCAD54osvREQkNDRUAEhqaqpcuHBBAMiAAQNEROT9998XAPL333+LiIi1tbXUrVtXRESWL18uAGTBggUiIhIYGCgqlUpERA4ePCgAZOTIkSIiMnjwYAEgp06dknv37gkAad26tYiIzJo1SwDIqlWrRETE29tbHBwcRERk27ZtAkA+/vhjERHp3r27AJCEhARJSkoSABIWFiZZWVny3//+V7p27VqcXxP9i6gnTZo06fkeQhDRs1i2bBmuXr2KTz/9FCqVymRxzJ8/H+vWrcPo0aOh1WrRunVrNG7cGDqdDpUqVUJISAjc3Nyg1WrRsGFDBAcHIz8/H2XKlEFQUBB8fHyQk5MDHx8ftG3bFjY2NtDpdGjdujUaNGgAnU4HNzc3hISEoGLFitBqtWjSpAlatWoFnU6H8uXLIzg4GNWrV0dOTg78/f3Rtm1bqNVqWFhYICgoCHXq1EFubi6qVq2KkJAQVKhQAdnZ2XjppZfQrFkz6HQ6ODo6Ijg4GFWqVEFOTg7q1auH0NBQ5Ofnw8rKCkFBQahZsyZyc3Ph5eWFtm3bomzZssjJyUHr1q0RGBiIvLw8ODs7IyQkBK6urtBqtWjUqBHatGmD/Px82NraIigoCN7e3sjJyYGvry/atm0La2tr5Ofno3Xr1nB3d8eAAQPg4+ODfv36mex7pdJLJSJi6iCIqPCaNm2KQ4cOQafTwcLCdHfN9u3bh5ycHLRp08ZkMZgTnU6HK1euwNbWFq6urqYOh0ohTixDREXSokULU4dgVlQqFRwcHGBpaWnqUKiUYqc4IiqSxo0bo3r16qYOw2wkJyfD0dERr732mqlDoVKKZ+hEVCT29vbIzc01dRhmw9raGqGhoahfv76pQ6FSivfQiUqZF+UeOhG9WPhrQERF8ueff2L9+vWmDsNs3L17FzNmzMDatWtNHQqVUjxDJyplXpQzdD8/P1y/fl2ZsIWeTVJSEipXroyuXbvyQImKhPfQiahIxowZg8zMTFOHYTYcHBzw+++/w93d3dShUCnFM3SiUuZFOUMnohcLfw2IqEgGDx6Mbt26mToMs6Eftvbqq6+aOhQqpXjJnYiKZN++fbh+/bqpwzAbFhYWcHBwgJ2dnalDoVKKCZ2IiuTw4cPIz883dRhmw9nZWXkiG1FR8JI7ERVJQkKC8vjSkrR27VqEhYWhVq1aaNy4Md566y1cvHjRqF52djbmzZuH0NBQ+Pn5oXbt2ujevTtWr16Nh7sKTZs2DX369EFaWho2bdqE0NBQ+Pr6Ijg4GGvWrAEApKam4v3330f9+vXRoEEDDB48GAkJCSW2nVlZWQgPD8fevXtLbB1k5kz2nDciKhL941NfhFf58uVLdFs/+OADASDu7u7Su3dv6dy5s1haWoqNjY3yOFQRkczMTGnWrJkAkAYNGsgHH3wgb7/9tlSrVk0AyPDhww3a7dq1qwCQ2bNnS8WKFaVv374SFhYmarVaLCwsZNu2bVKvXj0JDAyUQYMGib+/vwCQOnXqSH5+fols69WrVwUAH59KRcZL7kSlVKNGjUy6/qSkJPTo0aPE2t+5cye+/vprNG/eHFFRUbCxsQFw/95969atMWjQIMTExEClUmHq1Kk4cOAABg4ciO+//155rOyMGTPQtGlTLF68GD179sTLL78M4P40qwAwd+5cHD16FFWrVgUAzJkzB++//z569eqFwYMHY86cOVCpVMjJyUHdunVx+vRpnD59GnXr1i327S1fvjymT58OHx+fYm+b/h2Y0IlKqUOHDpn1sLVly5YBAN5//30lmQP3n/I2fvx4pKen4+bNm6hUqRJWrFgBlUqF//3vfwbPiC9btizeeecd/Oc//8HPP/+sJHT95zZkyBAlmQNA+/btAQBarRaTJk1S2rKyskJISAguXLiA+Pj4EknodnZ2GDduXLG3S/8eTOhEVCQTJ05Eeno65syZUyLtHzx4EMD9cfcPmzp1qvLv+Ph4JCcnw93dvcCzW/1jXo8dO2a07OEHoTg5OQEAPDw84ODgUOCy1NTUp9mMQrt16xb69euHFi1aYPLkySWyDjJv5nt4T0Ql6rfffsP3339fYu2npKQAACpWrPjYejdu3AAAuLi4FLjc2dkZAHDz5k2jZfokrac/c3d0dDSqq1arAcCog11x0Wq1iIiIwIkTJ0qkfTJ/PEMnoiJZu3ZtiT4+VZ84nzQ07kkJtqQScHFzdXXF7du3YWlpaepQqJRiQieiIqldu3aJtu/s7Iy7d+/i+vXrj51sRX9m/qhJbvRn+pUqVSr+IIuRiCA1NRW2tracXIaKhJfciahI/Pz8UKFChRJrv3HjxgDu93Z/2Lvvvot27dohLi4OHh4ecHd3x7Vr1wocn75nzx6D9l5U169fR40aNTBixAhTh0KlFBM6ERVJ7dq1ERAQUGLtDx48GAAwe/ZspKenK+XHjh3D0qVLcfLkSaWH+tChQyEimDFjhkEbGRkZmDdvHlQqldLei6pMmTLo3bu30omP6GnxkjsRFcnatWtLtP327dvjzTffxNKlS1GrVi20a9cOGRkZ2LRpE3Q6HX744Qelo9pHH32EHTt2YPny5Th//jzatm2LO3fuYN26dYiPj8f48ePRsmXLEo33Wekfn0pUVDxDJ6IiKele7gCwePFi/Pjjj/D390dERATOnj2Lnj174vjx48qYceD+2W1UVBRmzpyJ/Px8LF26FBs3bkSDBg2wadMmTJs2zaDdOnXqIDQ01OiWgaWlJUJDQ9GkSROjWLy8vBAaGgo3N7cS2db09HSMHz8eP/74Y4m0T+aPz0MnKmVelOeh+/n54fr167hz547JYjAnSUlJqFy5Mrp27Yr169ebOhwqhXjJnYiK5LPPPkNWVpapwzAbTk5O2LFjxwvfG59eXDxDJyplXpQzdCJ6sfDXgIiKpEePHmjTpo2pwzAbycnJcHR0xKuvvmrqUKiU4iV3IiqSM2fOPHIyF3p6FhYWcHBw4KQyVGRM6ERUJOfPnzd1CGbF2dkZsbGxpg6DSjFecieiIjlz5gyio6NNHYbZyMrKQnh4OPbu3WvqUKiUYkInoiJ58B56dHQ0wsPDcevWLQDA6tWrsWPHDgDApUuXEB4ejkuXLgEAduzYgdWrVwO4/8jQ8PBwHD9+HMD9Z7yHh4cjPT0deXl5CA8Px19//QXg/hWB8PBwJCQkAAC2bNmCP/74A8D9+8/h4eE4c+YMAGDv3r0IDw9Hdna2kij37dsHADh9+jTCw8OV2wUbNmzA1q1bAdx/FGt4eDguXLgA4P60s+Hh4dDpdEhLS0N4eDgOHz4M4P6MdeHh4bh9+zYAIDw8HBEREQCA2NhYhIeHIy4uDgCwfft2ZSKemzdvIjw8XHmq2sGDB5Xt6tOnD2bOnFks3w/9CwkRlSpNmjQRAKLT6UwaxyeffCINGzYUEZFRo0YJANm3b5+IiGg0GgkICBARkSVLlggAWbx4sYiINGjQQDQajYiI7Nu3TwDIu+++KyIiAwcOFADyzz//SEZGhgCQ4OBgERGZMWOGAJDffvtNREQ8PT2lYsWKIiKyZcsWASATJ04UEZGwsDABIElJSZKQkCAApHv37iIiMmHCBAEg27dvFxERBwcH8fb2FhGRVatWCQCZNWuWiIi0atVKAEhWVpacOnVKAMjgwYNFRGTkyJECQA4dOiQiIgAkMDBQREQWLFggAGT58uUiIlK3bl2xsbEREZHdu3cLAHn//fdFRGTAgAECQI4dOybTp0+XNWvWFM8XRP866kmTJk16vocQRPQsli1bhqtXr+LTTz+FSqUyWRzBwcGoXr06vL29YWlpidq1a6N169YoV64cypQpg+DgYDRo0AAajQbVq1dHmzZt4OrqCmtrazRv3hwvvfQS1Go1nJ2dERwcDC8vL1hZWaFevXpo1aqV8tSxkJAQ1K1bFxqNBt7e3ggKCkLFihVhbW2Nli1bomnTplCr1XB3d0ebNm1QtWpVWFlZoWHDhmjZsiWsra1hb2+PkJAQ1KpVC5aWlqhZsyZat26NChUqwMbGBkFBQWjUqBE0Gg08PDzQpk0bVK5cGVZWVmjSpAlatmwJjUYDJycnBAcHw8fHB5aWlqhTpw5atWqlbHNISAgCAgKg0Wjg6emJoKAguLi4wNraGi1atECLFi2gVqvh4uKC4OBgeHp6wsrKCvXr10fbtm0RGhqKWrVqmew7pdKN49CJShmOQyeigvDXgIiIyAwwoRMREZkBJnQiIiIzwIRORERkBpjQiYiIzACnfiWiIunRowfi4+NNHYbZCQoKwqxZs0wdBpVCTOhEVCSnTp1CTEyMqcMwO5UrVzZ1CFRKMaETUZGVL18eaWlppg7DLFy9ehVVqlQxdRhUivEeOhERkRlgQiciIjIDTOhERERmgAmdiIjIDDChExERmQEmdCIiIjPAhE5ERGQGmNCJ6Ln4/fffsWTJEuTl5QEAcnNzsWTJEvz+++8mjozIPHBiGSJ6LiZOnIjz58/j1VdfhUajgVarxfDhw+Hn54c+ffoUud1Ro0ZBq9UWuMzR0REtWrRAhw4dYGlpWeR1EJUGTOhEVKwyMjLQo0cPTJ8+HY0aNVLKP/vsM9y5cwfW1tbFur7vvvsOmZmZj63j5+eHtWvXwt/fv1jXrZefn4/OnTtjzJgxCAkJKZF1ED0JL7kTUbE6cuQIIiIicOvWLYPyPn364K233oJGUzLnEenp6RAR5XXv3j0cPXoU3bp1w/nz59GlSxdkZ2eXyLrPnDmDrVu34tq1ayXSPlFh8AydiIpNdHQ0/vjjDwDAxYsX4eTkhOrVq8PJyQlnzpxBdnY2GjRoAAuLJ59LXL58GYcPH8bdu3fh7u6Oli1bomzZsoWOpUyZMmjYsCF+//13BAQE4J9//sG2bdvQtWtXg3rXr1/HsWPHcOPGDVSqVAn+/v6oVq2aUXsnTpyAWq1GnTp1EBsbi3379qFZs2bIycnB2rVrAQBxcXE4evQoqlSpAhcXF+W9Z8+exaVLl6DVauHi4oLAwMBiv1JBBCGiUqVJkyYCQHQ6nUnj8Pb2lvLlyxuUOTg4CACD14oVK0RExM/PTwDI3bt3RUQkIyNDAIifn59BG3fu3JGePXsatWNvby9Lly41iqNs2bICQNLT0x8Z68iRIwWATJ8+XSnLy8uT//znP2JlZWWwHpVKJf3795fs7GyDNipVqiTVqlWTqKgosbS0FAAya9Ys8fX1NYr1yy+/FBGR48ePS+PGjY2WOzo6yrJlywzaT0xMFAASFhb2hE+eqGC85E5ExSYqKgphYWEAgPnz5+PIkSPo0qVLod8vIujZsyfWrFmDwYMH4+LFi0hLS8OOHTvg4uKCN998U7kC8DTu3bsHALCxsVHKpk2bhoULF6JVq1Y4duwYbt++jWPHjiEoKAi//PILPv/8c4M2rKyskJWVhY8//hgDBgzAihUr0LZtW6xduxaDBg0CAEyZMgVHjhzBwIEDkZ+fj169euHEiRNYtGgRLl++jKSkJPz5559wc3PDm2++icOHDz/1thA9Ci+5E1GxCQgIQMWKFQEAPj4+Bp3iCmPbtm2IjIxEUFAQvvvuO6U8NDQUv/32Gxo1aoRJkyYpBw2FkZqaim3btgEAXnrpJaU8OTkZDRo0wMKFC+Hj4wMAcHBwwKJFi1CzZk2Eh4fjs88+U+pbWlri2rVr6NixI1asWGGwDldXVwCAp6enss2XL19GbGws2rRpg+HDhyt13dzcULVqVSxduhS5ubmF3g6iJ2FCJ6IXxqZNmwBAOeN9UEBAAGrWrInjx4/j+vXrBveogfv3721tbZX/5+Tk4Ny5c/jqq69w7do19OjRA4GBgcry+fPnFxiDj48PNBoNkpOTDcpVKhXy8/MxbNiwQm1LhQoVoNFocPz4cURHRyMgIEBZVqtWLXz99deFaoeosJjQieiFceHCBQDAjh07cP78eaPl+jPa8+fPGyX01q1bF9imRqPBsGHDMGfOnALXt3HjRly6dAlXrlxRxrPn5+cjPz+/wPa8vb0LtS0VKlTAhx9+iC+++AKNGjVCo0aN0KlTJ3Tv3h316tUrVBtET4MJnaiU+vLLL6FSqUy2/tTU1GJvUz+efPPmzVCr1QXWcXBwQFZWllH5N998Y3CPHAAqVqyI5s2bw83Nzaj+7Nmz8eGHH0KlUqFZs2aoUqUKypUrBwDYuXPnI2N0cHAo9PZ8/vnnaNWqFX788Uds2LABhw8fxqRJk+Dj44MvvvgCvXr1KnRbRE/ChE5Uyrz99ts4f/48PvroI1OHoiTA4mJnZwcAWLNmDUJDQ5/qvYMHDy50PDExMRg7dizs7e3x999/G0w4IyJG98gf9LQHUR06dECHDh1w79497N69Gxs2bMD333+P3r17Y8OGDU/VH4DocZjQiUqZgQMHwtHRscCz1Odp1KhRSu/x4lKzZk1s374dMTExT53Qn8bu3buh0+nQt29fo9njzp07h9zcXJQpU6ZY12lra6sk97CwMHTs2BE//PADEzoVGyZ0olKoc+fOpg4BEyZMeGxC1z+E5Wl07twZc+fOxZIlSzB8+HCDs+H8/HyMHDkSAQEBGDFiRJFi1tNP6lLQBDeTJk0CAGi1Wuh0ukde+i/Ig9u8bds2LFiwABMnTjTq7e/r6wsAuHv37tOGTvRIHIdORMVK31ktPDwcp06dQkxMTKHfGxoaipCQEBw/fhxvvPEGYmJikJmZiejoaPTu3RuLFy9GbGzsM8fYpEkTqNVqrFq1Crt27UJGRgaOHTuG3r17IycnB7Vr14ZWq8WhQ4ce2TnuQfptXr9+PU6dOoVz587B2dkZmzZtQt++ffHHH38gOTkZt27dwuHDhzFy5EgA4Nk5FS9Tz2xDRKVTQTPFiYicPHlSmb0NgLz33nsi8vQzxalUKoPZ1aytrWX06NGSm5trUL8wM8UVZPLkyUbr6Nixo9y5c0emTZumlL3Kyl9wAAAgAElEQVTxxhsiIuLp6SkAJCcnx6itK1euGMySN2DAABERWbVqlVSqVMlopjgrKysZP368wWx/nCmOnpVKROS5HkEQkVnw8fFBSkoK0tLSjJZdvXoVhw8fRoUKFVC7dm1UqlTJaC73/Px8HD9+HDY2Nqhdu7ZRG5cvX8aRI0eQnp4OFxcXNGvWDE5OTkb1jh8/jvz8fAQEBDzV5XHgfue46OhoaLVaBAQEGMRx4sQJpKamwsfHB5UrV8bp06eh1WrRsGHDAjvGpaSkYP/+/bCzs0OtWrXg7u4O4P5QuwMHDiAxMRG5ubmoWrUq6tWrB0dHR6PPrEqVKggLC8OGDRueajuIAIAJnYiK5HEJnZ4eEzo9K95DJyIiMgNM6ERERGaACZ2IiMgMMKETERGZASZ0IiIiM8CETkREZAY49SsRFdndu3cLHEP+ohMR5Ofnw8LCwqRPrHtQUabKJXoQEzoRFYmNjQ2srKxw6dIlU4fy1PLy8pCXlwdLS8unnoymJNnY2CjzzBM9LU4sQ0T/OjP+H3t3Hp/jlT5+/JNEyB5BpBJ7RELsQZQqWnurnZbU3uqIZfQ78msRt+qMVjEeaq0qakkbS+fRNJainSCYKmnFHnti31KRiEiIxPX7w9fznQyd0ibPMx7X+/Xyh/s+Oec68cfl3Pe5r2MyYRgGZrOZiIgIW4ejVLHQd+hKKaWUHdCErpRSStkBTehKKaWUHdBNcUopVQwuXLhg6xDskoeHB15eXrYO47GgCV0ppYpBQECArUOwSyNGjOCjjz6ydRiPBU3oSilVTLy9vXn22WdtHYZdyMjI4IcffrB1GI8VTehKKVVMatWqxZo1a2wdhl3YsmUL7dq1s3UYjxXdFKeUUkrZAU3oSimllB3QhK6UUkrZAU3oSimllB3QhK6UUkrZAU3oSimllB3QhK6UUkrZAU3oSin1X+KDDz6gQ4cOHD161HKtX79+dOjQgcLCQhtGph4HWlhGKaVsIDs7m9KlS+Pi4mK5tn//fjZu3Mi1a9cs17Zv386pU6cQkd88Vvv27dm9e/cD71WoUIFGjRoxaNAgOnTo8JvHeBjXr1+nVKlSuLq6lug4TypdoSullJWJCNWrV+fTTz8tcv3zzz/n6tWrNGnSpFjHu379OpmZmTRu3Jj27dtb/rRq1QonJydWrlxJx44dMQyjWMf9d2FhYUyYMKFEx3iS6QpdKaWs7OjRo2RmZt533cPDo0THnThxIi1atLjv+qZNm+jWrRsmk4mXXnqJli1bFvvYGRkZnDhxotj7Vf9HE7pSSlnRsmXL+PbbbwHYvHkz+fn5NG/enHbt2hEfH8+xY8d4/fXXqVSp0n/s59atW6xYsYJt27Zx7do1fHx8aNu2LT179sTZ2fmRYnr++ecZOnQoM2bM4Ouvvy6S0AsLC1m7di2JiYlcuHABLy8vgoKC6NOnD1WrVi3Sz/Llyzl79iwjR44kLi6OVatW0a5dOypUqMB3332HiLBjxw5MJhP169ena9eujxSn+s80oSullBWtXbuWjRs3ArBjxw4OHTqEiNCuXTuWLl3K119/Tbt27f5jQj9z5gydOnXiyJEjVK9enVq1arFr1y4WLVrE9OnT+e677/D19X2kuOrUqQPApUuXLNdyc3Pp0qUL27Zt46mnniIoKIiUlBQWL17MxIkTWbduXZHT5RYtWsTmzZupWbMmvXr1QkRwdXWlTJkyxMfHA7Bnzx5Onz5N9+7dNaEXM32HrpRSVvTll18yZswYAMaOHUtqauojv7vu3bs3R44cwWQykZaWRkJCAidPnmTs2LHs2bOHP//5z48c15kzZwCoWLGi5donn3zCtm3b6NWrF2fOnGHbtm0cOnSIpUuXkpOTw/Dhw4v0Ubp0aQD+9re/MWfOHNLT05k2bRpz585l6tSpAAwbNozU1FSmTJnyyDGq/0wTulJKPUZ++OEHfvjhB1q3bk10dDQODg4AODo68sEHH1C7dm2++uqrIivtX3P69GnmzZsHwMsvv2y53qBBAyZMmMC4ceOKPMbv27cvTz31FPv27SuyI79UqbsPfevVq8ewYcPw9fWlbNmyv2u+6uHpI3ellHqMbN26Fbj7Kdq/c3Jyok2bNhw7dowdO3bwyiuvFLkfGxtr+Xm4+0j9+PHjrF69mtzcXCIjI2nTpo3lfqdOnejUqVORPm7fvk1OTg4VK1bk0qVLZGdn4+3tXaTNSy+99LvnqR6dJnSllHqMnDt3DoCPP/6Yzz///L7793bPnz179r57c+fOve+ag4MDoaGhDB8+nMjIyCL3RISlS5eydOlSjh8/ztmzZykoKPjVGP39/R9qLqp4aUJXSj2xPvzwQxYsWGDrMB7JvYpxdevWJSQk5BfbBQUF3XctLi6ORo0aWf7u7OxM+fLlcXNze2AfI0eOZPr06VSrVo2BAwdSq1YtPDw8cHV1ZdiwYRw/fvyBP/dL/amSpQldKfXEOnDgAAcOHLB1GI+kfPnyAHTu3Nmyue5h+fv7U7NmzYdqm56ezqxZs/Dx8eGnn366b9e8o6NuwfpvowldKfXEWrJkSZFNYL9HuXLliqWfX9O4cWOAXyzlWlhYiJOT0+8e59ixYxQWFhIeHn5fMj9z5owWifkvpAldKfXEcnd3x8fHx+rj3tsxnpOT88g/27VrV8qVK0d8fDwHDhygfv36lnu5ubk8++yzuLi4sHHjxiJ14h/VU089BdxN3iJi2U1/8+ZNBg8ejLu7O9nZ2fz8889UqVLlV/u7N+fr16//5pjUf6YJXSmlrOze++358+cD4Ovry9ChQx/qZ93c3Jg7dy59+/alXbt2DBw4kHr16nHp0iViYmI4dOgQ48eP/13JHKBmzZo0adKE3bt306dPH7p27crFixdZsmQJ4eHh9O7dm/nz5/Pxxx/zxhtv0LZt2//YX61atYC7lfLKlSuHl5cX77zzzu+KURWlL0GUUsrKOnXqRO/evUlPT2fy5Mn8+OOPAPj5+VGzZk3KlCljaVu1alVq1qxpWSED9OzZk3/84x/Ur1+f6dOn8/rrr/Puu+/i5uZGbGwsf/nLX4qMFxAQQM2aNR8pyTs6OrJ8+XJat27N119/zeuvv8706dOJiIhg4cKFvP322zRs2JCVK1cya9Ys4O6q/t/jv6dZs2a89dZb3LhxA5PJxLZt2x7pd6Z+nYP8njP5lFLqMWQymTAMA7PZTERERLH06eDgQFhYGLt27XronykoKLAUY/mtCgsLLd+Cl9RGtYKCAm7evFksh8cUFhbi6OhY5D8oD7JlyxbatWvHiBEj+Oijj373uE8CfeSulFI28nuTOdwtJlPS+wBKlSpVbCfBFceGPfVg+shdKaWUsgOa0JVSSik7oAldKaWUsgOa0JVSSik7oAldKaWUsgO6y10ppYrJrVu3tCRqMTl//rytQ3jsaEJXSqlicvDgwQeecqaUNWhCV0qpYtCzZ09bh/Cb/fTTT6SlpdGpUyfKli1r63CKuHcYjfp1mtCVUqoYfPnll7YO4TeLjIwkLS0Nk8lEw4YNbR2O+o10U5xSSillBzShK6WUUnZAE7pSSillB/QdulJKKavZuXMne/futXUYdsfR0VETulJKKev56quvmDZtmq3DsDtOTk6a0JVSSlnfyJEjCQ4OtnUYdmH8+PFcuHBBE7pSSinre+GFF2jbtq2tw7ALc+bM4cKFC7opTimllLIHmtCVUkopO6AJXSmllLIDmtCVUkopO6AJXSmllLIDmtCVUkopO6AJXSmllLIDmtCVUkopO6AJXSmllPqdkpOT+f77720ag1aKU0oppX6nUaNG4ebmxjfffGOzGHSFrpRSSv0Od+7cITk52dZhaEJXSin1ZDh16hT/8z//Q926dfHw8KBixYo0b96c2bNnU1hYWKTtnTt3mDt3Lk2bNsXV1RVHR0eqVKlCZGQkp0+ftrRbsGABjRs3Jjs7m++//56mTZvSt29fa08N0EfuSimlngCXLl2iadOm5OTk0LNnT/r3709eXh7r1q0jKiqKAwcO8Nlnn1naDxw4kJiYGBo0aMD48ePx9PQkKSmJmJgY1q5dy86dO6lRowaVKlUiKCiI/fv34+3tTVhYGFWqVLHJHDWhK6WUsntms5mMjAz+9re/YRiG5fq4cePo2rUrCQkJXLt2DW9vbxISEoiJiSE0NJSkpCRcXFwAGDp0KHXr1iU6OpoxY8bw5Zdf0q1bN6pWrUpcXBz169dn/vz5tpqiPnJXSill/27cuAHArVu3ilx3cnLiu+++49SpU3h7ewOwYsUKAN566y1LMr9n0KBBuLi4sHr1avLz860Q+cPThK6UUsruvfjii5QuXZrx48fz5ptvsnr1akuS/3d79uwBoGnTpvfdK1u2LNWrV+fmzZscP368RGN+VPrIXSmlFADZ2dlkZmaW6Bg3b94s0f5/Sf369Vm7di2GYRATE0NMTAyurq506tSJvn370qNHD0vbq1evAlCxYsUH9uXr68uRI0cs7f5baEJXSikFwLPPPmvrEEpUx44d6dixI4cPHyYuLo5//OMfrFmzhlWrVtGnTx+WLVsGQKlSd1PjLz1Sv3fdycnJOoE/JE3oSimlAAgPD8fT07NExzh+/HiRz75soU6dOrz33nu89957pKam0q1bN5YvX86wYcNo1aoVlSpVIi0tjUuXLhEUFHTfz1+6dAkAf39/a4f+H2lCV0opBcD8+fNp2LBhiY4xcuRIpk2bVqJjPMjevXs5f/48L7zwQpHrgYGB9O/fn3fffZejR4/SqlUrnnnmGbZv3853331H69ati7Q/evQoZ86cwd/fn2rVqhW5JyIlPo//RDfFKaWUsnvvvvsuL7/8Mt9++22R67du3bJcq1OnDgCRkZGUKVOGBQsWkJaWZml7+/Zt3nvvPUSEYcOG4eDgAIC7uzsAZ86csWlS1xW6UkopuzdlyhR2795Nly5daNiwIdWrV+fWrVv89NNPZGRkEBkZydNPPw1ArVq1mD9/PpGRkTRo0IDnn38ed3d3tm/fzpkzZ3jppZeIjo629F2tWjUCAgI4ePAgwcHBlCpVikOHDll9jprQlVJK2b169eqxf/9+li5dyk8//cTFixfx9PSkV69e9O3b15LM73njjTdo2rQpixcvJiUlhWvXrtGuXTteffVVunXrZlmdAzg7O7N27VqmT59OTk4ONWvWtPb0AE3oSimlnhAVK1bknXfeeej2oaGhD/2+v3HjxsTGxv7W0IqFvkNXSiml7IAmdKWUUsoOaEJXSiml7IAmdKWUUsoOaEJXSiml7IAmdKWUUsoO6GdrSimlrG7lypXs3r3b1mHYhZ9//hnQhK6UUsoG5s6da+sQ7IqTk5MmdKWUUtbTt29fmjRpYusw7I6jo6MmdKWUUtbTuHFjGjdubOsw7JJuilNKKaXsgCZ0pZRSyg5oQldKKaXsgCZ0pZRSyg5oQldKKaXsgCZ0pZRSVpOYmMj27duBu8VlTCYTubm5ZGdnYzKZWLVqFQBbtmzBZDJx+vRpAGbMmMHChQsBSElJwWQysWvXLgCWLl2KyWTizp07pKenYzKZ2LBhAwDfffcdJpOJy5cvIyKYTCbLueXJycmYTCYOHjwIwKJFi5g+fToAZ86cwWQykZiYCMDq1asxmUxkZWWRl5eHyWTCbDYD8MMPP2AymThx4gQAn3zyieU7++PHj2MymdixYwcAZrMZk8nEzZs3ycrKwmQysWbNGgA2b96MyWTi7NmzAEybNo1FixYBcODAAUwmk6UYzxdffIHJZALg0qVLTJ06FUQppZ4wkydPFkDMZrOtQ/mvMHDgQAFk7969JT7WqFGjZOTIkXL27Fnp2rWrAJKeni6nTp0SQHr06CEiIqNHjxZANm3aJCIinp6eEhISIiIisbGxAsjMmTNFRKRly5YCSH5+vuzZs0cAiYyMFBGRIUOGCCDJyclSUFAggLRo0UJERGbPni2AxMTEiIhI3bp1xd3dXUREEhMTBZBRo0aJiMhrr70mgKSmpsqVK1cEkM6dO4uIyPjx4wWQ1atXi4iIv7+/BAQEiIhIfHy8ADJhwgQREenYsaMAcvXqVTlx4oQA0qtXLxERGTFihACydetWERFxdXWVevXqiYjIkiVLBJA5c+aIiEjz5s0FkDt37sgXX3whzs7Oot+hK6WUsqqZM2fywgsvMGbMGAYMGICXlxfu7u6YzWYqV64M3C1AExYWRr169QD4/PPPcXV1BaB169aYzWYaNWoEwIcffkhGRgZOTk5Ur14ds9lMjRo1ABg0aBDPP/88NWrUwNHREbPZTPny5QHo0qULZrOZZs2aATB9+nRyc3MBCA0NxWw2ExwcDMDbb79Njx498PPzw9nZGbPZzFNPPQVA9+7dCQkJoWnTpgDMnz/fMtdmzZphNpst8xg7diyRkZG4u7tb+qlSpQoA/fv3Jzw8nDp16gB3nzx4eHgA0LZtW8xms+Ub/kmTJnH16lUcHBxYuHAhPj4+OIiIFOO/k1JK/dczmUwYhoHZbCYiIsLW4dhcZGQkixYtYu/evTRs2LBEx8rLy+PmzZt4enpSqpSuKYuT/jaVUkpZTV5eHllZWbi4uGhCLyZJSUnk5OTopjillFLWM3nyZAIDA0lKSrJ1KHZj6NChdOnSRVfoSimlrKdBgwZERETg6+tr61DsxoABA0hPT9eErpRSynr69etHv379bB2GXYmKigL0HbpSSikrWr9+Pdu2bWPw4MHUrFnT1uHYhejoaM6ePavv0JVSSlnPvYIxZ86csXUodiMhIYG4uDhdoSullLKeQYMG0bFjxxL/PM6Wbt26xfnz53F3d8fPz6/Ex1u7di23b9/WFbpSSinrCQoKon379vj4+Ng6lBKzb98+AgMD+dOf/mSV8by8vChbtqwmdKWUUtYzbtw4ypUrx/fff2/rUOxGmzZt8PPz00fuSimlrMfV1RUfHx+cnZ1tHYrdCA8P56mnntKErpRSynoMw8AwDJuMfevWLQoLC3Fzc/vVtnl5edy6dYuyZcv+atv8/Hxu3bqFp6dncYT5yObNmwfo8alKKaWsaP/+/axcuZKff/7ZamN++eWXNGrUCBcXF9zd3QkICOCDDz4gLy+vSLv8/HwmTJhAzZo1cXNzw8fHB09PT3r06MGRI0fu6zc1NZUuXbrg5uaGl5cXvr6+vP/++xQWFlpragAsWbKEqVOn6gpdKaWU9SxdupSpU6eSmJhI27ZtS3y8OXPm8Oc//5ng4GDeffddKlSowJo1a3j//ffZu3cvcXFxODo6IiK89tprrF69mtatWzN27Fg8PDzYuXMnc+fOZdOmTSQlJVG7dm0Abty4Qfv27Tl16hRvvPEGnTt35tq1ayxYsIAff/yxxOf1r2bPnk1KSoomdKWUUtbTpUsXypcvb5WiMj///DOjRo3C19eXpKQkvL29gbuV1dq2bcuqVavYsmULzz33HKtXr2b16tU0bdqUzZs3Ww6O6dmzJzVq1CAqKooxY8YQFxcHwOLFizl16hQ9evQgJibGMmb//v0JDQ0t8bn9q3nz5pGTk6MJXSml1F1xcXFWOTQlIiKCqlWrlvg4q1at4ubNm0RGRlqSOYCjoyMfffQRBw8etHwnbjabAXjrrbfuOwVuwIABjB49mnXr1pGfn0/p0qXZuHEjAK+//nqRtm5ubrz55puMGzeuJKdWRHh4OKClX5VSSv2vDz/80Crj1K9fn9jY2BIvLrNv3z4A6tate9+95s2b07x5c8vf9+/fD0CjRo3ua+vl5UXVqlU5duwYJ06coG7dupw/fx6A4ODg+9rXq1evWOJ/WG3atOHIkSOa0JVSSt31l7/8hcqVK5foGHFxcfzjH/8gMzOzRMcBuHr1KgAVKlT41bZZWVkAVKxY8YH3fX19OXbsmKXdpUuXAChXrtx9bX+pj5Li6elJ2bJlNaErpZS6q3v37iW+ah48eHCJ9v+v7n3rnpub+6tt7z1mv3nz5gPv3+ujTJkyRfrOz8+/r212dvajB/s7fPPNN4B+tqaUUsqKzp07R3JyMtevXy/xsQICAgC4cOHCr7a992Ti4sWLD7x/b0Xu7+8PQKVKlQAe+PndL/VRUu4dzqIJXSmllNXMnj2bpk2bkpycXOJjPfPMMwCsWbPmvnvTpk3Dw8OD2bNnA/Dss88C/7fa/Vd79uzh4sWLBAYGWhL5vV36W7duva/9g8YrSdHR0fTu3VsTulJKKesJDw9n8ODBlpVuSerYsSPBwcHs3LmThQsXWq4fOXKEadOmkZ+fT6dOnYC7p8C5ubmxYMECUlJSLG1zcnIYM2YMcPdzt3u6d+8OwMcff8zly5ct11etWsU///lPAKsVmBk+fDgTJ04EUUqpJ8zkyZMFELPZbOtQ/isMHDhQANm7d6+tQyl2e/fuFT8/PwGkatWqEhoaKk5OTuLs7CwLFy4s0tZsNouLi4uULl1ann32WencubOUK1dOAHnzzTelsLDQ0vbOnTvy8ssvCyDOzs4SFhYmQUFB4ubmJosXLxZAOnfubNW56qY4pZRSVnNvl/uIESMsVddKUsOGDTl8+DAxMTHs2rWL/Px8Xn75Zd544437xo+IiKBZs2bExsaSkpLCrVu3eOONN3j11Vctj+/vcXBwIC4ujmXLlrFx40auX79O7dq1GTBgAFWqVOHo0aMEBgaW+PwAhg4dyunTp3WXu1JKKetJSkpiwYIF9O7d2yoJHcDHx4e33377odpWr16dv/zlLw/V1snJiddff/2+4jIAkydPfqQYf4+kpCRSUlL0HbpSSinrGT58OLt27SIsLMzWodiNrVu3cvnyZV2hK6WUsp7KlSuXePGaJ012dja3b9/WFbpSSinriY6OxsHBgS1bttg6FLvRrVs3goODdYWulFLKegICAggLC8PT09PWodiNDh06EBISogldKaWU9URFRRX5nlv9flOmTAH0tDWllFJWlJSUxL59+3jxxRetUlzmSTBr1izS09P1HbpSSinriYuLY8iQIRw7doyTJ09iGAbr1q0DYMWKFRiGQUZGBrm5uRiGwaJFiwBITEzEMAxLFbdJkyYxadIkAA4dOoRhGGzevBmAxYsXYxgGubm5XL16FcMwWL58OQDr16/HMAzS0tIA+Otf/8r06dMB2L17N4ZhsGPHDgDmzp2LYRjcuXOH8+fPYxgG8fHxlnkYhsHFixcpLCzEMAw+/fRTALZv345hGOzZswe4W2b23vnoqampGIbBhg0bAFi2bBmGYZCVlUVOTg6GYbBkyRIANm3ahGEYHDlyBIAJEyZYPoc7ePAghmGwZcsWYmJimDp1qlaKU0o9ebRSXFHWrBS3c+dOeeaZZ+T8+fOydetWAWTEiBEiItKrVy8B5MSJE5KRkSGAdOzYUUREJkyYIIDEx8eLiEhAQID4+/uLiMiqVasEkPHjx4uISOfOnQWQK1euSGpqqgDSs2dPEREZOXKkAJKYmCgiIu7u7lK3bl0REYmJiRFAPv74YxERadGihQBSUFAgycnJAsiQIUNERCQyMtLyO8vPzxdAWrZsKSIiM2fOFEBiY2NFRCQ4OFi8vLxERGTTpk0CyOjRo0VEpEePHgLIqVOn5PLlywJI165dRUTk/fffF0DWrl0rIiJ+fn5StWpVERH56quvBJBJkybJzp07ZePGjVopTimllPWEh4ezYMEC/P39cXNzIyEhgWrVqgHw7rvvMnDgQPz9/SlVqhQJCQmUL18egD59+hAeHm453nXFihWWPlu2bElCQoKlMtukSZMYMWIEXl5eljH8/PyAu8e3durUydLP2rVrcXFxAe7Wfk9ISCA4OBi4e5DMtWvXcHR0JCgoiISEBMsJbu+88w49e/YkMDDQEqu3tzcAr776KqGhodSrVw+4+8Tg3jGrjRo1IiEhgerVqwN3z6AfMmQIfn5+ODo6kpCQYDm/vX///rRq1YpGjRoBYDabcXS8+2C9devWJCQkUKtWLUtfDiIixfPPpJRSjweTyYRhGJjNZiIiImwdjs1FRkayaNEi9u7dW+LnoauSo+/QlVJKKTugCV0ppZSyA5rQlVJKKTugCV0ppZSyA5rQlVJKKTugCV0ppZTVrF+/nk2bNgGwZMkSDMPgxo0bZGVlYRgGy5YtA2DDhg0YhkFqaioA48aNY9q0aQDs2bMHwzDYvn07AJ9++imGYVBYWMiFCxcwDIO4uDgA4uPjMQyD8+fPc+fOHQzDYO7cuQD88MMPGIbB7t27AZg+fTp//etfAUhLS8MwDNavXw/A8uXLMQyDq1evWoreLF68GIDNmzdjGAaHDx8Giha9SUlJwTAMEhMTAVi0aBGGYZCXl0dGRgaGYVg+wVu3bh2GYXDy5Eng7idtM2bMACA5OblI0ZtPPvkEwzAQEc6dO8fYsWO1sIxS6smjhWWKsmZhmVGjRsnw4cPl5MmT0rVrVwEkPT1dTp06JYD06NFDRERGjx4tgGzatElERDw9PSUkJERERGJjYwWQmTNniohIy5YtBZD8/HzZs2ePABIZGSkiIkOGDBFAkpOTpaCgQABp0aKFiIjMnj1bAImJiRERkbp164q7u7uIiCQmJgogo0aNEhGR1157TQBJTU2VK1euCCCdO3cWEZHx48cLIKtXrxYREX9/fwkICBARkfj4eAFkwoQJIiLSsWNHAeTq1aty4sQJAaRXr14iIjJixAgBZOvWrSIi4urqKvXq1RMRkSVLlgggc+bMERGR5s2bCyB37tyRefPmibOzsxaWUUopZV1z5szhlVdeYeLEibz99tt4e3vj6elJQkICFStWBO5+G9++fXtLUZXVq1dbCsC0b9++SAGYmTNncu3aNUqVKkVgYGCRAjBRUVH06NGDoKAgS+GWewVg/vCHP1CnTh1CQ0MBWLhwITdv3gSgYcOGRYrevPfeewwaNIhKlSrdV/SmX79+PAoWDt0AACAASURBVP3005Zv+L/88kvLXFu1alWk6M3kyZMZNWoUHh4euLi4FCl6M2TIEDp37kyDBg0A+Oabb3BzcwP+r+hNSEgIAB9//DHZ2dk4ODiwdu1aatSooYVllFJPHi0sU5QWlrEPukJXSillNefOnePy5cvUrl1bz0QvJnFxcWRmZuqmOKWUUtYze/ZsmjZtSnJysq1DsRsTJkxg2LBhukJXSillPeHh4QwePFjPQi9G7733HpmZmZrQlVJKWU/37t3p3r27rcOwK/d+n/rIXSmllNXExcUxZMgQjh07ZutQ7EafPn1o0aKFJnSllFLWk5SUxIIFC7hw4YKtQ7Ebhw8fZvfu3ZrQlVJKWc/w4cPZtWsXYWFhtg6lxNy4cYPk5GRLlbuStmfPHvLz8/UdulJKKeupXLkylStXtnUYJSolJYXw8HBeeeUVvv766xIf7/Dhw+Tl5ekKXSmllPVER0fj4ODAli1bbB2K3bj3Dl1X6EoppawmICCAsLAwLSpTjLp3787TTz+tCV0ppZT1REVFERUVZfVxc3JySE9Pp0KFCnh5eQGQnZ1NYWEhPj4+D/yZixcvcufOHfz9/XFwcPjFvn/++Wdyc3Px8/Oz1Ju3pvfeew/Qz9aUUkpZkbV3uWdlZdGrVy98fHwIDAzEx8eHLl26cP78eZo0aWI5YOVfzZkzhypVquDv70/lypXx9PTknXfe4fr160XaHThwgPDwcCpWrEj16tUpX748UVFR5OfnW2Vu92ilOKWUUkWMGjWKsmXLlugY+/fv5+jRoyQmJlqlWly/fv1Yt24dXbp04U9/+hNOTk7Ex8fz8ssvc/XqVUqXLl2k/QcffMD7779P8+bN+X//7/9Rrlw54uPjmTFjBocOHWL9+vU4OjqSlZVFp06duHTpEm+//TadO3fm2rVrzJ07l3379pX4vP5VXFwcKSkpmtCVUkrdlZCQYJVxBg0aRO3atUt8nN27d7Nu3TqqVavG6tWrcXZ2BqBr164MGDCA5OTkIu/yz549y4QJE6hcuTJbtmzB1dUVgAEDBvDcc8/x3XffkZiYyPPPP8/ChQu5ePEi/fv3Z/r06ZY+Xn75ZerXr1/ic/tXy5cvJy8vTxO6Ukqpu7Zt20a9evVKfBx3d/f7VsYlYevWrQD06NHDkszvGTp0KJ9//jlOTk6Wa/Hx8RQUFNCnTx9LMgdwcHBg1qxZpKamUrNmzSJ99+7du0i/pUuX5s0332TMmDElMqcHqVOnDqDHpyqllPpfXl5ev7hBrLjMmjWL2NhY5s+fX+LFZc6fPw9AUFDQfffuJcF/dfDgQYAHPj1o0KABDRo0sPz93h6AWrVq3dc2JCTktwX8GzVu3FgfuSullLKu8+fPk5ycfN8Gs5Jw6dIlAMqVK3ffPW9v7/ueEmRlZQE8cKPcv7t48eIv9l2hQoVHjvX3qFOnDmXKlNFd7koppaxnypQpiAht27Yt8bHuPTbPy8u7715eXt59u9HvJficnJzf1fe1a9ceOdbfY/ny5ezcuVNX6Eoppazn+PHjnD59mrCwsBJ/vF+pUiXg7nfi/+7s2bP3XatSpQrwf4/q/9W95H8v6VeqVIm0tDR+/vnn+0rZPujnS1JcXByZmZm6QldKKWU9n332GR06dLDKp1333m9v2rTpvntxcXH3XWvTpg3AA+uvm0wmypQpw6xZs3617/j4+N8e9G9w7zt0TehKKaWspm3btowePZqqVauW+FgvvPACnp6eJCQksHbtWsv1nTt3Mnfu3CI72QE6dOhAvXr1+PHHH5kxYwaFhYUA7Nixg+nTp+Pu7s4f/vAHAHr27AnA7NmzOXHiBAAiwuLFi9m1axeA5edL2nvvvcfcuXNBlFLqCTN58mQBxGw22zqU/woDBw4UQPbu3WvrUIrdkiVLxMnJSQDx9fWVatWqiaOjo8yfP198fHykbNmyRdofPnxYqlWrJoD4+PhIpUqVBBAPDw+Ji4sr0vb1118XQACpUaOG+Pr6StmyZeXLL78UQDp16mTNqYq+Q1dKKWU1S5cuZc2aNYwbN47Q0NASH2/AgAE0atQIs9nM5cuX8fX15ZVXXiE8PJwRI0ZQqlTRNBgSEsKhQ4cwm83s2rWLgoICateuTZ8+fXjqqaeKtP3888+JiIggISGBnJwcS7vy5cszefJkqlWrVuLzg7unraWlpemmOKWUUtazf/9+Vq5cybBhw6w2ZqNGjWjUqNFDt3dzc2PAgAEMGDDgV9u++OKLvPjii/ddHz169KOE+LscPnyYlJQUfYeulFLKegzDIDU1lfDwcFuHYjf27NlDfn6+rtCVUkpZj6urKw4ODveVYlW/XVJSEjk5ObpCV0opZT3jxo2jXLlyfP/997YOhbJly5b46XLWMHToULp06aIrdKWUUtZTq1Yt2rdvX+JFZR7Gg4rLPI4GDBhAenq6JnSllFLWM3jwYAYPHmzrMOxKVFQUoKetKaWUsqLExER+/PFHevfubZXiMk+C6Ohozp49q+/QlVJKWc+GDRswDIO0tDROnjyJYRisW7cOgBUrVmAYBhkZGeTm5mIYBosWLQLu/kfAMAxSUlIAmDRpEpMmTQLg0KFDGIbB5s2bAVi8eDGGYZCbm8vVq1cxDIPly5cDsH79esv4AH/961+ZPn06ALt378YwDHbs2AHA3LlzMQyDO3fucP78eQzDsJR1jYuLwzAMLl68SGFhIYZh8OmnnwKwfft2DMNgz549AEybNo1x48YBkJqaimEYbNiwAYBly5ZhGAZZWVnk5ORgGAZLliwB7paVNQyDI0eOAHdLvE6ePBm4e9SrYRhs2bKFhISEu6VsrVrGRiml/gtopbiirFkpbt++ffLcc89Jenq6bN26VQAZMWKEiIj06tVLADlx4oRkZGQIIB07dhQRkQkTJggg8fHxIiISEBAg/v7+IiKyatUqAWT8+PEiItK5c2cB5MqVK5KamiqA9OzZU0RERo4cKYAkJiaKiIi7u7vUrVtXRERiYmIEkI8//lhERFq0aCGAFBQUSHJysgAyZMgQERGJjIy0/M7y8/MFkJYtW4qIyMyZMwWQ2NhYEREJDg4WLy8vERHZtGmTADJ69GgREenRo4cAcurUKbl8+bIA0rVrVxERef/99wWQtWvXioiIn5+fVK1aVUREvvrqKwFk0qRJcvbsWUlLSxMHEZHf/n8tpZR6/JhMJgzDwGw2ExERYetwbC4yMpJFixaxd+9eGjZsWOLjnT59mmrVqpGTk8PRo0fx8/OjcuXKnDx5kqtXr1KvXj2cnJzYt28fXl5eBAUFcfHiRS5cuEBgYCBly5Zl//79ADRo0ICsrCxSU1Px9/enUqVKHD9+nOzsbBo2bEhhYSEHDx7Ex8eHmjVrcu7cOS5fvkzt2rXx9PRkz549lC5dmtDQUDIyMjh16hRVqlShYsWKHDlyhBs3btCkSRPy8vI4fPgwvr6+VK1aldOnT3PlyhXq1q2Li4sLu3fvxsPDg+DgYNLT0zl79iw1atSgXLlypKSkcPv2bRo1asT169c5duwYTz31FAEBAaSlpZGZmUn9+vVxdHRk3759eHt7U6tWLcuca9Wqhbe3N/v378fBwYH69euTmZlJWloaAQEBlgp2mtCVUk8cTehFWTuhq5Kh79CVUkopO6AJXSmllLIDmtCVUkopO6AJXSmllLIDmtCVUkopO6AJXSmllNUkJiayfft2AFauXInJZCI3N5fs7GxMJhOrVq0CYMuWLZhMJk6fPg3AjBkzWLhwIQApKSmYTCZ27doFwNKlSzGZTNy5c4f09HRMJpOlcMt3332HyWTi8uXLiAgmk4nY2FgAkpOTMZlMHDx4EIBFixZZisycOXMGk8lEYmIiAKtXr8ZkMpGVlUVeXh4mkwmz2QzADz/8gMlk4sSJEwB88sknzJ07F4Djx49jMpksxWrMZjMmk4mbN2+SlZWFyWRizZo1AGzevBmTyWSpMT9t2jRLYZ0DBw5gMpnYvXs3AF988QUmkwmAS5cuMXXqVC0so5R68mhhmaKsWVhm1KhRMmrUKDl37px07dpVAElPT5dTp04JID169BARkdGjRwsgmzZtEhERT09PCQkJERGR2NhYAWTmzJkiItKyZUsBJD8/X/bs2SOAREZGiojIkCFDBJDk5GQpKCgQQFq0aCEiIrNnzxZAYmJiRESkbt264u7uLiIiiYmJAsioUaNEROS1114TQFJTU+XKlSsCSOfOnUVEZPz48QLI6tWrRUTE399fAgICREQkPj5eAJkwYYKIiHTs2FEAuXr1qpw4cUIA6dWrl4iIjBgxQgDZunWriIi4urpKvXr1RERkyZIlAsicOXNERKR58+YCyJ07d2TZsmXi7OwsWstdKaWUVc2cOZOuXbsyZswYBgwYgJeXF+7u7pjNZipXrgxA3759CQsLo169egB8/vnnuLq6AtC6dWvMZjONGjUC4MMPPyQjIwMnJyeqV6+O2WymRo0aAAwaNIjnn3+eGjVq4OjoiNlspnz58gB06dIFs9lMs2bNAJg+fTq5ubkAhIaGYjabCQ4OBuDtt9+mR48e+Pn54ezsjNlsthR06d69OyEhITRt2hSA+fPnW+barFkzzGazZR5jx44lMjISd3d3Sz9VqlQBoH///oSHh1OnTh3g7pMHDw8PANq2bYvZbKZx48bA3dK3V69excHBgfnz5+Pj46OFZZRSTx4tLFOUNQvLXL16laysLCpVqmRJ0Kp46ApdKaWUeowlJSWRk5Ojm+KUUkpZz+TJkwkMDCQpKcnWodiNoUOH0qVLF12hK6WUsp4GDRoQERGBr6+vrUOxGwMGDCA9PV0TulJKKevp168f/fr1s3UYdiUqKgrQd+hKKaWsaP369Wzbto3BgwdTs2ZNW4djF6Kjozl79qy+Q1dKKWU99wrGnDlzxtah2I2EhATi4uJ0ha6UUsp6Bg0aRMeOHfXc9WK0du1abt++rQldKaWU9QQFBREUFGTrMOySPnJXSillNePGjaNcuXJ8//33tg7FbnTr1o3g4GBdoSullLIeV1dXfHx8cHZ2tnUodqNDhw6EhIRoQldKKWU9hmFgGIbVxrt9+zaFhYW4uLj8attbt26Rn5+Pp6fnQ/efm5tLmTJlcHJyuu/ejRs3cHd3f6R4f4spU6YA+shdKaWUFe3fv5+VK1fy888/l+g4ZrOZJk2aUKZMGdzc3KhWrRqTJk3i1q1bRdrl5+czYcIEatWqhYuLC15eXnh7e9O7d2/Lcaj3LFu2jMDAQMxmM99++y0hISG4u7vj4uLCSy+9REZGBjdu3GDQoEG4ubnh4eFBlSpVmD17donOddasWYwdO1ZX6Eoppaxn6dKlTJ06lcTERNq2bVsiY8yZM4c///nP1K5dm+joaMqVK8eaNWsYO3Yse/fu5e9//zsODg6ICBEREaxZs4ZWrVoRHR2Nh4cHP/zwAwsWLCAhIYEff/zR8r38zZs3SUtLY9OmTaxevZo//vGPVKhQgeXLl7N27VqioqLIzs4mJyeHCRMmcOnSJebMmUNUVBRNmzalZcuWJTLfmJgYUlJS9Dx0pdSTR89DL8qa56Fv3rxZJk+eLKdPny6R/i9fviwuLi5SsWJFycrKslwvKCiQp59+WgDZtm2biIh89dVXAkjz5s3l9u3bRfqZOnVqkbPKRUS++OILAaRUqVJFfldXrlyR0qVLi4ODg3Tp0kUKCwst9yZMmCCAjBs3rkTmKyKyc+dO2bhxo56HrpRSynratWtHu3btSqz/+Ph4bt68yZAhQ/D29rZcd3JyYtq0aezbt48KFSoAdx/LA7z11luUKlU0HQ4cOJCxY8eyZs0aCgoKKFWqFA4ODgA8//zzRb6jL1++PDVq1ODo0aMMHz4cR8f/e5t974z0c+fOlcyEgfDwcEDfoSullLKiBQsW0KFDB/bt21ci/e/duxeAunXr3nfv6aefZujQodSpUwfAEkPjxo3va+vj40PlypXJzc3l5MmTRe7Vrl37vvZly5YFuO8b+3vXc3JyHnUqD61Nmzb4+fnpO3SllFJ3nTt37pF2eP8Wu3btYuPGjWRmZpZI//f6vbcK/0+ysrIAqFix4gPvV6xYkbS0tPtifdDv6N7q3cPD44HXS5Knpydly5bVhK6UUk+6atWq4e3tzYsvvmiV8RYvXswzzzxTIn3fe3Sem5v70G1v3rz5wPt5eXkAlC5dupiiKxnffPMNoKetKaXUE+8vf/kLTk5OlsfVJSk/Px8vL6+7tcdLFX8KCggIAODixYu/2rZy5cqcP3+eixcvUq1atfvuX7p0CYBKlSoVb5DFLCEhgezsbE3oSiml4N1337XKONHR0fTo0aPEPltr1aoVAGvWrGHUqFFF7k2dOpWJEycyefJkhg4dyrPPPktSUhLr1q2jRYsWRdomJydz+fJlgoKC8PPzK/Y4i1N0dDQpKSm6KU4ppZT1NGjQgIiICHx9fUuk/y5dulCrVi22b99ObGys5frRo0eZPn06ubm5PPfccwAMHjwYFxcX5s2bx9GjRy1tb9y4YfkPzvDhw0skzuI0fPhwJk6cqCt0pZRS1tOvXz/69etXYv07Ozvz5Zdf0rlzZ15//XU++OAD3NzcOHz4MA4ODsydO9eyS71WrVosXLiQP/7xjzRs2JCWLVvi6upKUlISGRkZDBgwgGHDhpVYrMXlzTffBPQdulJKKStav34927ZtY/DgwZYKbMUtLCyMI0eOsHjxYnbt2sXt27fp2rUrb775JsHBwUXa9u3blxYtWvDFF19w8OBBCgoK6NOnD927d6dNmzZF2oaGhjJ69GieffbZ+8bs378/bdq0ua92e6VKlRg9ejQNGjQo/on+r6FDh3L69GkcRERKbBSllPovZDKZMAwDs9lMRESErcN5okRHR5d46dcnTePGjfUdulJKKesaPnw4u3btIiwszNah2I2tW7dy+fJlfeSulFLKeipXrkzlypVtHYZdyc7O5vbt27pCV0opZT3R0dE4ODiwZcsWW4diN7p160ZwcLCu0JVSSllPQEAAYWFhJV5i9knSoUMHQkJCNKErpZSynqioKKKiomwdhl2ZMmUKoJ+tKaWUsqKkpCT27dvHiy++iL+/v63DsQuzZs0iPT0dp/fff/99WwejlFLWtH37djZu3EhERAShoaG2DueJMnv2bMaMGUO3bt1wcnJi3rx55OfnU6NGDdasWcOqVauoV68eANOmTePChQuEhoayY8cOli9fjp+fH+XLl2fu3Ln8+OOPNG/enOPHj7Nw4UIcHR2pUqUKZrOZb775hrCwMG7cuMGsWbPIyMggJCSExMREzGYzVatWxdvbm+nTp3Po0CGaNGnCwYMHWbJkCW5ublSqVInY2Fi+/fZbWrVqRXp6Op988gk3btygVq1abNiwga+//pratWvj6urKlClTOHXqFA0aNGDXrl3Exsbi4+NDxYoV+eyzz/jnP/9JixYtOH36NPPnz6egoIDq1auzatUqVq9eTYMGDSgsLGT69OlcvHiR0NBQtm/fzooVK6hUqRLlypVjzpw5JCcn06xZM44ePcqiRYsoVaoUEydOZNWqVSBKKfWEmTx5sgBiNpttHcoTZ+fOnfLMM8/I+fPnZevWrQLIiBEjRESkV69eAsiJEyckIyNDAOnYsaOIiEyYMEEAiY+PFxGRgIAA8ff3FxGRVatWCSDjx48XEZHOnTsLIFeuXJHU1FQBpGfPniIiMnLkSAEkMTFRRETc3d2lbt26IiISExMjgHz88cciItKiRQsBpKCgQJKTkwWQIUOGiIhIZGSkALJ3717Jz88XQFq2bCkiIjNnzhRAYmNjRUQkODhYvLy8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" alt="Structure of codestream-level XML output." /><figcaption aria-hidden="true">Structure of codestream-level XML output.</figcaption>
</figure>
<p>At the top level, the SIZ, COD, QCD and COM marker segments are each represented as individual sub elements. The tile part properties are nested in a <em>tileParts</em> element, where each individual tile part is represented as a separate <em>tilePart</em> sub element.</p>
<h2 id="contiguous-codestream-box">Contiguous Codestream box</h2>
<h3 id="element-name-19">Element name</h3>
<p>contiguousCodestreamBox</p>
<h3 id="reported-properties-19">Reported properties</h3>
<p>The reported properties for this box are organised into a number groups, which are represented as child elements in the properties tree:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#siz-marker">siz</a></td>
<td style="text-align: left;">Properties from the image and tile size (SIZ) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#cod-marker">cod</a></td>
<td style="text-align: left;">Properties from the coding style default (COD) marker segment (codestream main header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#coc-marker">coc</a></td>
<td style="text-align: left;">Properties from the (optional) coding style component (COC) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#rgn-marker">rgn</a></td>
<td style="text-align: left;">Properties from the (optional) region of interest (RGN) marker segment (codestream main header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#qcd-marker">qcd</a></td>
<td style="text-align: left;">Properties from the quantization default (QCD) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#qcc-marker">qcc</a></td>
<td style="text-align: left;">Properties from the (optional) quantization component (QCC) marker segment (codestream main header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#poc-marker">poc</a></td>
<td style="text-align: left;">Properties from the (optional) progression order change (POC) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#crg-marker">crg</a></td>
<td style="text-align: left;">Properties from the (optional) component registration (CRG) marker segment (codestream main header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#com-marker">com</a></td>
<td style="text-align: left;">Properties from the (optional) comment (COM) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#plm-marker">plm</a></td>
<td style="text-align: left;">Properties from the (optional) packet length (PLM) marker (codestream main header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#ppm-marker">ppm</a></td>
<td style="text-align: left;">Properties from the (optional) packed packet headers(PPM) marker segment (codestream main header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#tile-part">tileParts</a></td>
<td style="text-align: left;">Properties from individual tile parts</td>
</tr>
</tbody>
</table>
<p>Note that the <em>plm</em> and <em>ppm</em> elements are only written if the <code>--packetmarkers</code> option is used. The number of PLM and PPM markers is given by the following 2 derived properties (these are always reported, irrespective of <code>--packetmarkers</code>):</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">plmCount</td>
<td style="text-align: left;">Number of PLM markers in main header</td>
</tr>
<tr class="even">
<td style="text-align: left;">ppmCount</td>
<td style="text-align: left;">Number of PPM markers in main header</td>
</tr>
</tbody>
</table>
<h3 id="tests-18">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">codestreamStartsWithSOCMarker</td>
<td style="text-align: left;">First 2 bytes in codestream constitute a start of codestream (SOC) marker segment</td>
</tr>
<tr class="even">
<td style="text-align: left;">foundSIZMarker</td>
<td style="text-align: left;">Second marker segment in codestream is image and tile size (SIZ) marker segment</td>
</tr>
<tr class="odd">
<td style="text-align: left;">foundCODMarker</td>
<td style="text-align: left;">Codestream main header contains coding style default (COD) marker segment</td>
</tr>
<tr class="even">
<td style="text-align: left;">foundQCDMarker</td>
<td style="text-align: left;">Codestream main header contains quantization default (QCD) marker segment</td>
</tr>
<tr class="odd">
<td style="text-align: left;">foundExpectedNumberOfTiles</td>
<td style="text-align: left;">Number of encountered tiles is consistent with expected number of tiles (as calculated from <a href="#siz-marker">SIZ marker</a>)</td>
</tr>
<tr class="even">
<td style="text-align: left;">foundExpectedNumberOfTileParts</td>
<td style="text-align: left;">For all tiles, number of encountered tile parts is consistent with expected number of tile parts (values of <em>tnsot</em> from <a href="#sot-marker">SOT marker</a>)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">maxOneCcocPerComponent</td>
<td style="text-align: left;">No more than one <em>ccoc</em> value for each component (only reported if codestream contains any COC marker segments)</td>
</tr>
<tr class="even">
<td style="text-align: left;">maxOneCqccPerComponent</td>
<td style="text-align: left;">No more than one <em>cqcc</em> value for each component (only reported if codestream contains any QCC marker segments)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">foundEOCMarker</td>
<td style="text-align: left;">Last 2 bytes in codestream constitute an end of codestream (EOC) marker segment</td>
</tr>
</tbody>
</table>
<h2 id="siz-marker">Image and tile size (SIZ) marker segment (child of Contiguous Codestream box)</h2>
<h3 id="element-name-20">Element name</h3>
<p>siz</p>
<h3 id="reported-properties-20">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lsiz</td>
<td style="text-align: left;">Length of SIZ marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">rsiz</td>
<td style="text-align: left;">Decoder capabilities</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xsiz</td>
<td style="text-align: left;">Width of reference grid</td>
</tr>
<tr class="even">
<td style="text-align: left;">ysiz</td>
<td style="text-align: left;">Height of reference grid</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xOsiz</td>
<td style="text-align: left;">Horizontal offset from origin of reference grid to left of image area</td>
</tr>
<tr class="even">
<td style="text-align: left;">yOsiz</td>
<td style="text-align: left;">Vertical offset from origin of reference grid to top of image area</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xTsiz</td>
<td style="text-align: left;">Width of one reference tile with respect to the reference grid</td>
</tr>
<tr class="even">
<td style="text-align: left;">yTsiz</td>
<td style="text-align: left;">Height of one reference tile with respect to the reference grid</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xTOsiz</td>
<td style="text-align: left;">Horizontal offset from origin of reference grid to left side of first tile</td>
</tr>
<tr class="even">
<td style="text-align: left;">yTOsiz</td>
<td style="text-align: left;">Vertical offset from origin of reference grid to top side of first tile</td>
</tr>
<tr class="odd">
<td style="text-align: left;">numberOfTiles</td>
<td style="text-align: left;">Number of tiles<a href="#fn17" class="footnote-ref" id="fnref17" role="doc-noteref"><sup>17</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;">csiz</td>
<td style="text-align: left;">Number of components</td>
</tr>
<tr class="odd">
<td style="text-align: left;">ssizSign<sup>*</sup></td>
<td style="text-align: left;">Indicates whether image component is signed or unsigned (repeated for all components)</td>
</tr>
<tr class="even">
<td style="text-align: left;">ssizDepth<sup>*</sup></td>
<td style="text-align: left;">Number of bits for this component (repeated for all components)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xRsiz<sup>*</sup></td>
<td style="text-align: left;">Horizontal separation of sample of this component with respect to reference grid (repeated for all components)</td>
</tr>
<tr class="even">
<td style="text-align: left;">yRsiz<sup>*</sup></td>
<td style="text-align: left;">Vertical separation of sample of this component with respect to reference grid (repeated for all components)</td>
</tr>
</tbody>
</table>
<h3 id="tests-19">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lsizIsValid</td>
<td style="text-align: left;"><em>lsiz</em> is within range [41,49190]</td>
</tr>
<tr class="even">
<td style="text-align: left;">rsizIsValid</td>
<td style="text-align: left;"><em>rsiz</em> equals 0 (“ISO/IEC 15444-1”), 1 (“Profile 0”) or 2 (“Profile 1”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xsizIsValid</td>
<td style="text-align: left;"><em>xsiz</em> is within range [1,2<sup>32</sup> - 1]</td>
</tr>
<tr class="even">
<td style="text-align: left;">ysizIsValid</td>
<td style="text-align: left;"><em>ysiz</em> is within range [1,2<sup>32</sup> - 1]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xOsizIsValid</td>
<td style="text-align: left;"><em>xOsiz</em> is within range [0,2<sup>32</sup> - 2]</td>
</tr>
<tr class="even">
<td style="text-align: left;">yOsizIsValid</td>
<td style="text-align: left;"><em>yOsiz</em> is within range [0,2<sup>32</sup> - 2]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xTsizIsValid</td>
<td style="text-align: left;"><em>xTsiz</em> is within range [1,2<sup>32</sup> - 1]</td>
</tr>
<tr class="even">
<td style="text-align: left;">yTsizIsValid</td>
<td style="text-align: left;"><em>yTsiz</em> is within range [1,2<sup>32</sup> - 1]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">xTOsizIsValid</td>
<td style="text-align: left;"><em>xTOsiz</em> is within range [0,2<sup>32</sup> - 2]</td>
</tr>
<tr class="even">
<td style="text-align: left;">yTOsizIsValid</td>
<td style="text-align: left;"><em>yTOsiz</em> is within range [0,2<sup>32</sup> - 2]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">csizIsValid</td>
<td style="text-align: left;"><em>csiz</em> is within range [1,16384]</td>
</tr>
<tr class="even">
<td style="text-align: left;">lsizConsistentWithCsiz</td>
<td style="text-align: left;"><em>lsiz</em> equals 38 + 3*<em>csiz</em></td>
</tr>
<tr class="odd">
<td style="text-align: left;">ssizIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>ssizDepth</em> is within range [1,38] (repeated for all components)</td>
</tr>
<tr class="even">
<td style="text-align: left;">xRsizIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>xRsiz</em> is within range [1,255] (repeated for all components)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">yRsizIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>yRsiz</em> is within range [1,255] (repeated for all components)</td>
</tr>
</tbody>
</table>
<h2 id="cod-marker">Coding style default (COD) marker segment</h2>
<h3 id="element-name-21">Element name</h3>
<p>cod</p>
<h3 id="reported-properties-21">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcod</td>
<td style="text-align: left;">Length of COD marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">precincts</td>
<td style="text-align: left;">Indicates default or user-defined precinct size (“default”/“user defined”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">sop</td>
<td style="text-align: left;">Indicates use of start of packet marker segments (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">eph</td>
<td style="text-align: left;">Indicates use of end of packet marker segments (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">order</td>
<td style="text-align: left;">Progression order</td>
</tr>
<tr class="even">
<td style="text-align: left;">layers</td>
<td style="text-align: left;">Number of layers</td>
</tr>
<tr class="odd">
<td style="text-align: left;">multipleComponentTransformation</td>
<td style="text-align: left;">Indicates use of multiple component transformation (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">levels</td>
<td style="text-align: left;">Number of decomposition levels</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codeBlockWidth</td>
<td style="text-align: left;">Code block width</td>
</tr>
<tr class="even">
<td style="text-align: left;">codeBlockHeight</td>
<td style="text-align: left;">Code block height</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codingBypass</td>
<td style="text-align: left;">Indicates use of coding bypass (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">resetOnBoundaries</td>
<td style="text-align: left;">Indicates reset of context probabilities on coding pass boundaries (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">termOnEachPass</td>
<td style="text-align: left;">Indicates termination on each coding pass (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">vertCausalContext</td>
<td style="text-align: left;">Indicates vertically causal context (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">predTermination</td>
<td style="text-align: left;">Indicates predictable termination (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">segmentationSymbols</td>
<td style="text-align: left;">Indicates use of segmentation symbols (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">transformation</td>
<td style="text-align: left;">Wavelet transformation: “9-7 irreversible” or “5-3 reversible”</td>
</tr>
<tr class="even">
<td style="text-align: left;">precinctSizeX<sup>*</sup></td>
<td style="text-align: left;">Precinct width (repeated for all resolution levels; order: low to high). Equals 32768 if <em>precincts</em> is “default”</td>
</tr>
<tr class="odd">
<td style="text-align: left;">precinctSizeY<sup>*</sup></td>
<td style="text-align: left;">Precinct height (repeated for all resolution levels; order: low to high). Equals 32768 if <em>precincts</em> is “default”</td>
</tr>
</tbody>
</table>
<h3 id="tests-20">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcodIsValid</td>
<td style="text-align: left;"><em>lcod</em> is within range [12,45]</td>
</tr>
<tr class="even">
<td style="text-align: left;">orderIsValid</td>
<td style="text-align: left;"><em>order</em> equals 0 (“LRCP”), 1 (“RLCP”), 2 (“RPCL”), 3 (“PCRL”) or 4 (“CPRL”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">layersIsValid</td>
<td style="text-align: left;"><em>layers</em> is within range [1,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">multipleComponentTransformation</td>
<td style="text-align: left;">IsValid</td>
</tr>
<tr class="odd">
<td style="text-align: left;">levelsIsValid</td>
<td style="text-align: left;"><em>levels</em> is within range [0,32]</td>
</tr>
<tr class="even">
<td style="text-align: left;">lcodConsistencyCheck</td>
<td style="text-align: left;"><em>lcod</em> value is consistent with <em>precincts</em> and <em>levels</em> (Eq A-2 in ISO/IEC 15444-1)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codeBlockWidthExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockWidthExponent</em> is within range [2,10]</td>
</tr>
<tr class="even">
<td style="text-align: left;">codeBlockHeightExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockHeightExponent</em> is within range [2,10]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">sumHeightWidthExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockWidthExponent</em> + <em>codeBlockHeightExponent</em> ≤ 12</td>
</tr>
<tr class="even">
<td style="text-align: left;">precinctSizeXIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>precinctSizeX</em> ≥ 2 (except lowest resolution level) (repeated for all resolution levels; order: low to high) (only if <em>precincts</em> is “user defined”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">precinctSizeYIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>precinctSizeY</em> ≥ 2 (except lowest resolution level) (repeated for all resolution levels; order: low to high) (only if <em>precincts</em> is “user defined”)</td>
</tr>
</tbody>
</table>
<h2 id="coc-marker">Coding style component (COC) marker segment</h2>
<h3 id="element-name-22">Element name</h3>
<p>coc</p>
<h3 id="reported-properties-22">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcoc</td>
<td style="text-align: left;">Length of COC marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">ccoc</td>
<td style="text-align: left;">Index of the component to which this marker segment relates</td>
</tr>
<tr class="odd">
<td style="text-align: left;">precincts</td>
<td style="text-align: left;">Indicates default or user-defined precinct size (“default”/“user defined”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">levels</td>
<td style="text-align: left;">Number of decomposition levels</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codeBlockWidth</td>
<td style="text-align: left;">Code block width</td>
</tr>
<tr class="even">
<td style="text-align: left;">codeBlockHeight</td>
<td style="text-align: left;">Code block height</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codingBypass</td>
<td style="text-align: left;">Indicates use of coding bypass (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">resetOnBoundaries</td>
<td style="text-align: left;">Indicates reset of context probabilities on coding pass boundaries (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">termOnEachPass</td>
<td style="text-align: left;">Indicates termination on each coding pass (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">vertCausalContext</td>
<td style="text-align: left;">Indicates vertically causal context (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">predTermination</td>
<td style="text-align: left;">Indicates predictable termination (“yes”/“no”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">segmentationSymbols</td>
<td style="text-align: left;">Indicates use of segmentation symbols (“yes”/“no”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">transformation</td>
<td style="text-align: left;">Wavelet transformation: “9-7 irreversible” or “5-3 reversible”</td>
</tr>
<tr class="even">
<td style="text-align: left;">precinctSizeX<sup>*</sup></td>
<td style="text-align: left;">Precinct width (repeated for all resolution levels; order: low to high). Equals 32768 if <em>precincts</em> is “default”</td>
</tr>
<tr class="odd">
<td style="text-align: left;">precinctSizeY<sup>*</sup></td>
<td style="text-align: left;">Precinct height (repeated for all resolution levels; order: low to high). Equals 32768 if <em>precincts</em> is “default”</td>
</tr>
</tbody>
</table>
<h3 id="tests-21">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcocIsValid</td>
<td style="text-align: left;"><em>lcoc</em> is within range [9,43]</td>
</tr>
<tr class="even">
<td style="text-align: left;">ccocIsValid</td>
<td style="text-align: left;"><em>ccoc</em> is within range [0,255] (<em>csiz</em> < 257) or [0,16383] (<em>csiz</em> >= 257)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">levelsIsValid</td>
<td style="text-align: left;"><em>levels</em> is within range [0,32]</td>
</tr>
<tr class="even">
<td style="text-align: left;">lcocConsistencyCheck</td>
<td style="text-align: left;"><em>lcoc</em> value is consistent with <em>levels</em>, <em>csiz</em> and <em>precincts</em> (Eq A-3 in ISO/IEC 15444-1)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">codeBlockWidthExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockWidthExponent</em> is within range [2,10]</td>
</tr>
<tr class="even">
<td style="text-align: left;">codeBlockHeightExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockHeightExponent</em> is within range [2,10]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">sumHeightWidthExponentIsValid</td>
<td style="text-align: left;"><em>codeBlockWidthExponent</em> + <em>codeBlockHeightExponent</em> ≤ 12</td>
</tr>
<tr class="even">
<td style="text-align: left;">precinctSizeXIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>precinctSizeX</em> ≥ 2 (except lowest resolution level) (repeated for all resolution levels; order: low to high) (only if <em>precincts</em> is “user defined”)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">precinctSizeYIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>precinctSizeY</em> ≥ 2 (except lowest resolution level) (repeated for all resolution levels; order: low to high) (only if <em>precincts</em> is “user defined”)</td>
</tr>
</tbody>
</table>
<h2 id="rgn-marker">Region-of-interest (RGN) marker segment</h2>
<h3 id="element-name-23">Element name</h3>
<p>rgn</p>
<h3 id="reported-properties-23">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lrgn</td>
<td style="text-align: left;">Length of RGN marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">crgn</td>
<td style="text-align: left;">Index of the component to which this marker segment relates</td>
</tr>
<tr class="odd">
<td style="text-align: left;">roiStyle</td>
<td style="text-align: left;">ROI style for the current ROI</td>
</tr>
<tr class="even">
<td style="text-align: left;">roiShift</td>
<td style="text-align: left;">Implicit ROI shift</td>
</tr>
</tbody>
</table>
<h3 id="tests-22">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lrgnIsValid</td>
<td style="text-align: left;"><em>lrgn</em> is within range [5,6]</td>
</tr>
<tr class="even">
<td style="text-align: left;">crgnIsValid</td>
<td style="text-align: left;"><em>crgn</em> is within range [0,255] (<em>csiz</em> < 257) or [0,16383] (<em>csiz</em> >= 257)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">roiStyleIsValid</td>
<td style="text-align: left;"><em>roiStyle</em> equals 0 (“Implicit ROI (maximum shift)”)</td>
</tr>
<tr class="even">
<td style="text-align: left;">roiShiftIsValid</td>
<td style="text-align: left;"><em>roiShift</em> is within range [0,255]</td>
</tr>
</tbody>
</table>
<h2 id="qcd-marker">Quantization default (QCD) marker segment</h2>
<h3 id="element-name-24">Element name</h3>
<p>qcd</p>
<h3 id="reported-properties-24">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lqcd</td>
<td style="text-align: left;">Length of QCD marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">qStyle</td>
<td style="text-align: left;">Quantization style for all components</td>
</tr>
<tr class="odd">
<td style="text-align: left;">guardBits</td>
<td style="text-align: left;">Number of guard bits</td>
</tr>
<tr class="even">
<td style="text-align: left;">epsilon<sup>*</sup></td>
<td style="text-align: left;">- If <em>qStyle</em> equals 0 (“no quantization”): <em>Epsilon</em> exponent in Eq E-5 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)<br />- If <em>qStyle</em> equals 1 (“scalar derived”): <em>Epsilon</em> exponent in Eq E-3 of ISO/IEC 15444-1<br />- If <em>qStyle</em> equals 2 (“scalar expounded”): <em>Epsilon</em> exponent in Eq E-3 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">mu<sup>*</sup></td>
<td style="text-align: left;">- If <em>qStyle</em> equals 1 (“scalar derived”): <em>mu</em> constant in Eq E-3 of ISO/IEC 15444-1<br />- if <em>qStyle</em> equals 2 (“scalar expounded”) : <em>mu</em> constant in Eq E-3 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)</td>
</tr>
</tbody>
</table>
<h3 id="tests-23">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lqcdIsValid</td>
<td style="text-align: left;"><em>lqcd</em> is within range [4,197]</td>
</tr>
<tr class="even">
<td style="text-align: left;">qStyleIsValid</td>
<td style="text-align: left;"><em>qStyle</em> equals 0 (“no quantization”), 1 (“scalar derived”), or 2 (“scalar expounded”)</td>
</tr>
</tbody>
</table>
<h2 id="qcc-marker">Quantization component (QCC) marker segment</h2>
<h3 id="element-name-25">Element name</h3>
<p>qcc</p>
<h3 id="reported-properties-25">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lqcc</td>
<td style="text-align: left;">Length of QCC marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">cqcc</td>
<td style="text-align: left;">Index of the component to which this marker segment relates</td>
</tr>
<tr class="odd">
<td style="text-align: left;">qStyle</td>
<td style="text-align: left;">Quantization style for all components</td>
</tr>
<tr class="even">
<td style="text-align: left;">guardBits</td>
<td style="text-align: left;">Number of guard bits</td>
</tr>
<tr class="odd">
<td style="text-align: left;">epsilon<sup>*</sup></td>
<td style="text-align: left;">- If <em>qStyle</em> equals 0 (“no quantization”): <em>Epsilon</em> exponent in Eq E-5 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)<br />- If <em>qStyle</em> equals 1 (“scalar derived”): <em>Epsilon</em> exponent in Eq E-3 of ISO/IEC 15444-1<br />- If <em>qStyle</em> equals 2 (“scalar expounded”): <em>Epsilon</em> exponent in Eq E-3 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)</td>
</tr>
<tr class="even">
<td style="text-align: left;">mu<sup>*</sup></td>
<td style="text-align: left;">- If <em>qStyle</em> equals 1 (“scalar derived”): <em>mu</em> constant in Eq E-3 of ISO/IEC 15444-1<br />- if <em>qStyle</em> equals 2 (“scalar expounded”) : <em>mu</em> constant in Eq E-3 of ISO/IEC 15444-1 (repeated for all decomposition levels; order: low to high)</td>
</tr>
</tbody>
</table>
<h3 id="tests-24">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lqccIsValid</td>
<td style="text-align: left;"><em>lqcc</em> is within range [5,199]</td>
</tr>
<tr class="even">
<td style="text-align: left;">qStyleIsValid</td>
<td style="text-align: left;"><em>qStyle</em> equals 0 (“no quantization”), 1 (“scalar derived”), or 2 (“scalar expounded”)</td>
</tr>
</tbody>
</table>
<h2 id="poc-marker">Progression order change (POC) marker segment</h2>
<h3 id="element-name-26">Element name</h3>
<p>poc</p>
<h3 id="reported-properties-26">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lpoc</td>
<td style="text-align: left;">Length of POC marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">rspoc<sup>*</sup></td>
<td style="text-align: left;">Resolution level index for the start of a progression (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cspoc<sup>*</sup></td>
<td style="text-align: left;">Component index for the start of a progression (repeated for all progression order changes)</td>
</tr>
<tr class="even">
<td style="text-align: left;">lyepoc<sup>*</sup></td>
<td style="text-align: left;">Layer index for the end of a progression (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">repoc<sup>*</sup></td>
<td style="text-align: left;">Resolution level index for the end of a progression (repeated for all progression order changes)</td>
</tr>
<tr class="even">
<td style="text-align: left;">cepoc<sup>*</sup></td>
<td style="text-align: left;">Component index for the end of a progression (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">order<sup>*</sup></td>
<td style="text-align: left;">Progression order (repeated for all progression order changes)</td>
</tr>
</tbody>
</table>
<h3 id="tests-25">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lpocIsValid</td>
<td style="text-align: left;"><em>lpoc</em> is within range [9,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">rspocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>rspoc</em> is within range [0,32] (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">cspocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>cspoc</em> is within range [0,255] (<em>csiz</em> < 257) or [0,16383] (*csiz >= 257) (repeated for all progression order changes)</td>
</tr>
<tr class="even">
<td style="text-align: left;">lyepocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>lyepoc</em> is within range [1,65535] (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">repocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>repoc</em> is within range [(<em>rspoc</em> + 1),65535] (repeated for all progression order changes)</td>
</tr>
<tr class="even">
<td style="text-align: left;">cepocIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>cepoc</em> is within range [(<em>cspoc</em> + 1),255] (<em>csiz</em> < 257) or [(<em>cspoc</em> + 1),16384] (*csiz >= 257), or 0 (repeated for all progression order changes)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">orderIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>order</em> equals 0 (“LRCP”), 1 (“RLCP”), 2 (“RPCL”), 3 (“PCRL”) or 4 (“CPRL”) (repeated for all progression order changes)</td>
</tr>
</tbody>
</table>
<h2 id="crg-marker">Component registration (CRG) marker segment</h2>
<h3 id="element-name-27">Element name</h3>
<p>crg</p>
<h3 id="reported-properties-27">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcrg</td>
<td style="text-align: left;">Length of CRG marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">xrg<sup>*</sup></td>
<td style="text-align: left;">Horizontal offset, in units of 1/65536 of <em>xRsiz</em> (repeated for all components)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">yrg<sup>*</sup></td>
<td style="text-align: left;">Vertical offset, in units of 1/65536 of <em>yRsiz</em> (repeated for all components)</td>
</tr>
</tbody>
</table>
<h3 id="tests-26">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcrgIsValid</td>
<td style="text-align: left;"><em>lcrg</em> is within range [6,65534]</td>
</tr>
<tr class="even">
<td style="text-align: left;">xcrgIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>xcrg</em> is within range [0,65535] (repeated for all components)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">ycrgIsValid<sup>*</sup></td>
<td style="text-align: left;"><em>ycrg</em> is within range [0,65535] (repeated for all components)</td>
</tr>
</tbody>
</table>
<h2 id="com-marker">Comment (COM) marker segment</h2>
<h3 id="element-name-28">Element name</h3>
<p>com</p>
<h3 id="reported-properties-28">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcom</td>
<td style="text-align: left;">Length of COM marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">rcom</td>
<td style="text-align: left;">Registration value of marker segment (indicates whether this comment contains binary data or text)</td>
</tr>
<tr class="odd">
<td style="text-align: left;">comment</td>
<td style="text-align: left;">Embedded comment as text (only if <em>rcom</em> = 1 )</td>
</tr>
</tbody>
</table>
<h3 id="tests-27">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lcomIsValid</td>
<td style="text-align: left;"><em>lqcd</em> is within range [5,65535]</td>
</tr>
<tr class="even">
<td style="text-align: left;">rcomIsValid</td>
<td style="text-align: left;"><em>rcom</em> equals 0 (“binary”) or 1 (“ISO/IEC 8859-15 (Latin”))</td>
</tr>
<tr class="odd">
<td style="text-align: left;">commentIsValid</td>
<td style="text-align: left;">Comment is valid ISO/IEC8859-15 and does not contain control characters, other than tab, newline or carriage return</td>
</tr>
</tbody>
</table>
<h2 id="tile-part">Tile part (child of Contiguous Codestream box)</h2>
<p>Tile-part level properties and tests. This is not a box or a marker segment!</p>
<h3 id="element-name-29">Element name</h3>
<p>tilePart (child of tileParts)</p>
<h3 id="reported-properties-29">Reported properties</h3>
<p>Each tile part element can contain a number of child elements:</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Child element</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"><a href="#sot-marker">sot</a></td>
<td style="text-align: left;">Properties from start of tile (SOT) marker segment</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#cod-marker">cod</a></td>
<td style="text-align: left;">Properties from the (optional) coding style default (COD) marker segment (tile part header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#coc-marker">coc</a></td>
<td style="text-align: left;">Properties from the (optional) coding style component (COC) marker segment (tile part header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#rgn-marker">rgn</a></td>
<td style="text-align: left;">Properties from the (optional) region of interest (RGN) marker segment (tile part header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#qcd-marker">qcd</a></td>
<td style="text-align: left;">Properties from the (optional) quantization default (QCD) marker segment (tile part header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#qcc-marker">qcc</a></td>
<td style="text-align: left;">Properties from the (optional) quantization component (QCC) marker segment (tile part header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#poc-marker">poc</a></td>
<td style="text-align: left;">Properties from the (optional) progression order change (POC) marker segment (tile part header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#com-marker">com</a></td>
<td style="text-align: left;">Properties from the (optional) comment (COM) marker segment (tile part header)</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><a href="#plt-marker">plt</a></td>
<td style="text-align: left;">Properties from the (optional) packet length (PLT) marker(tile part header)</td>
</tr>
<tr class="even">
<td style="text-align: left;"><a href="#ppt-marker">ppt</a></td>
<td style="text-align: left;">Properties from the (optional) packed packet headers(PPT) marker segment (tile part header)</td>
</tr>
</tbody>
</table>
<p>Note that the <em>plt</em> and <em>ppt</em> elements are only written if the <code>--packetmarkers</code> option is used. The number of PLT and PPT markers is given by the following 2 derived properties (these are always reported, irrespective of <code>--packetmarkers</code>):</p>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">pltCount</td>
<td style="text-align: left;">Number of PLT markers in tile part header</td>
</tr>
<tr class="even">
<td style="text-align: left;">pptCount</td>
<td style="text-align: left;">Number of PPT markers in tile part header</td>
</tr>
</tbody>
</table>
<h3 id="tests-28">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">foundNextTilePartOrEOC</td>
<td style="text-align: left;">Tile part start offset + <em>tilePartLength</em> points to either start of new tile or EOC marker (useful for detecting within-codestream byte corruption)</td>
</tr>
<tr class="even">
<td style="text-align: left;">foundSODMarker</td>
<td style="text-align: left;">Last marker segment of tile part is a start-of-data (SOD) marker</td>
</tr>
</tbody>
</table>
<h2 id="sot-marker">Start of tile part (SOT) marker segment (child of tile part)</h2>
<h3 id="element-name-30">Element name</h3>
<p>sot</p>
<h3 id="reported-properties-30">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lsot</td>
<td style="text-align: left;">Length of SOT marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">isot</td>
<td style="text-align: left;">Tile index</td>
</tr>
<tr class="odd">
<td style="text-align: left;">psot</td>
<td style="text-align: left;">Length of tile part</td>
</tr>
<tr class="even">
<td style="text-align: left;">tpsot</td>
<td style="text-align: left;">Tile part index</td>
</tr>
<tr class="odd">
<td style="text-align: left;">tnsot</td>
<td style="text-align: left;">Number of tile-parts of a tile in the codestream (value of 0 indicates that number of tile-parts of tile in the codestream is not defined in current header)</td>
</tr>
</tbody>
</table>
<h3 id="tests-29">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lsotIsValid</td>
<td style="text-align: left;"><em>lsot</em> equals 10</td>
</tr>
<tr class="even">
<td style="text-align: left;">isotIsValid</td>
<td style="text-align: left;"><em>isot</em> is within range [0,65534]</td>
</tr>
<tr class="odd">
<td style="text-align: left;">psotIsValid</td>
<td style="text-align: left;"><em>psot</em> is <strong>not</strong> within range [1,13]</td>
</tr>
<tr class="even">
<td style="text-align: left;">tpsotIsValid</td>
<td style="text-align: left;"><em>tpsot</em> is within range [0,254]</td>
</tr>
</tbody>
</table>
<p><br></p>
<p>The following marker segments are only minimally supported: <em>jpylyzer</em> will report their presence in the <em>properties</em> element, but it does not perform any further tests or analyses. This may change in upcoming versions of the software.</p>
<h2 id="tlm-marker">Tile-part lengths (TLM) marker segment</h2>
<h3 id="element-name-31">Element name</h3>
<p>tlm</p>
<h3 id="reported-properties-31">Reported properties</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h3 id="tests-30">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h2 id="plm-marker">Packet length, main header (PLM) marker segment</h2>
<h3 id="element-name-32">Element name</h3>
<p>plm</p>
<h3 id="reported-properties20">Reported properties<a href="#fn18" class="footnote-ref" id="fnref18" role="doc-noteref"><sup>18</sup></a></h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lplm</td>
<td style="text-align: left;">Length of PLM marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">zplm</td>
<td style="text-align: left;">PLM marker segment index</td>
</tr>
<tr class="odd">
<td style="text-align: left;">nplm</td>
<td style="text-align: left;">Number of bytes of Iplm information for the ith tile-part</td>
</tr>
<tr class="even">
<td style="text-align: left;">iplm</td>
<td style="text-align: left;">Comma separated list of packet length values (as hexadecimal strings)</td>
</tr>
</tbody>
</table>
<h3 id="tests-31">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h2 id="ppm-marker">Packed packet headers, main header (PPM) marker segment</h2>
<h3 id="element-name-33">Element name</h3>
<p>ppm</p>
<h3 id="reported-properties20-1">Reported properties<a href="#fn19" class="footnote-ref" id="fnref19" role="doc-noteref"><sup>19</sup></a></h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h3 id="tests-32">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h2 id="plt-marker">Packet length, tile-part header (PLT) marker segment</h2>
<h3 id="element-name-34">Element name</h3>
<p>plt</p>
<h3 id="reported-properties20-2">Reported properties<a href="#fn20" class="footnote-ref" id="fnref20" role="doc-noteref"><sup>20</sup></a></h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">lplt</td>
<td style="text-align: left;">Length of PLT marker segment in bytes</td>
</tr>
<tr class="even">
<td style="text-align: left;">zplt</td>
<td style="text-align: left;">PLT marker segment index</td>
</tr>
<tr class="odd">
<td style="text-align: left;">nplm</td>
<td style="text-align: left;">Number of bytes of Iplm information for the ith tile-part</td>
</tr>
<tr class="even">
<td style="text-align: left;">iplt</td>
<td style="text-align: left;">Comma separated list of packet length values (as hexadecimal strings)</td>
</tr>
</tbody>
</table>
<h3 id="tests-33">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h2 id="ppt-marker">Packed packet headers, tile-part header (PPT) marker segment</h2>
<h3 id="element-name-35">Element name</h3>
<p>ppt</p>
<h3 id="reported-properties20-3">Reported properties<a href="#fn21" class="footnote-ref" id="fnref21" role="doc-noteref"><sup>21</sup></a></h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Property</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h3 id="tests-34">Tests</h3>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Test name</th>
<th style="text-align: left;">True if</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
<tr class="even">
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>
<h1 id="references">References</h1>
<p>ICC. Specification ICC.1:1998-09 – File Format for Color Profiles. International Color Consortium, 1998. <a href="https://www.color.org/ICC-1_1998-09.pdf">https://www.color.org/ICC-1_1998-09.pdf</a>.</p>
<p>ISO/IEC. Information technology — JPEG 2000 image coding system: Core coding system. ISO/IEC 15444-1, Second edition. Geneva: ISO/IEC, 2004a. <a href="https://www.jpeg.org/public/15444-1annexi.pdf">https://www.jpeg.org/public/15444-1annexi.pdf</a> (“Annex I: JP2 file format syntax” only).</p>
<p>ISO/IEC. Information technology — JPEG 2000 image coding system: Extensions. ISO/IEC 15444-2, First edition. Geneva: ISO/IEC, 2004b. <a href="https://www.jpeg.org/public/15444-2annexm.pdf">https://www.jpeg.org/public/15444-2annexm.pdf</a> (“Annex M: JPX extended file format syntax” only).</p>
<p>Leach, P., Mealling, M. & Salz, R. A Universally Unique IDentifier (UUID) URN namespace. Memo, IETF. <a href="https://tools.ietf.org/html/rfc4122.html">https://tools.ietf.org/html/rfc4122.html</a>.</p>
<section class="footnotes" role="doc-endnotes">
<hr />
<ol>
<li id="fn1" role="doc-endnote"><p>The <em>jpylyzer</em> binaries were created using the <em>PyInstaller</em> package: <a href="https://www.pyinstaller.org/">https://www.pyinstaller.org/</a><a href="#fnref1" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn2" role="doc-endnote"><p>Note that <em>jpylyzer</em> versions 1.8 and earlier returned a formatted XML string instead of an element object!<a href="#fnref2" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn3" role="doc-endnote"><p>Note that <em>jpylyzer</em> versions 1.4 and earlier used the verbose output format by default. This behaviour has changed in version 1.5 onwards, as the lengthy output turned out to be slightly confusing to some users.<a href="#fnref3" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn4" role="doc-endnote"><p>The “Any ICC” method is defined in ISO/IEC 15444-2 (the JPX format), and is not allowed in JP2. However, <em>jpylyzer</em> offers limited support for JPX here by also reporting the properties of ICC profiles that were embedded using this method. Note that any file that uses this method will fail the “methIsValid” test (and thereby the validation).<a href="#fnref4" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn5" role="doc-endnote"><p>Originally ISO/IEC 15444-1 only allowed “input device” profiles. Support of “display device” profiles was added through an <a href="http://www.itu.int/rec/T-REC-T.800-201303-P!Amd6/en">amendment</a> to the standard in 2013. The behaviour of <em>jpylyzer</em> is consistent with this amendment.<a href="#fnref5" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn6" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mfrac> <mrow> <mi>vRcN</mi> </mrow> <mrow> <mi>vRcD</mi> </mrow> </mfrac> <mo>•</mo> <msup> <mn>10</mn> <mi>vRcE</mi> </msup> </mrow> </math><a href="#fnref6" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn7" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mfrac> <mrow> <mi>hRcN</mi> </mrow> <mrow> <mi>hRcD</mi> </mrow> </mfrac> <mo>•</mo> <msup> <mn>10</mn> <mi>hRcE</mi> </msup> </mrow> </math><a href="#fnref7" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn8" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>vRescInPixelsPerMeter</mi> <mo>•</mo> <mn>25.4</mn> <mo>•</mo> <msup> <mn>10</mn> <mi>-3</mi> </msup> </mrow> </math><a href="#fnref8" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn9" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>hRescInPixelsPerMeter</mi> <mo>•</mo> <mn>25.4</mn> <mo>•</mo> <msup> <mn>10</mn> <mi>-3</mi> </msup> </mrow> </math><a href="#fnref9" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn10" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mfrac> <mrow> <mi>vRdN</mi> </mrow> <mrow> <mi>vRdD</mi> </mrow> </mfrac> <mo>•</mo> <msup> <mn>10</mn> <mi>vRdE</mi> </msup> </mrow> </math><a href="#fnref10" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn11" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mfrac> <mrow> <mi>hRdN</mi> </mrow> <mrow> <mi>hRdD</mi> </mrow> </mfrac> <mo>•</mo> <msup> <mn>10</mn> <mi>hRdE</mi> </msup> </mrow> </math><a href="#fnref11" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn12" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>vResdInPixelsPerMeter</mi> <mo>•</mo> <mn>25.4</mn> <mo>•</mo> <msup> <mn>10</mn> <mi>-3</mi> </msup> </mrow> </math><a href="#fnref12" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn13" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>hResdInPixelsPerMeter</mi> <mo>•</mo> <mn>25.4</mn> <mo>•</mo> <msup> <mn>10</mn> <mi>-3</mi> </msup> </mrow> </math><a href="#fnref13" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn14" role="doc-endnote"><p>Link: <a href="https://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/cs6/XMPSpecificationPart3.pdf">https://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/cs6/XMPSpecificationPart3.pdf</a><a href="#fnref14" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn15" role="doc-endnote"><p>However, support for start of packet (SOP) and end of packet (EPH) markers may be included in future versions.<a href="#fnref15" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn16" role="doc-endnote"><p>For example, in a TIFF to JP2 conversion workflow one could include a pixel-by-pixel comparison of the values in the TIFF and the JP2.<a href="#fnref16" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn17" role="doc-endnote"><p>Calculated as: <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>numberOfTiles</mi> <mo>=</mo> <mo>[</mo> <mfrac> <mrow> <mi>xsiz</mi> <mo>-</mo> <mi>xOsiz</mi> </mrow> <mrow> <mi>xTsiz</mi> </mrow> </mfrac> <mo>]</mo> <mo>•</mo> <mo>[</mo> <mfrac> <mrow> <mi>ysiz</mi> <mo>-</mo> <mi>yOsiz</mi> </mrow> <mrow> <mi>yTsiz</mi> </mrow> </mfrac> <mo>]</mo> </mrow> </math><a href="#fnref17" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn18" role="doc-endnote"><p>Only reported if the <code>--packetmarkers</code> option is used.<a href="#fnref18" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn19" role="doc-endnote"><p>Only reported if the <code>--packetmarkers</code> option is used.<a href="#fnref19" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn20" role="doc-endnote"><p>Only reported if the <code>--packetmarkers</code> option is used.<a href="#fnref20" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn21" role="doc-endnote"><p>Only reported if the <code>--packetmarkers</code> option is used.<a href="#fnref21" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
</ol>
</section>
</body>
</html>
|
