forked from bcdev/beam
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathCHANGELOG.txt
2320 lines (1803 loc) · 111 KB
/
CHANGELOG.txt
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
CHANGELOG
MERIS/(A)ATSR Toolbox (BEAM)
Version 4.1
This file contains all significant changes for each BEAM release.
o 31.10.2007: Version 4.1
o 20.04.2007: Version 4.0
o 01.02.2007: Version 3.7
o 04.07.2006: Version 3.6
o 10.03.2006: Version 3.5
o 07.10.2005: Version 3.4
o 03.06.2005: Version 3.3
o 18.03.2005: Version 3.2
o 30.11.2004: Version 3.1
o 03.08.2004: Version 3.0
o 18.06.2004: Version 2.3
o 16.10.2003: Version 2.2
o 26.09.2003: Version 2.1
o 27.06.2003: Version 2.0
o 07.03.2003: Version 1.1
o 06.12.2002: Version 1.0
_____________________________________________________________________________
Changes from 4.0 to 4.1
_____________________________________________________________________________
1) New BEAM Features and Improvements
o New collocation tool (VISAT and batch-mode)
o New spectral unmixing tool (VISAT and batch-mode)
o New management of ground control points
o New geo-coding based on ground control points
o The management and display of pins has been greatly enhanced
o The spectrum tool view has been greatly enhanced
o Metadata views changed from flat table to hierarchical tree views
o Image creation is now faster
o BEAM uses a new installer based on install4J
2) Other changes (consult BEAM issue tracker for detailed information)
BEAM-706 Display metadata in tree view
BEAM-704 Exception from dataio.PinSymbol when running from Console
BEAM-699 Editable cells of pin and GCP tables
BEAM-698 Sortable table of pins and GCPs
BEAM-694 Bandarithmetic gives acces to to latitude and longitude using the provided geocoding
BEAM-691 The Cloud Probability processor cannot cope with 'MER_FRS_1P' files.
BEAM-690 Group top level tags in DIMAP
BEAM-689 GCPs supported by DIMAP
BEAM-684 Pixel-info view functions only if initially visible
BEAM-682 The SMAC Processor cannot cope with 'MER_FRS_1P' files.
BEAM-678 Change pin location by dragging
BEAM-677 Support for ground control points (GCPs)
BEAM-676 New geo-coding based on GCPs
BEAM-673 Allow for multiple spectra in spectrum view
BEAM-672 Include spectral unmixing tool
BEAM-671 Pin pixel coordinates should be floating point numbers
BEAM-669 Improve performance of FUB/WeW Water Processor
BEAM-668 Port FUB WeW Water Processor
BEAM-666 GeoTIFF writer ignores orientation angle
BEAM-660 Speedup image creation process
BEAM-659 Location of new version of Beam
BEAM-656 Support for MERIS band subset
BEAM-653 Landsat reads the raw data (unsigned bytes) wrong
BEAM-652 Smile correction cannot be applied to MER_FRS data
BEAM-653 Landsat reads the raw data (unsigned bytes) wrong
BEAM-648 GeoTIFF parameters written in wrong order
BEAM-647 export of transverse mercator projected product as geoTIF is not imported correctly in arcGIS
BEAM-649 GeoTIFF writes FLOAT32 bands only
BEAM-643 If several pins are selected, only one is deleted if trash can is choosen
BEAM-642 Show pins also if no geolocation is allocated to the product
BEAM-641 Installer does not work on Fedora7
BEAM-640 Installer fails on Ubuntu systems
BEAM-638 Element "FORMAT_DESCRIPTION" should read "DESCRIPTION"
BEAM-636 Make pin labels nicer
BEAM-635 Allow for multiple selected pins
BEAM-634 Make pin size independent of zoom factor
BEAM-633 Ask before removing pins
BEAM-632 Make pins available for all product types
BEAM-631 Revise product pin management API
BEAM-629 Check compatibility With new AT2_TOA format
BEAM-624 Support for AT1_NR__2P and AT2_NR__2P products in ENVISAT-format
BEAM-619 New graph processing framework (GPF) module
BEAM-616 Remove package org.esa.beam.framework.dataproc
BEAM-614 Not possible to re-select item in Arithmetic Expression Editor
BEAM-600 Installer doesn't work properly on Windows Vista
BEAM-599 Installer allows selecting JRE prior version 6
BEAM-587 Exception during installation on Mac
BEAM-578 Installer script fails with error message
BEAM-557 Starting VISAT on Mac OS X results in an exception
BEAM-526 Geo-boundary polygon incorrectly computed for scenes crossing 180 deg meridian twice
BEAM-496 Provide a tool for manual co-registration using GCPs
BEAM-482 Pins shall not be selected by default.
_____________________________________________________________________________
Changes from 3.7 to 4.0
_____________________________________________________________________________
1) New general BEAM Features and Improvements
o New chris-reader capabilities (drop-out correction)
o BEAM is split in to several modules
o A runtime environment for managing modules and
extension points is introduced (called ceres)
2) New VISAT Features, Improvements and Changes
o User interface has been modernised by the use of dockable tool windows
o Introducing a module manager to update, install and uninstall modules
o The open dialog is now supporting multiple formats
4) Java API Changes
o The API to monitor and indicating progress is replaced
o Several deprecated methods and classes removed
_____________________________________________________________________________
Changes from 3.6 to 3.7
_____________________________________________________________________________
1) New general BEAM Features and Improvements
o Support for CHRIS/Proba products added
o Support for ERS-1/2 ATSR and SAR products in Envisat format added
o Support for NOAA AVHRR/3 Version 5 (CLAVR-x) added
o Support for Landsat-5 TM FAST products added (special thanks to Christian Berwanger)
o Displaying more metadata of PRISM/AVNIR-2 products.
2) New VISAT Features, Improvements and Changes
o The world-map uses a low- and a high-resolution image
o The contrast stretch window has now an additional button "Distribute Evenly".
This performs an even distribution of the sliders between the first and the
last one (BEAM-46).
o PINs can now be copied to other products.
3) Fixes
o HDF5 writer can now write virtual bands.
o Changed default no data value in map-projection and mosaic processor from
10000 to 9999.
o The quick-look band name is now preserved when creating a subset or building
a subset of a product.
o When starting the SMAC processor within VISAT with an opened AATSR product
the bitmasks are not updated correctly (BEAM-524).
o Map-x and map-y are the same in result of "Copy pixel info to clipboard". (BEAM-519)
o The order of the output bands of the Mosaic processor is now preserved,
also for the second run. (BEAM-182)
o The setting "Warn, if any arithmetic exeptions is detected" in the
Band Arithmetic Editor does not work for virtual bands. (BEAM-364)
o For Aatsr products - and any other product type - that cross 180 deg
meridian more than once, the geo boundary is incorrectly composed of
two multipolygons. (BEAM-526)
o The no-data value for mosaic processor and map_proj tool are now handled
correctly.
o Fixed a problem if product scenes cross the 180 degree meridian (BEAM-462).
o Products which cross the 180 degree meridian are now correctly exported into
the Google Earth KML format. (BEAM-515)
4) Java API Changes
o Deprecated PropertyFileParameterPage(File, String) and
PropertyFileParameterPage(ParamGroup, String).
o Added PropertyFileParameterPage(File), PropertyFileParameterPage(ParamGroup).
o Enabled write support for virtual bands.
o Added class org.esa.beam.visat.modules.worldmap.WorldMapImageLoader to handle
loading of world-map image centrally.
o Added ProductIO.readProduct(File file, ProductSubsetDef subsetDef, String[] formatNames);
o Added MapProjection.hashCode() and MapProjection.equals(Object obj)
_____________________________________________________________________________
Changes from 3.5 to 3.6
_____________________________________________________________________________
1) New general BEAM Features and Improvements
o Added reader for ALOS/PRISM (CEOS format)
o Added reader for MERIS binned Level-3 (netCDF)
o Changed reader for ENVISAT: Now also supports ASAR GM
o Changed reader for generic netCDF: Now stores metadata in MPH + DSD
o Changed reader for NOAA AVHRR/3: Now supports format version 4 (CLAVR-x)
2) New VISAT Features, Improvements and Changes
o Added function to create ASAR Normalised Radar Cross Section bands
o Added scan-line time display to pixel info view
o Added color palette export
o Added non-linear filters e.g. Min, Max, Median, Mean,...
o Added Google Earth (TM) KML format export
o Improved image resolution of world map view, added 32x zoom level.
World map image can now be changed in directory auxdata/worldmap
o Metadata is now included by default in the subset definition dialog
o Flipping tool now also works for non-geocoded products
3) AATSR SST Processor Enhancements
o Added new default coefficient files. Default coefficients have been
taken from the auxillary data file
ATS_SST_AXVIEC20051205_102103_20020101_000000_20200101_000000
of the current operational AATSR SST Level-2 processor.
o Fixed a bug in the SST retrieval algorithm (night-mode, dual view)
4) Fixes
#BUG - NetCDF reader flipps products with decreasing latitude values (build #3951)
#713 - Radiance-To-Reflectance processor does not copy sensing start/stop time of processed product
#699 - A saved request for the Radiance-To-Reflectance processor cannot be re-opened
#693 - The SST processor set the "invalid" (= no-data value) to the output bands but set not the used flag
#692 - Polar stereographic projection is not considered when exporting a product to GeoTiff
#690 - Subset builder copies histogram info which does not correspond to the subset anymore
#688 - VISAT corrupts Mosaic output product.
Mosaic product parameters are stored as metadata which is not written
if preference key 'Include ADS in Metadata' is false
5) Java API Changes
o Added New CombinedFXYGeoCoding (for PRISM sensor)
o The package org.esa.beam.dataio.alos has been renamed to org.esa.beam.dataio.ceos
o The classes CeosFileReader and IllegalCeosFileException are moved to the
package org.esa.beam.dataio.ceos
o Product.set/getQuicklookBandName()
6) Other BEAM Software Changes
_____________________________________________________________________________
Changes from 3.4.1 to 3.5
_____________________________________________________________________________
1) New VISAT Features
o Statistics-Dialog is now non-modal. This means the dialog stays open while
a different band can be selected whose statistics are then displayed.
o Added new command 'Attach/Detach Pixel Geo-Coding' in the 'Tools' menu.
This feature allows to use latitudes and longitudes provides as bands as
current geo-coding. The driver for this new feature was the support of
the new MERIS FRG and FSG data products.
o Added new command 'Apply Convolution Filter' in the 'Analysis' menu.
Convolution filter can be used to generate filtered versions of a selected
band or tie-point grid.
o Added new command 'Create Elevation Band' in the 'Tools' menu. This
feature adds a new elevation band to the current product. The altitudes
are computed by looking up each pixel in a selected hi-res DEM (which is
by default the GETASSE30 DEM).
o The output parameters dialog of the map-projection dialog has been
enhanced. The parameters 'Reference pixel X', 'Reference pixel Y' and
'Orientation angle' have been added in order to support the
requirements given by ALOS/AVNIR-2 geo-codings.
2) Data Processor Enhancements
o Cloud Probability Processor:
- The processor uses now 2 improved neural networks. One is applied
over the ocean and the other over land.
- The processor is now able to write the logging output to the
directory of the output product.
o Radiance to Reflectance Processor
The new BEAM Radiance Conversion Processor converts TOA radiances into
reflectances. Currently, only MERIS Level 1b products are supported
o The Mosaic Processor supports processing of products with a pixel-based
geo-coding.
3) New general BEAM Features and Improvements
o BEAM now can read ALOS/AVNIR-2 Level-1 products.
Currently only products in the CEOS format are supported.
o The MODIS bow-tie effect has been removed. Artifacts caused by this effect
will disappear after map-projecting MODIS products.
o A basic reader for NetCDF files has been developed in order to support
GHRSST-PP products, the standard MERIS Level-3 data products and
the upcoming Level-3 products of the GlobCOLOUR project
(www.globcolour.info). Basically, the netCDF reader can support any image-
like netCDF file structure up to netCDf version
3.5. The NetCDf Java library version currently is 2.2.12.
o The new MERIS Level-1b FRG and FSG data formats are now supported in BEAM.
These data products add high accurary geo-location information the the
standard MERIS FR and FRS products. Currently MERIS FRG and FSG are not
officially available but can be generated using the AMORGOS software which
will be available soon from the Envisat Tools page at
http://envisat.esa.int/services/tools_table.html.
o Several new options are available for the "pconvert" tool:
o The options -W, -H force a specified width or height for image output.
o The option -n specifies the color that should be used for the no-data layer.
o The otpion -c specifies the file path to a text file containing a
color palette definition.
o When using an RGB profile you can use red, green and blue, or r, g and b
for setting the RGB expressions.
o The "map_proj" tool now supports pixel-based geo-coding (for MERIS FSG)
o The list of available map projections has been extended by
- Stereographic
- Stereographic, Universal Polar North
- Stereographic, Universal Polar South
4) Fixes
#094 - The MODIS bow-tie effect is now removed when MODIS products are
reprojected
#xxx - (L3) Width and height of output product was wrong by 1.
#674 - Processors tried to open every output product as Dimap.
#673 - The progress bar of the ProductGrabber was not always visible when
processing repositories
#669 - Exporting a not yet saved subset led to duplicated SubsetInfo
metadata entries or in the special HDF5 case to an exception
#663 - NullPointerException in 'Import Transect Data' fixed if shape out
of scene bounds
#641 - MapProjection was equal to all projected products within a session
when same transformation was used
#623 - (9) "Assign ROI to multiple bands" now works for non-visible bands
as well
(8) "Assign ROI to multiple products" now deselects pin usage if
no pins available in target product
(1) "Assign ROI to multiple products" now transfers ROI shapes
in pixel coordinates if the target product is spatial compatible.
This prevents from pixel shifts occuring during transformation
of the shape from the source product's to the target product's
coordinate system.
#58x - If processors are aborted by user request the message "The request
has successfully been processed" came up.
#48x - If output product is empty, IllegalArgumentException occured.
#49x - If processors are aborted by user request, *.data and *.dim were not
deleted.
#685 - Map-projection parameters not in sync with ellipsoid of given datum
from source product
#686 - Many UI label texts did not have a trailing colon.
5) Java API Changes
o ProductFileChooser.clearProductSubsetDef() added to be able to
clear it before exporting the product again
o New Processor UI
In package org.esa.beam.framework.processor.ui multiple classes
were introduced. The class MultiPageProcessorUI creates an UI where
multiple pages can be added. The classes IOParameterPage,
PropertyFileParameterPage and ProcessingParameterPage give default
implementations for use with the MultiPageProcessorUI. For creating
your own UI page, derive from ProcessingParameterPage and overwrite
addParameterToPanel().
o RasterDataNode.getGeoCoding() and setGeoCoding() were introduced so
that each band can have its own geo-coding.
o Discouraged the use of Product.getGeoCoding()
o New ResamplingFactory class
Creates a concrete resampling method by a given name.
o FXYSum
- Introduced a factory method FXYSum.createFXYSum() for creating
instances by a given order and a list of coefficients.
- Introduced a copy method FXYSum.createCopy(FXYSum fxySum).
o New AbstractGeoCoding introduced
o New Scene and SceneFactory intruduced
o New method Product.transferGeoCodingTo(..)
o New method FXYSum.createCopy()
6) Other BEAM Software Changes
The XML support libraries 'crimson.jar' and 'jaxp.jar' have been
removed from the $BEAM_HOME$/lib folder and all classpaths since
they are not required anymore. 'nc_core.jar' has been added for supporting
the NetCDF data format.
_____________________________________________________________________________
Changes from 3.4 to 3.4.1
_____________________________________________________________________________
Version 3.4.1 is a pure service release which fixes some severe problems of
version 3.4. The bug fixes are:
1) Processors did not accept empty parameters within a request file when
running in batch mode.
2) If the shape outline transparency was set to 0, the fill transparency was
ignored.
3) When overwriting an existing band using the band arithmetic and referencing
this band in the expression, an error dialog is shown.
_____________________________________________________________________________
Changes from 3.3 to 3.4
_____________________________________________________________________________
1) VISAT Improvements
o Import/export file chooser dialogs now remember their last position and
size on the screen
o Reduced memory consumption during opening an image view. Now 30% less
memory is needed for image display
o Now it is possible to reorder the bitmask definitions inside the
bitmask overlay window
o The user can now create own RGB image profiles, it's also possible to
delete profiles, except the default VISAT profiles.
If there are multiple applicable RGB image profiles, the user is prompted
to selected the desired profile.
o Spectral wavelength of a band can now be assigned to a band in the
properties dialog. The spectrum view will update itself to changes of this
properties. Also the spectral bandwidth has been made editable.
2) Data Processor Enhancements
o Level-3 Binning Processor:
- It is now possible to process multiple bands with different algoritms at once.
- Added flux-conserving resampling (provided by Thomas Lankester)
in addition to binning resampling.
- The tailoring of the geographical size of the output product can now be controled.
- Fixed the handling of products crossing the 180° meridian.
o MERIS Level-1b Cloud Probability Processor has been added.
3) Data Format Enhancements
o AVHRR/3 Level 1b Reader
- Supports NOAA -15, -16, -17 and -18.
- Reads data format version 2 and 3.
- Reads the HRPT and LAC format.
- Autodetecs and reads products with 8bit , 10bit and 16 bit and
calibrates the data with the in the metadata supplied coefficients.
- Reads matadata and flags.
o BEAM now fully supports the MERIS IODD 7.3 format changes (reprocessing 3).
The changes affect only the MERIS Level-2 product format, they are:
- The quality flag AERO_BLUE has been renamed to OOADB
- The quality flag DDV has been renamed to LARS_ON
- An additional WHITE_SCATTERER flag has been introduced for water pixels
- The band aero_opt_thick has been split into aero_opt_thick_443 (land) and aero_opt_thick_885 (water).
A new (virtual) band aero_opt_thick_550 combines the two for both land and water.
- The description of the band toa_veg changed to "MGVI - MERIS global vegetation index",
and of band boa_veg to "MTCI - MERIS terrestrial chlorophyll index"
4) Fixes
o Fixes in map-projection:
- Invalid samples in a source band are now correctly transformed to no-data
samples in the target product.
- The pixel resampling now fully considers the "valid-pixel expression" and
"no-data value" properties. (#538)
- Bitmask overlay information is now preserved from source to target bands if possible
o In the final step (map-projection) of in the L3 binning processor the output product
was not correctly closed. This was especially an issue when the output format was HDF-5,
in this case a corrupted file was created.
o The HDF-5 product writer now exports geo-coding information in a dedicated
attributes group "geo_coding".
o FLH/MCI and SMAC processors now correctly assign the spectral band index
to output bands so that the spectrum view can now also be used on their
output products
o Changed MERIS flag descriptions: "non-confidential" --> "uncertain"
o SmacProcessor: Message 'Unsupported input product of type ''. SMAC processes AATSR and MERIS L1b products.'
on new request won't appear anymore.
o Removed examples classes from beam.jar
o PConvert does not use ConsoleProgressMonitor anymore
o GETASSE30Reader did not set the file location for the products it created
o When renaming a pin, upper/lower case letters have been ignored (#456)
o Fixed problems with discontinuity in tie-point grids containing longitude and azimuth angles.
In some cases, e.g. pole closeness, longitude values have not been correctly interpolated
when tie-points values "jumped" from -180° to 180°. MERIS azimuth tie-point grids have
been corrected for the range 0° to 360°.
o Fixed the handling of negative values in the ATSR reader.
5) API Changes
o added ProductUtils.overlayBitmasks(RasterDataNode raster, BufferedImage overlayBIm): BufferedImage
o added Product.moveBitmaskDef(BitmaskDef def, int destIndex)
o added constructor Tokenizer(String source, boolean caseSensitive)
o added constructor RGBImageProfile(String name, boolean deletable)
o added RGBImageProfile.isDeletable() : boolean
o added constructor TiePointGrid(String name, int gridWidth, int gridHeight,float offsetX, float offsetY,
float subSamplingX, float subSamplingY, float[] tiePoints,int discontinuity)
_____________________________________________________________________________
Changes from 3.2 to 3.3
_____________________________________________________________________________
1) New VISAT Features:
o No-Data Overlay
Bands of a data product now determine by two means whether or not a
pixel at a certain position contains data:
- a no-data value is set and/or
- a valid-pixel expression is given.
In any case such pixels are now excluded from range, histogram and
other statistical computations.
In order to visualise the invalid pixel positions a new
'No-Data Overlay' has been introduced. Its appearance can be adjusted
in the VISAT preferences dialog.
o Property Editor
VISAT has now an editor for the most important properties of a data
product and its bands and tie point grids. The editor is invoked
either via the context menu which appears by right-clicking an item in
the product tree view or the main menu. Currently the following
properties have been made editable: name, description, units,
no-data value, valid-pixel expression and virtual band expression.
o Usage of general Expressions
All usages of bitmask expressions (solely boolean expressions comprising
flag values and the operators AND, OR and NOT) have been replaced by
general mathematic expressions. E.g. the valid pixel expression in a
for a ROI definition could now be "l2flags.LAND && reflec_6 / PI > 0.2".
This change applies also to the VISAT bitmask overlay definitions and
all data processors using a bitmask to decide if a pixel is valid or not.
o Switchable UI Look & Feel
In the VISAT preferences dialog, the look and feel of the VISAT UI can
now be changed in the VISAT preferences dialog.
o Band Arithmetic Enhancements
Some new functions and symbols are now available for math. expressions:
log10(x), exp10(x), feq(x), fneq(x), nan(x), inf(x), floor(x), round(x),
ceil(x), rint(x).
A new constant is 'NaN' (evaluates to not-a-number) and the new symbols
'X' and 'Y' represent the current pixel position in the raster data to be
processed.
o VISAT Command Line Arguments
The VISAT executable can now take product files paths as arguments.
If your desktop environment allows for, you can then associate the
"*.N1" extension of Envisat MERIS/AATSR product files or the "*.dim"
of BEAM-DIMAP files to VISAT.
For a more information on the features please refer to the VISAT help.
2) Other BEAM Changes and Improvements
o Java Runtime Environment (JRE) 1.5.0_03 is now used by default, but
source code compatibility with the JRE 1.4.2 is still provided
o The 'mapproj' tool and the Mosaic processor now prerecord the region to
be map-transformed and thus create a spatial subset before applying the
actual map-projection. This solves many situations in which certain
projections (especially automatic UTM) where not applicable.
o The dataset descriptors (DSD) of the Envisat specific product header
(SPH) is now converted to a metadata element of a data product.
o Data products now contain a metadata element 'History' which lists all
transformations performed with VISAT, e.g. subset creation and
map-projection.
3) Public BEAM Java API Changes
o Many usages of deprecated methods and classes have been replaced or
removed. The deprecated ConsoleProgressMonitor, ImageMagnifier and
ImagePanner classes have been removed from org.esa.beam.framework.ui.
o Many methods new have been added to the Product and RasterDataNode class
in order to force the use of general arithmetic expressions
(com.bc.jexp.Term)
_____________________________________________________________________________
Changes from 3.1 to 3.2
_____________________________________________________________________________
For a more detailed description of each new feature please refer to the
VISAT help.
1) New VISAT Features:
o Orthorectification:
VISAT now has a tool to orthorectify MERIS and AATSR bands. Since the
orthorectification requires the altitude above a given geodetic position,
users can choose between tie-point grid elevations or the DEM "GETASSE30"
which is the default DEM in BEAM.
o Digital Elevation Map Installation
Because of its size, the BEAM installer will not automatically install
the GETASSE30 DEM files. If a DEM is selected in VISAT, it is checked if it
is installed. If not, the user is prompted to download and install the DEM
files. VISAT can also automatically download and install the selected DEM.
For more information on the DEM installation, please refer to the
"readme.txt" or the VISAT help.
o Resampling Methods:
The map projection and orthorectification tools now offer three different
resampling methods: Nearest Neighbour, Bi-linear Interpolation and Cubic
Convolution.
o Create Subset from View:
A new entry in the context menu over an image view provides a new command
which opens the product subset dialog with the currently visible region
as predefined spatial subset.
o Pin Tool Behaviour Change:
If the pin tool is selected and you click into an image, the pin is created
and displayed immediately, the pin properties dialog does not pop-up
anymore. If the pin is the double-clicked, the diolog opens as before.
2) General BEAM Extensions:
o Data product export to GeoTIFF:
Data products can now be exported in the GeoTIFF file format. All
measurement datasets are stored as 32-bit-floating-point geophysical
values. This will enable the import of data products supported by
BEAM into many GIS and geographic imaging tools.
o Since required by orthorectification, BEAM is now able to handle
digital elevation models (DEM) in a generic way. The new class
org.esa.beam.framework.dataop.dem.ElevationModelRegistry
can be used to register new DEMs in BEAM.
o GETASSE30 Tile Import:
A product reader has also been developed in order to import
the tile files of the GETASSE30 DEM.
o Projection Tool "mapproj":
The batch mode projection tool "mapproj" now also supports orthorectification
the new pixel resampling methods. Refer to the BEAM help for usage.
o Mosaic Processor Version 2.1:
A new mosaic processor version now makes use of BEAM's orthorectification
capabilities.
o MERIS Full Resolution, Full Swath Products:
Envisat MERIS products of type MER_FRS_1P are now also supported by BEAM.
o Help System Access for VISAT Plug-Ins:
Visat plug-Ins can now have their own help-sets
(Method org.esa.beam.visat.VisatApp.addHelp)
3) Public BEAM Java API Changes:
New Methods:
org.esa.beam.framework.datamodel.AbstractBand.getPointing
org.esa.beam.visat.VisatApp.addHelp
org.esa.beam.util.SystemUtils.getBeamExtensionDirs
org.esa.beam.util.SystemUtils.getBeamAuxdataDir
org.esa.beam.util.PlugInLoader.create
New Classes & Interfaces:
org.esa.beam.framework.datamodel.Pointing
org.esa.beam.framework.datamodel.TiePointGridPointing
org.esa.beam.framework.dataop.resamp.Resampling
org.esa.beam.framework.dataop.dem.Orthorectifier
org.esa.beam.framework.dataop.dem.ElevationModel
org.esa.beam.framework.dataop.dem.ElevationModelRegistry
org.esa.beam.framework.dataop.dem.ElevationModelDescriptor
org.esa.beam.framework.dataop.dem.AbstractElevationModelDescriptor
4) Bug Fixes:
iss #394: Introduced missing GeoTIFF support into "pconvert" tool
(since BEAM build 3246)
iss #395: Switched back to JRE 1.4.1_05, since 1.4.1_07 caused a VM crash with
VISAT graticule overlays. The VM crash is a known issue at Sun and
is fixed in Java 1.5. For detailes, please refer to
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6215242
(fixed since BEAM build 3246)
iss #397: Exceptions in Processor.initProcessor have not been handled by the UI so far
(fixed since BEAM build 3246)
iss #276: Added help menu for all processor frames. An about box is now automatically
created from processor metadata. Help can also be added to processors when
started in stand-alone mode (fixed since BEAM build 3246)
iss #389: Fixed binning processor AME algorithm: values where incorrect for weights != 1.0
iss #378: Fixed +/-180 deg. problem with azimuth angles for MERIS/AATSR
iss #391: Fixed flickering and resizing of the progress bar during progress
iss #297: Fixed incorrect scaling factors in MODIS linear scaled bands.
iss #296: Fixed JAI classcast exception while "pconvert" created histogram-equalized RGB images
iss #341: Order of bands from mosaic processor was incorrect and thus spektra was not displayed
iss #340: If a mosaic processing request was saved with an easting less than the default
value, a reload of the processing request caused an exception
iss #393: The HDF4/5 product reader is now using a logger instead of System.println
iss #392: SystemUtils.getApplicationHomeDir() contained '%20' in paths containing spaces
iss #295: Fixed problem with importing pin text files
_____________________________________________________________________________
Changes from 3.0 to 3.1
_____________________________________________________________________________
1) VISAT Improvements
o VISAT can now perform an on-line version check at start up and automatically
inform the user if a new release is available on the server.
o The pin labels can now be displayed in the image view. For this purpose, a
pin now has an extra label property. Text appearence can be set in VISAT's
preferences dialog. (issue #107)
o ROI handling has been clarified, a new command "ROI to Shape" has been
introduced as an opposite to "Shape to ROI". "ROI to Shape" can also
subtract the shape from the ROI, whereas "Shape to ROI" can delete the
source shape in one step.
o It is now possible to show/hide an extra shape layer displayed in the image
view.
o The preview image in the product subset dialog is now created from the
most suitable band in a product. E.g., for AATSR L1b products we now use
an infrared channel so that night-time scenes can also be viewed.
o The misleading textual description of the MERIS Level 2 confidence flags
(PCD_X) have been changed. If a confidence flag is set, it means that the
corresponding pixel value is uncertain.
2) Map-Projections in Batch Mode
o Map-projections can now be performed in batch mode using the new command-line
tool 'mapproj' to be found in the 'bin' folder in the BEAM installation
folder. The processing request file can take the same output parameters as set
in the corresponding dialog of the map projection tool. Please find more
information about 'mapproj' in the BEAM documentation.
3) Mosaic Processor Improvements
o Parts of the Mosaic Processor have been redesigned in order to reflect
the requests of many users. The user interface is now much more intuitive
and flexible.
o Output bands are defined by input sources - a mathematical expression
formed by arbitrary input bands.
o Any number of "valid pixel conditions" determine which pixels are considered
in the output product. A condition is comprises a name and a boolean
expression. The number of matching pixels can be stored for each condition
in the output product.
o The list of input products can now also be displayed in the world map.
(issue #13)
4) Geo-location Improvements
o Geo-location has been improved in terms of the algorithms used to determine
the pixel coordinate for a given geographical coordinate. This transformation
is heavily uses in map projections and for transect and pin management.
BEAM now uses exclusively polynomial approximations. In former versions an
iterative approach has been used, when the root mean square error of the
approximation was too high. This was always the case for full orbit scenes or
scenes near the earth's poles. The disadvantage of the iterative approach was
that it was unstabe under certain conditions, e.g. near the poles, and returned
wrong pixel coordinates in such cases (issue #264).
The new algorithm now subdivides such scenes into smaller subscenes. An
appropriate pair of approximation polynomials x(lat,lon) and y(lat,lon) is
then derived for each subscene. In VISAT, the view "Analysis/Geo-Coding
Information" as been adopted to reflect the changes.
For developers: The new algorithms are implemented in the class
org.esa.beam.framework.datamodel.TiePointGeoCoding
o The map-projection now preserves "log-scaled" property of an input band, e.g.
MERIS Level 2 "algal_1". (issue #009)
5) BEAM API Changes relevant for Java developers
o IMPORTANT CHANGE: processors developed against beam.jar as of BEAM 3.0 can no longer be
run under BEAM 3.1, although we still support the processor API as of BEAM 2.3. The
reason is that the class org.esa.beam.framework.processor.Processor
implemented an unhappy interface called ProcessProgressListener which we dont want to
support anymore.
WE ARE VERY SORRY TO INCONVINCE YOU WITH THIS CODE CHANGE!
o Also many other methods in the BEAM API dealing with progress monitoring have been
deprecated or even removed. Please take a look into the API doc of interface
com.bc.progress.ProgressController which is now the preferred way to observe
progress in long running tasks.
o Implementation of org.esa.beam.framework.datamodel.TiePointGeoCoding changed
and due to this, some of its methods have been deprecated.
o The JAMA linear algebra package has been included into the BEAM API, the package
name is simply 'Jama'. Also refer to http://math.nist.gov/javanumerics/Jama/.
o The class org.esa.beam.framework.datamodel.Band has a new property: solarFlux.
6) Fixes
iss #185: The help page "Supported ENVISAT Products" was not up to date regarding
latest product MERIS L2 format changes
iss #283: MERIS L2 rectified reflectances for red/near-infrared were interchanged
iss #285: MERIS L2 yellow substance is from IODD 7.1 on log-scaled
iss #290: The VISAT navigation window cropped left and right or top and bottom of
its overview image depending on the aspect ratio of the source image.
The problem occured only with high-resolution source images such as
images of MERIS and AATSR full orbit, MERIS FR, and ASAR products.
However, this was a pure display problem and did not impact functionality
or accuracy in any way.
iss #289: The navigation window now also updates its overview image if the source
image changes.
iss #015: Search in VISAT help showed empty pages
iss #162: Problems with map-projections for very small output regions (huge pixel size)
iss #110: VISAT Spectrum Window did not snap to pins anymore
iss #142: Unhandeled exception occurred during opening an arithmetic band with
invalid expression.
iss #220: ROI is now restored again after image view is re-opened
iss #245: Import ROI definitions did not recognize shapes anymore
iss #280: Map-projected products with 180 degree meridian now correctly handled
concerning graticule overlay and pins
iss #288: Processor plug-ins now correctly take over the currently selected
product from VISAT as default value for their input product
iss #127: Console progress monitor of processors did not work anymore due to API changes
iss #155: In the L3 Binning Processor an unhandled exeption occured if run with
mixed up min. and max. latitude or longitude.
iss #287 An error in the L3 binning algorithm calculates wrong results for MLE
algorithm with a weight coefficient other than p=0.5.
iss #153: In the L3 Binning Processor an unhandled exeption occured if run with
an incorrect bitmask expression.
iss #???: The L3 Initial Processor now checks for overwriting of an already
existing bin database.
iss #???: SMAC-Processor now checks for positive horizontal visibility
iss #???: SMAC-Processor now tests the input product for correct type when selected from GUI.
iss #???: SMAC-Processor now uses solar fluxes read from GADS of MERIS l1b input product.
_____________________________________________________________________________
Changes from 2.3 to 3.0
_____________________________________________________________________________
1) VISAT Image Navigation & Display Enhancements
o New Navigation Tool Window: This important tool window replaces the
magnifier and panner mini-windows which where used in former versions to
scroll and zoom images. Besides many useful features many users will
appreciate the option to synchronize zooming and panning of multiple views
of spatially compatible data products.
o New Zoom- and Panner Tools: In addition to the navigation window, standard
zooming and panning can also be done using the mouse.
o New image scroll bars, Zoom all: All image views now have scroll bars.
If both scroll bars are visible, a tiny "Zoom all" button is now available
which scales the image to fit the entire window (limited by the minimal
zoom factor).
o Open multiple views per band: Multiple views of any any band can be displayed
by using "View" -> "Open Image View" multiple times. Double clicking a band
does not open multiple views. With multiple views it is possible to view an
overview in one window and a zoomed detail in another window.
o ROI definition Window, new "Zoom to": The ROI definition dialogue has got a
new funtion "zoom to ROI" (magnifier icon) which causes the image view to be
panned to the ROI.
o Pin Manager Window, new "Zoom to": The Pin Manager dialogue has got a new
funtion "zoom to ROI" (magnifier icon) which causes the image view to be
panned to the selected Pin.
o Redesign of image display: Overall imaging performance has significantly been
improved and image/graphic display has completely been redesigned and now internally
uses a multi-layer model. The VISAT preferences dialog reflects the layer architecture
by providing a property page for each graphic layer.
o New image interpolation methods: The interpolation method for the image display
can be changed in the preferences: either nearest neighbour, bi-linear or bi-cubic.
This effects the only the display of images when zoomed in or out.
o Improved graticule overlay: The graticule overlay has been re-implemented to
be more robust for large products (e.g. AATSR orbits) or those extending over
the day-line. Several new options for the graticule have been added in the
preferences dialogue.
2) Mosaic Processor
o A new Level 3 processor has been added. The main intention of the Mosaic
Processor is to provide an alternative sampling algorithm that is able to
create Moiré-free images. Especially when the pixel size of the input product(s)
and the bin size ofthe target L3 product are of the same order of magnitude,
the Mosaic Processor yields good results.
o The generated L3 products are well suited for the production of images (e.g. RGB
compositions). To provide as much as possible flexibility, the Mosaic Processor
allows the use of any number of bands for the L3 product, the creation of virtual
bands, the definition of criteria that include and exclude pixels with certain
properties by using expressions.
o The Mosaic processor includes several operation modes. Some of these are not
accessible through the graphical user interface but through the Processing
Request File. Please refer to the on-line documentation for details (Section
Processing Request Concept).
3) VISAT UI Improvements
o The product info and pixel info tabs on the left of the VISAT main frame
are now composed of floatable internal tool windows. You can now
float the geo-location window and switch back to the product tab.
o Former VISAT versions used a scrollable desktop pane which contained
the metadata and image views. Now we used a tabbed desktop pane
without scrollbars. The views have their own scrollbars instead.
o The "window" menu now contains new usefull window arrangement/tiling
methods
4) Other BEAM 3.0 Improvements and Changes
o Image Export as GeoTIFF:
The displayed image can be exported as GeoTiff (Tiff with geo-location).
This function is available via "File" -> "Export ..." -> "Export displayed
image" -> set "File Type" to GeoTiff, or on the right mouse button when
the mouse is over an image view ("Export displayed image")
o "Export Metadata" to clipboard and file:
This is a new command which lets a user copy the content of a metadata
view to the clipboard or a file. It is available either from the "File" ->
"Export" or the right mouse button when over a meta data view.
o "Export Transect Pixels" to clipboard and file:
When a shape has been drawn the pixel values of all bands along a transect
can be exported to a file or the clipboard using "File" -> "Export" or the
right mouse button. The export is done in the same format as for
"Export ROI pixels".
o Spatial product subsets are now also applied to the associated tie-point
grid datasets. In former versions, the tie point grid data has been left
untouched, only pixel offsets have been adapted to reflect the spatial
subset. Especially verly large product subsets will profite from this
improvement.
o Sequentially appearing progress monitors have been replaced by a
single progress monitor showing progress on two simultaneously
displayed progress bars.
o The lower resolution limit of the Level 3 processor is lowered to
1 m so that also high resolution satellite products can be processed.
Additionally, the estimated size of the final Level 3 product is
updated in the user interface to give feedback about the expected
processing times and storage requirements.
o The BEAM/DIMAP format Version 1.4.1 now supports sensing start/stop time
of the first/last scan line in a scene raster.
o BEAM 3.0 uses the JRE (Java Runtime Environment) 1.4.2 again. The bottle
necks concerning imaging performance using 1.4.2 have been removed.
o VISAT's tiny panner and magnifier windows which appeared in an image view
have been dismissed in favour of the new Navigation Window
o The layer properties from VISAT's preferences dialog are now assigned to
the current view only. The layer properties for a new view is obtained from
the current VISAT preferences.
6) BEAM API changes
o IMPORTANT: Make sure to recompile your BEAM programs and VISAT plug-ins a
against the new 3.0 version of $BEAM_HOME$/lib/beam.jar:
Many methods of the BEAM API have been deprecated and many
API changes affect the org.esa.beam.visat.VisatApp interface due
to the new user interface.
o org.esa.framework.ui.ImageDisplay now inhertits from the new,
and very common com.bc.swing.GraphicsPane. This component stores
the scene defining graphical objects in separate layers, namely the
com.bc.layer.LayerModel. A separate view model allows to define
the currently visible area of the scene. The layer model is
com.bc.layer.LayerModel.
o BEAM now uses the new framework com.bc.progress to allow for
observation of nested processes. All other progress listener
interfaces used formerly are now deprecated.
o The org.esa.beam.beam.framework.util.SystemUtils now returns a correctly
formatted path to the BEAM home directory also on Linux/Unix operating
systems.
7) Bugfixes
o ENVISAT ASAR geo-location accuracy has significantly been improved.
o ENVISAT ASAR products often contain optional datasets. Such datasets are
described by a DSD within a product but have no associated ADS or MDS.
BEAM raised an IndexOutOfBoundsException when such products were opened.
o A deleted shape is really deleted now and not shown again. A ROI created
from a shape is not influenced by the shape's deletion.
o A scaling error in the contrast stretch dialog occasionally raised
exceptions when displaying histograms with extreme peeks.
o When processing high resolution products with the Level 3 processor, the
processor sometimes hangs. This behaviour is fixed. Also, the memory usage
is significantly lowered.
o In the SMAC processor, it was possible to set invalid values for the
horizontal visibility leading to unpredictable behaviour. The validity
range is now bound.
o If a write-protected BEAM/DIMAP product has been opened and modified with
VISAT, a consecutive save caused VISAT to hang. The 'save' command now
prompts a warning dialog which tells the user, that the opened product is
write protected and can not be saved unless the user removes the write
protection. Otherwise the 'saveAs' command must be used.
o A bug in the BEAM logging facilities is fixed that caused the creation
of a ghost directory on any usage of the BEAM JavaAPI. When using the
beam.jar in your own programs a "log" directory was automatically and
unintentionally created by BEAM in the users home directory (Linux/Unix
only).
_____________________________________________________________________________
Changes from 2.2 to 2.3
_____________________________________________________________________________
BEAM Extensions
1) MERIS Product Reader Extensions
o Added support for the new MERIS RR/FR Level 2 product format. Backward
compatibility with older formats is ensured. The new product changes are
a) the band "aero_epsilon" has been replaced by "aero_alpha".
b) new flags and corresponding bitmask definitions have been added:
BLUE_AERO - Aerosol with high Angstrom Exponent selected for atmosphere correction
BPAC_ON - Bright Pixels Atm. Correction activated (water)
LOW_SUN - Sun low above horizon (or conversely high Sun zenith angle)
c) The DDV flag is now exclusively evaluated above land (LAND=true)
o MERIS Level 2 products now have new composed quality bitmasks: For
all bands of a Level 2 product an explicite "invalid" bitmask has been added.
o MERIS Level 2 bands are now automatically displayed with important bitmasks
overlays initially visible.
o The unit of the MERIS Level 2 Photosynthetically Active Radiation (photosyn_rad)
has changed from myEinstein / (m^2) to myEinstein / (m^2 * s)
o The ENVISAT Product Reader API for C and IDL has also been updated to version
2.0.4 in order to reflect the latest format changes.
2) Optimized Support for Large Files / Low Memory
o VISAT now can perform some more operations on product data without actually loading
data from a product file into memory and keeping it there. This allows for working with
large product files even if the computer is low in memory. The operations are:
a) Statistics, Histogram, Scatter Plot, Profile Plot, and Transect Coordinate List.
b) Opening single band and RGB images
o In order to control loading of raster data for image creation we have added a new
option in the behaviour page of the preferences dialog. It's label is
"On image open, load raster data only if size is below" and the value is the number
of megabytes a raster can have so that it is completely loaded into memory. If you
set this value to zero, VISAT will never load and store raster data in memory for image
creation.
3) Map Projection Extensions
o Two new types of map projections are now supported: "Lambert Conformal Conic" and
general "Transverse Mercator".
o The projection tool has been extended by the dialog "Projection Parameters" in order
to parameterise the new projection types.
4) VISAT ROI Extensions
o The "File/Export" menu now contains a new command "Export ROI Pixels" which
can be used to export the values of all pixels contained in a ROI either to
the clipboard or a text file.