source: trunk/CHANGES @ 670

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

Substantive changes aimed at addressing ticket #72. The moment-0 map is now able to be saved to a FITS file. As far as the user is concerned, the functionality is as
for the mask cube, with equivalent parameters. The documentation has also been updated.

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