source: trunk/CHANGES @ 687

Last change on this file since 687 was 687, checked in by MatthewWhiting, 14 years ago

Updating CHANGES.

File size: 32.4 KB
Line 
1Duchamp version 1.1.9 (2009/03/19)
2-------------------------------------
3
4Improvements:
5
6* There is now the ability to save the moment-0 map as a FITS
7  file. This is controlled by the parameters flagOutputMomentMap and
8  fileOutputMomentMap, which work in the same way for the mask file.
9
10* There is a new parameter flagRejectBeforeMerging that, when true,
11  rejects sources according to the minPix/minChannels requirements
12  before the merging and growing is done. This defaults to false (so
13  default behaviour is as before). Thanks to Tobias Westmeier for
14  suggesting this and the above improvement.
15
16* The way the beam is specified in the absence of the BMAJ/BMIN/BPA
17  parameters has been slightly changed. The use of "beamSize" was
18  somewhat ambiguous (it meant the number of pixels covered by the
19  beam, not the FWHM), so new parameters have been introduced. The
20  beam can be specified by beamArea (which replaces beamSize), or
21  beamFWHM (the FWHM of the beam in pixels). If beamFWHM is provided,
22  it will be used, else the beamArea will be.
23
24* There is a new parameter searchType that allows the user to choose
25  how the searching is done. The behaviour up till now has been to
26  search the 2D channel maps one at a time to build up the 3D
27  detections. This is the default, and can be obtained by setting
28  searchType=spatial. Alternatively, you can set searchType=spectral
29  to do the searching in the 1D spectra.
30
31* Profiling of the code has led to a few changes that have sped up
32  some calculations, particularly those involving the median. Rather
33  than using std::sort, the code now simply uses std::nth_element,
34  which shows a substantial speedup factor.
35
36* When using the objectList parameter, the maps will now only show the
37  selected objects, rather than all detected objects.
38
39* There is a new verification test that looks at the "growing"
40  functionality.
41
42Bug fixes:
43
44* When saving a mask FITS file, there was an occasional memory leak
45  that caused Duchamp to crash (only when the cube was suitably
46  large). This has been fixed.
47
48* The median calculation had a bug that led to an incorrect value
49  being reported. The difference will not be great (the element of an
50  array being reported as the median was out by one), but could be
51  noticeable depending on the dataset.
52
53* The MW range parameters did not respond to the use of a
54  subsection. They should refer to channel ranges in the original
55  cube, and changes have been made to the code to reflect this.
56
57* There was an occasional error in writing out FITS keywords, due to
58  the way comment strings were intialised. This has been improved and
59  made more robust.
60
61* Testing with gcc-4.3.2 showed a number of compilation warnings &
62  errors, which have been fixed.
63
64* The Gaussian smoothing kernel was too small - it is now made big
65  enough to encompass all possible values. It was also being
66  incorrectly scaled. This had no functional effect on the detection
67  of objects, but for other uses was incorrect. This has been
68  rectified.
69
70* Some outputs that weren't caught by the verbose flag now are.
71
72
73Code development notes:
74
75  The following notes only apply if you want to use the code as a
76  library, rather than the stand-alone package. These have generally
77  come out of the ASKAP software development. If you just use the
78  stand-alone package, they won't be a concern.
79
80* The API for storing detected objects has changed, making it more
81  robust from a programming point of view.
82
83* Additional versions of some functions (and the Gaussian smoothing
84  class) have been added - this has come out of the ASKAP development
85  work.
86
87* A number of instances of "unsigned int" being used for loops have
88  been changed to iterators or "size_t". There shouldn't be any
89  functional change from this -- the code should just build more
90  cleanly.
91
92* The Detection class now records whether the parameters have been
93  set, and unsets that flag when objects are merged. This allows
94  external programs to track which objects have been merged and deal
95  with them appropriately.
96
97
98Duchamp version 1.1.8 (2009/07/20)
99----------------------------------
100
101Improvements:
102
103* The final source list can now be sorted on one of a range of object
104  parameters: x-value, y-value, z-value, ra, dec, vel, w50, iflux,
105  pflux (integrated and peak flux respectively), or snr. Simply use
106  the new input parameter sortingParam. Its default value is vel, so
107  the default behaviour stays the same.
108
109* The FDR method involves calculating how many pixels are
110  correlated. This previously involved multiplying the beam area by 2,
111  implying that 2 neighbouring channels were correlated. This factor
112  is now a user-selectable parameter, so that if you know how many
113  spectral channels should be correlated, you can set the parameter
114  FDRnumCorChan and the FDR calculation will be done correctly.
115
116* Screen output now has more information on the growing threshold when
117  the cube statistics are printed.
118
119
120Bug fixes:
121
122* When reading in previous detections, there was a bug causing a
123  segmentation fault. This has been fixed and made more robust.
124
125* There was an apparent bug when writing out the reconstructed cubes
126  to a FITS file that caused the new file to be very large. Changing
127  the cfitsio function used has fixed this.
128
129* Using NCP projections near the equator could result in a large
130  stream of error messages, due to coordinate transformations being
131  done in blank regions outside of the acceptable range of world
132  coordinates. This has been fixed.
133
134* The function that grows objects had a major bug, that stopped it
135  working when flagAdjacent=false. This has been fixed and should work
136  fine.
137
138* The input parameter spectraTextFile was not being read
139  properly. This has been remedied.
140
141* The units for the integrated flux were wrong for some types of pixel
142  flux units. This has been fixed.
143
144* A minor bug caused incorrect calculation of the 20% widths.
145
146* All calls to uint were changed to unsigned int, as some compilers
147  had problems recognising that they were the same thing.
148
149* src/fitsHeader.cc was missing an include statement for stdlib.h,
150  again causing some compilers to fail.
151
152
153Duchamp version 1.1.7 (2009/01/16)
154----------------------------------
155
156Improvements:
157
158* The mask file that can be created with flagMask can now specify
159  which object a given detected pixel belongs to, by taking the object
160  ID as its value. This applies if you set flagMaskWithObjectNum=true
161  (it defaults to false, which means each detected pixel has the value
162  1). Non-detected pixels still have the value 0.
163
164* The names of the output FITS files are now able to be specified
165  directly by input parameters. These will override the default names
166  that Duchamp provides.
167
168* The Karma annotation file now specifies a font - previously it did
169  not and so was at the mercy of whatever was specified in other
170  annotation files being viewed at the same time. Please let me know
171  if the font I've chosen (lucidasans-12) is not suitable.
172
173* The default flag, used in the absence of 'E', 'S' or 'N', is now '-'
174  rather than blank. This will ensure that each column in the results
175  file has something in it.
176
177* The configure script is somewhat more robust to non-standard
178  systems, particularly when the X11 libraries are in unusual
179  places. It can also deal with the slightly different way that
180  wcslib-4.3 installs itself.
181
182* The installation part of the Makefile was altered so that the
183  symbolic link Duchamp that points to Duchamp-1.1.7 does not have the
184  absolute path encoded in it. This will enable the files to be moved
185  around at a later date.
186
187Bug Fixes:
188
189* Fixed a bug that caused problems when the flux units were less than
190  5 characters long (e.g. 'K')
191
192* The new velocity width values were not getting proper headers in the
193  VOTable output. This has been remedied.
194
195* Minor improvements to help non-pgplot use
196
197* Minor fix in WCS functionality.
198
199* Minor fixes to the FitsHeader class.
200
201* Improved FITS data reading, that doesn't require a nullarray
202  array. This will reduce memory usage.
203
204* Improved subsection parsing, particularly for non-standard WCS
205  systems.
206
207* Improving the memory allocation of the Cube class.
208
209* Fixed a bug that meant the growthThreshold values were sometimes
210  being lost.
211
212* Improving the way the growing and merging is done, particularly in
213  the case of non-adjacent merging.
214
215* Fixed a scaling bug in the GaussSmooth function.
216
217Other:
218
219* Numerous changes to the code that do not affect how Duchamp itself
220  runs, but were necessary for code development with the Duchamp
221  libraries (primarily as a part of the ASKAP code development).
222
223
224Duchamp version 1.1.6 (2008/09/08)
225----------------------------------
226
227New features:
228
229* The velocity widths can now be quoted in two additional ways: the
230  full width at 50% of the peak flux (ie. the FWHM) and the full width
231  at 20% of the peak flux (w_50 and w_20 respectively). The w_50
232  parameter is now quoted in the results printed to the screen
233  (instead of w_VEL), but all three are written to the results file.
234
235* The facility now exists to bypass the searching step and go straight
236  to the output stage using a list of previously detected objects. The
237  list is extracted from a previously-created log file. The user can
238  change the way the spectra are plotted (e.g. choose to plot
239  integrated rather than peak spectra), and select a subset of the
240  detected objects to be printed to individual postscript files. Use
241  the input parameter usePrevious (set to true) to use this facility,
242  and provide a list of objects using the objectList parameter
243  (eg. 1,2,4,7-10,15)
244
245* A new parameter "growthThreshold" has been created, that goes with
246  "threshold". If you manually specify a threshold, and you wish to
247  grow detections, you need to manually specify a growthThreshold (in
248  flux units).
249
250Bug fixes:
251
252* Cubes that do not have a spectral axis (such as Stokes cubes) were
253  causing memory leaks and crashing, due to some assumptions of the
254  existence of the spectral axis. These bugs have been fixed, so that
255  Duchamp will run on such cubes, although the WCS transforms may not
256  always work appropriately. Please let me know via bug reports of
257  difficulties you encounter!
258
259* The growing function has had a few bugs fixed and is now more
260  efficient.
261
262* The FDR method was previously overriding any manually-specified
263  threshold. This has been fixed so that if the user specifies
264  threshold=X, then the FDR method is not called.
265
266* Some undefined things were happening with textual output when no
267  objects were detected. This has been fixed.
268
269* Memory leaks caused by FITS WCS irregularities have been fixed
270  (specifically, if a FITS header had NAXIS=2 but more than two WCS
271  axes were defined).
272
273
274
275Duchamp version 1.1.5 (2008/03/20)
276----------------------------------
277
278Bug fixes:
279* A major bug was discovered in the calculation of integrated
280  fluxes. The flux was incorrectly being weighted by the spatial size
281  of the detection, resulting in a (often considerable) overestimation
282  of the integrated flux. This has been corrected.
283
284* The beam size calculation was also incorrect, being out by a factor
285  of 1/ln(2).
286
287* The "make install" command previously failed to work properly if the
288  library had not been created. This has been fixed so that the
289  installation works even if there is no library file.
290
291New Features:
292* You can now provide a new flux unit string, so that the pixel fluxes
293  will be converted to these new fluxes before any calculations are
294  done. This is done with the newFluxUnits input parameter. The new
295  units should be directly convertible from the old ones (given by the
296  BUNIT header -- e.g. if BUNIT = Jy/beam, you can give newFluxUnits
297  as mJy/beam, but not mJy).
298
299* You can now specify the precision used in the output files for flux,
300  velocity and S/N ratio columns, via new input parameters precFlux,
301  precVel and precSNR. These will apply to the VOTable output as well
302  as the text table and information on the spectral plots.
303
304* The Karma annotation files previously provided just a circle at the
305  spatial location of the detected object. You now have the option to
306  draw a border around the detected pixels (in a similar manner to the
307  PGPLOT moment maps). Karma does not do this perfectly, so the lines
308  may not line up exactly with the pixel borders, so the option
309  remains to keep using the circles. This is controlled by the
310  parameter "annotationType", with possible options being "borders"
311  (the default) or "circles".
312
313* There is a new function getMetadata() that loads the header and WCS
314  data, but no pixel information. This is only of interest if you are
315  doing code development with the Duchamp library -- it does not
316  affect the running of Duchamp itself.
317
318Duchamp version 1.1.4 (2008/02/15)
319----------------------------------
320
321Most of the changes incorporated in this update result from ASKAP code
322development (that makes use of some of the Duchamp functionality),
323but do not actually affect the way Duchamp runs (other than, in a
324couple of cases, making it a bit faster). Changes that are
325relevant for regular users of Duchamp are as follows:
326
327* A new option has been made available (thanks to Mary Putman et al
328  for the suggestion!) to save the spectra of all detected objects in
329  a text file. This has the form of one column for the spectral
330  coordinates and one column of fluxes for each object. This is
331  enabled by the input parameters flagTextSpectra and spectraTextFile.
332
333* Slight changes to the output include he formatting of the way the
334  detected objects are written to the log file. This meant the
335  verification files were also updated. Also the cube statistics are
336  not printed to the results file if a user threshold is specified (as
337  they are not calculated!).
338
339* The determination of beam size has been made more reliable, as has
340  the BUNIT determination.
341
342* Fixed a bug that meant source merging was not done for 2D images
343  (not usually a problem, as the source-finding takes care of this,
344  but came up in parallelisation development).
345
346Duchamp version 1.1.3 (2008/01/08)
347----------------------------------
348
349A minor update that just improves the build process. The location of
350the wcslib include files was not specified correctly, so that some
351machines were unable to find them. The configure script has been fixed
352so that the compilation should work in all cases.
353
354Some minor changes have also been made to the code in the PixelMap
355directory, and to param.cc, to fix warnings or errors that may appear
356in compilation.
357
358However, there are no changes to the actual workings of the code in
359this minor version, so if you have a working version of Duchamp 1.1.2
360there is probably no reason to update.
361
362Duchamp version 1.1.2 (2007/12/07)
363----------------------------------
364
365Compilation:
366
367* The compilation had problems working correctly when the cfitsio and
368  wcs libraries were not in standard locations. The configure script
369  has been tweaked to make sure the libraries are found.
370
371* Problems with compiling in the absence of pgplot have been fixed,
372  and it should now compile fine.
373
374* Improved the configure script for use with Mac OS X and gfortran.
375
376
377Bugfixing:
378
379* A major problem with the text-based output was fixed. The widths of
380  the columns were not being calculated correctly, and were running
381  together. This should no longer be the case.
382
383* There was a bug in the way Duchamp interpreted spectral axes,
384  particularly AIPS types such as FELO-HEL, leading to incorrect
385  scaling of the velocity axis. This has been fixed, so that
386  non-standard types are now dealt with appropriately and the velocity
387  scaling should be accurate.
388
389* Another bug meant the beam correction was always applied to the
390  integrated spectra, regardless of whether the flux units involved
391  the beam (e.g. Jy/beam). This has been fixed. Note that the values
392  of the integrated flux presented in the results table were always
393  calculated correctly.
394
395* Other minor changes to improve the speed and efficiency, especially
396  of the merging code.
397
398New user parameters:
399
400* There is now the possibility to save a FITS file that contains a
401  mask array, indicating where the detected objects are. This is
402  governed by the flagOutputMask parameter.
403
404* The header information that is printed at the start of the results
405  file -- that is, the list of parameters, the statistics of the cube,
406  and the number of detections -- can now be written to a separate
407  file. Set the flagSeparateHeader parameter to true or 1 and it will
408  go to the file indicated by the headerFile parameter (the default is
409  duchamp-Results.hdr).
410
411* A "scaleMax" parameter has been added, so that the wavelet
412  reconstruction can include only a specified range of scales (for
413  instance, if one wants to search just for narrow features such as
414  absorption lines).
415
416* A "flagRobustStats" parameter has been added. This allows the user
417  to elect to use robust statistics (median and median absolute
418  deviation from the median) to estimate the noise parameters. If set
419  to false, the mean and standard deviation will be used. The default
420  value is true.
421
422New Feature:
423
424* When Duchamp is run on a 2D image (i.e. with no spectral output), it
425  now produces a postscript file that shows information each
426  individual source plus the image cutout of the source. This is
427  similar to the spectral output file, but without the spectra. The
428  filename is given by the spectraFile parameter.
429
430* Ability to save a FITS file containing a mask array, with pixel
431  values of 1 for pixels in a detected object, and 0 elsewhere.
432
433
434Duchamp version 1.1.1 (2007/07/20)
435------------------------------------
436
437Minor update to the release, with just a few changes:
438
439* The verification script was generating diffs due to differences in
440  the precision of some calculations when done on different machines.
441  One of these was the integrated flux, and this has been corrected so
442  that the same value should appear on all machines.
443  The verification script has also changed so that just the number of
444  sources and their positions are tested, as well as the
445  logfiles. This should avoid the reporting of spurious differences.
446
447* The grey-scale used in the image cutouts (in the spectral plots) has
448  been inverted. This makes it consistent with the scale used in the
449  maps, and hopefully easier to see when printing.
450
451* The configure/make system has been altered to make it easier to
452  install, and to specify different external libraries. In particular,
453  it is now not necessary to have PGPLOT installed on your system to
454  run Duchamp. In the absence of PGPLOT, Duchamp will run as normal,
455  just without any graphical output. Some source code needed to be
456  restructured to make this work. Please read the README file, or the
457  Installation appendix in the User's Guide, for complete details.
458
459* The time of completion is now written to the log file, so that the
460  user can have some idea of how long the program took.
461
462
463Duchamp version 1.1 (2007/05/17)
464------------------------------------
465
466Changes made since the last numbered release:
467
468EFFICIENCY OF EXECUTION:
469
470* Major change to the way detections are stored. They are now recorded
471  via run-length encoding in the x-y plane, and stored as collections
472  of channel-maps. This improves the memory usage and the speed of
473  execution (particularly for routines such as the merging
474  routines). The memory usage has also been improved by changing the
475  way the list of detected objects is stored.
476
477SMOOTHING:
478
479* Addition of ability to spatially smooth the cube before
480  searching. This is done with a Gaussian kernel, the size and shape
481  of which can be specified by the user, using the parameters kernMaj
482  & kernMin (which are the FWHM for the major & minor axes -- if
483  kernMin is not given it is assumed to match kernMaj) and kernPA (the
484  position angle of the major axis).  There is a new parameter
485  smoothType that distinguishes this method from the spectral (Hanning)
486  smoothing already in use.
487
488DETECTIONS:
489
490* Changed the way detection is done -- now only search in 2D images,
491  keeping all detections (ie. no minimum-pixel requirement). This
492  should be the same as doing both the 1D and 2D searches with the
493  minimum pixel requirement in, but simpler. The rejection is done at
494  the end after all the merging and growing has been done. This leads
495  to a larger number of intermediate detections (ie.  the number
496  before merging), which may increase the run-time slightly, although
497  this is offset by the changes to the efficiency (see above).
498
499* Increased the range over which objects can be grown to match the
500  threshSpatial & threshVelocity parameters, as well as rejecting new
501  pixels based on the BLANK and MW tests.
502
503INPUTS:
504
505* There has been a subtle change in the way BLANK pixels are dealt
506  with. To enable trimming of BLANK pixels, users should use the new
507  parameter flagTrim. The parameters flagBlankPix and blankPixVal are
508  no longer accessible via the parameter file -- warning messages are
509  given if they are provided in the parameter file.
510
511* Added ability to specify a statsec, so that the statistics are only
512  calculated from a given subsection of the cube, rather than the full
513  cube.
514
515* The subsections can also specify the ability to remove a border of n
516  pixels from the edges of an axis (ie. n from the start and from the
517  end) -- as requested in Trac ticket #5.
518
519* Changed the default value of the reconDim parameter from 3 to 1, and
520  the default value of the flagATrous parameter to false.
521
522OUTPUTS:
523
524* The output now includes three different estimates of the "centre" of
525  the detection: peak location, centroid (flux-weighted), or average.
526
527* Some slight improvements to the user feedback during execution.
528
529* Spectral output now includes the baseline, if one was fitted. The
530  format of the plot headers is slightly changed, to stop information
531  falling off the edge of the page.
532
533* Added command-line option -x to directly disable the PGPLOT X-window
534  map plotting. This overrides the setting of flagXOutput in the
535  parameter file.
536
537* Fallback spectral units (in case the FITS header fails to record
538  them) changed to SPC, but code has been fixed so that any problem
539  should be caught before this becomes an issue.
540
541BUGFIXES:
542
543* Fixed bug (Trac ticket #4) that meant the velocity units were not
544  correctly dealt with. Duchamp should be more robust for different
545  velocity axis setups now.
546
547* Fixed bug (ticket #9) with the VOTable output, where the tags were
548  not closing.
549
550* Fixed a bug that meant the integrated fluxes were not calculated
551  properly -- no allowance was made for the number of spatial
552  pixels. This should also work properly for 2D images now as well.
553
554* Fixed minor bug in calculating the flux threshold from the p-value
555  threshold when the FDR method is used. This did not affect the
556  actual thresholding, merely the quoted flux threshold in the results
557  file. Also, the MW channels are kept out of the p-value threshold
558  determination if they are being flagged.
559
560
561
562Duchamp version 1.0.7 (2006/11/22)
563----------------------------------
564
565One new feature, and some improvements and bug-fixes.
566
567* The user can now elect to Hanning-smooth the spectral direction of
568  the cube before the searching is done. This can be done instead of the
569  wavelet reconstruction (although if both are selected, the
570  reconstruction takes precendence). This functionality is switched on
571  and off by the flagSmooth parameter, and the width of the Hanning
572  kernel is governed by the hanningWidth parameter.
573
574* The smoothed array can also be written to a FITS file and read in at
575  the start in the same manner as the reconstructed array.
576
577* Several improvements have been made to the memory
578  management. Several memory leaks were fixed, and the memory usage of
579  Duchamp is considerably less, which will be a help for running it on
580  large cubes. The speed of some routines has also been improved, by
581  removing unnecessarily repetitive loops.
582
583* The sorting routines have been changed, and should now be slightly quicker
584  (and a bit more robust).
585
586* Enabled the scale bar (plotted on the 0th moment map in the spectral
587  output file) to be able to deal with much finer spatial scales (as
588  may be expected from VLBI data).
589
590* Other minor changes to code and presentation.
591
592
593Duchamp version 1.0.6 (2006/11/01)
594----------------------------------
595
596Some incremental improvements and changes to the code:
597
598* The statistics used for the detection are now calculated once for
599  the entire cube, rather than being calculated separately for each
600  channel map and spectrum. This results in a uniform threshold value
601  across the entire cube. The way the statistics calculations are
602  implemented in the code was changed, using a new statistics class.
603
604* This means we can report a peak signal-to-noise value for each
605  detection. This is given in the text-based output, as well as in the
606  summary information above the spectral output for each source.
607
608* The user can now elect not to have the moment map displayed in a
609  PGPlot window, through the use of the new flagXOutput
610  parameter. This should help in cases of running Duchamp on a dumb
611  terminal (with no X-display capabilities), or as part of a batch
612  script where the continual popping-up of the PGPlot window might
613  become annoying.
614
615* There are different Flags reported for the case of an object lying on
616  the spatial edge and spectral edge of the cube (E and S respectively).
617
618* A few minor bug fixes:
619  - When providing a subsection, any axes with the range given by *
620    had the pixel values offset incorrectly. This has been fixed.
621  - Negative searches now correctly invert the reconstructed array
622    when it is read in from a file.
623
624* Other minor changes to the code, to improve memory handling and
625  remove redundant arrays and variables.
626
627
628Duchamp version 1.0.5 (2006/09/06)
629----------------------------------
630
631Since version 1.0, there have been a range of mostly minor
632changes. These are generally bug-fixes, thanks to feedback from a
633number of users, as well as a few extra features.
634
635Here is a summary of the changes since version 1.0:
636
637USER INTERFACE:
638
639* The user is now able to enter the value of flag parameters in the
640  parameter file as strings, as well as integers (so one can enter
641  true or 1 to give the same result).
642
643GRAPHICAL OUTPUT:
644
645* Added a new function that draws the edge of the blank region on the
646  maps and image cutouts. There is a new flag parameter --
647  drawBlankEdges -- that controls the use of this function (the
648  default is true).
649  Also, the edge of the field is plotted on the image cutouts as a
650  yellow line. This distinguishes it from the purple blank pixel
651  dividing line.
652
653* The size of the tick mark in the image cutout (indicating the
654  spatial scale of the image) is now adaptable, so that it shows the
655  scale that best fits the image (ranging from 1 arcsec to 15
656  degrees). (This is a change from the previous standard length of 15
657  arcmin.)
658
659* The zoomed spectrum had its flux scale determined by all points in
660  the zoom box,including those flagged by the Milky Way (MW)
661  range. This has been fixed so that any MW channels will not affect
662  the flux scaling, potentially improving the appearance of objects
663  detected close in velocity to strong MW emission or absorption.
664
665* Improved Karma Annotation file output, so that files without good
666  WCS are dealt with appropriately.
667
668TEXT-BASED OUTPUT:
669
670* The position resolution in the IAU-format names has been increased,
671  so that distinct objects close to one another are more readily
672  distinguished.  Overlapping sources at different velocities may
673  still have the same name, but this is a more general problem.
674
675* The presentation of the results in tabular format has been improved,
676  so that the precision of faint sources is sufficient to show their
677  flux, for instance, is not 0. This also applies to the information
678  presented above the spectral plots.
679
680* Improved error and warning reporting, so that the formatting and
681  presentation of information is clearer.
682
683FITS I/O RELATED:
684
685* The previous version was did not deal well with 4 (or greater)
686  dimensions in the FITS file -- the memory allocation was badly done,
687  and the axes needed to be in a particular order. This has been
688  fixed, so that the FITS I/O routines can now handle any sized FITS
689  file, with axes in any order (as long as there are two spatial and one
690  spectral axes).
691
692* When the FITS file does not have a rest frequency defined, there is
693  no way to transform the frequency axis into velocity. In this case,
694  the spectral axis is left as frequency, and put into units of MHz.
695
696* If the beam size is not indicated by the FITS header (through the
697  BMAJ and BMIN keywords), the user can manually specify the size
698  through the parameter file (using parameter beamSize).
699
700* The FITS I/O routines make use of the command fits_file_exists. This
701  was introduced into the CFITSIO package from version 2.5, so Duchamp
702  will only work with this version or higher. Version 3+ is preferred.
703
704OTHER BUG-FIXING:
705
706* Several bugs related to the blank-pixels were dealt with.
707  The correct values were not propagating through correctly, meaning
708  that the default values were being used. Also, there was the
709  potential for blank pixels to be detected when the FDR method was
710  used. Finally, the image cutout displays occasionally did not
711  obscure the blank pixels. All these problems should be fixed now.
712
713* The FDR setup routine was occasionally failing with a segmentation
714  fault, due to it accessing unallocated memory. This has been fixed.
715
716* Fixed bugs that affected the way 2D images (rather than 3D cubes)
717  were dealt with. The minChannels test failed when minChannels=0.
718
719* If there is no beam information in the FITS header, the user can now
720  enter a beam size as a parameter.
721
722* Other minor fixes to the code, to improve its structure and
723  robustness.
724
725
726Duchamp version 1.0 (2006/06/30)
727--------------------------------
728
729The first full release version.
730
731Several major changes compared to previous version:
732
733* Incorporated a FitsHeader class, to keep track of header information
734  (including WCS) from the FITS file. All units-related calculations
735  are done with this class, such as conversion to velocity, and
736  pixel-to-WCS conversion.  The main advantage of this is improved
737  speed of execution, more adaptable to different units, and improved
738  code (easier for me!).
739
740* Able to select the dimensionality of the reconstruction, rather than
741  just doing it in 3-D.
742
743* Robust text output, so that the columns are sized correctly given
744  the data being written, and the relevant units (derived from the
745  FITS header) are included in the output table.
746
747* Improved the way the reconstructed image is saved and read back in,
748  with a better naming scheme and a better set of new FITS header
749  keywords. The MW headers are now not written.
750
751Other, more minor changes include:
752
753* MW channels now not set to 0, but just ignored for searching
754  purposes (and for the scaling of the spectral output -- they are
755  plotted though and highlighted with a hashed box).
756
757* The scale bar in the moment map in the spectral output file has its
758  length indicated.
759
760* Improved VOTable output, with more information about the way Duchamp
761  was run.
762
763* Made sure all statistics calculations in the reconstruction are
764  based on robust (ie. median) methods.
765
766Also moved to an autoconf based configure/make compilation, for ease of use.
767
768
769Duchamp version 0.9.2 (2006/06/27)
770--------------------------------
771
772* Added the use of warning flags for detections: for either edge
773  location or negative enclosed flux.
774
775* A new command line option added so that the user can specify a FITS
776  file to be searched with the default parameters, rather than giving
777  a full parameter file.
778
779* The scale bar on the moment cutout now works in general case, using
780  an iterative process to get to the correct length.
781
782* RA axes are now done correctly on the full-scale maps.
783
784* Various coding fixes, improving the readability of the code,
785  particularly regarding the declaration of temporary variables.
786
787* Changed the way the time of execution is called : now using time.h
788  functions, rather than a system call.
789
790* Changed output in Detection/outputDetection.cc for the pixel
791  information of detected objects (the info printed above the spectral
792  plots) -- now print out number of voxels in object, and have
793  improved the formatting a little.
794
795* Improved the functionality of saving the FITS file containing the
796  reconstructed array. Added ability to save and read back in the MW
797  parameters when saving a reconstructed cube (if a reconstructed cube
798  has different MW range to that being considered, it would cause
799  problems). ReadRecon now just returns a FAILURE and will reconstruct
800  the cube anew.
801
802* Changed default value of flagGrowth to 0.
803
804
805
806Duchamp version 0.9 (2006/05/05)
807--------------------------------
808
809First public release version.
Note: See TracBrowser for help on using the repository browser.