-
Notifications
You must be signed in to change notification settings - Fork 59
/
kappa.news.in
1146 lines (818 loc) · 42.1 KB
/
kappa.news.in
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
1 KAPPA_Version_2.0
A new release of KAPPA (@PACKAGE_VERSION@) is under development. The main
changes are listed below. For complete details of all
changes, see the "Release Notes" appendix in SUN/95.
2 General_changes
o Now supports 64-bit integer data.
2 New_applications
The following new applications have been added:
o CONFIGECHO is intended as a scripting tool. It displays the value
of a named entry in a group of configuration parameters.
o NDFECHO is intended as a scripting tool. It expands a given
group expression into a list of explicit NDF names, and displays
a specified subset of the expanded names.
2 Modified_applications
o CHANMAP, COLLAPSE, and MSTATS
- Four new estimators are available: FBAD, FGOOD, NBAD and
NGOOD, which produce the fraction/count of good/bad pixel
values.
o PARGET
- A new boolean parameter called VECTOR specifies the output
format to use for vector-valued parameters.
o ROTATE
- Now estimates north at the centre of the image rather than
at the bottom left corner, and uses a more accurate method.
o WCSADD
- The transfer of set attribute values from basis Frame to new
Frame can now be controlled using a new boolean parameter called
TRANSFER (previously, set attributes were always transferred). The
new default is to transfer attributes only if the two Frames have
the same class and Domain.
o WCSREMOVE
- The Frames to remove can now be specified by name as well as
by index.
1 KAPPA_Version_1.13
A new release of KAPPA (@PACKAGE_VERSION@) has been released. The main
changes are listed below. For complete details of all
changes, see the "Release Notes" appendix in SUN/95.
2 General_changes
o A new graphical style attribute called TEXTMARGIN controls
the width of margins cleared around the edges of each drawn
text string.
o Applications that report pixel scales (e.g. NDFTRACE,
WCSFRAME) now report more representative pixel scales. The pixel
scales were previously measured at the first pixel in the array.
Now the pixel scales are found at a number of places within the
array, and the median of these values are reported.
o Colourmaps added from MRAO: Dave Green's cubehelix (in two
forms), John Richer's colour spiral, and the SPECX bl2yl.
o Documentation improvements including on metacharacters,
and units of regridding parameters, and updated AST Frame
attributes.
2 Modified_applications
o ARDMASK
- The VARIANCE and DATA arrays in the NDF can now be masked
simultaneously by setting the COMP parameter to "All", which is
now the default value for COMP.
o FITSMOD
- New parameter READONLY allows FITSMOD to be used to perform
read-only edits such as "Print" and "Exist" on write-protected
NDFs, although FITSVAL and FITSEXIST tasks are recommended for
these operations.
o FFCLEAN
- Now ignores a VARIANCE component full of bad values.
o HISTOGRAM
- Now permits plotting of the histogram for data-value limits
that exceed the single-precision data range.
- The default for the AXES parameter has changed so that by
default axes are only drawn if the picture is cleared.
- New parameter WEIGHTS allows different weights to be
associated with each value in the input NDF.
- New Parameter WEIGHTSTEP defines the increment in weight
value corresponding to a single integer histogram count.
o LINPLOT
- Monotonic AXIS values are now only required if the NDF
current Frame is AXIS, or MODE="Step", or horizontal error
bars are being drawn.
o LOOK
- New format "wglist" has been added, which lists the WCS
co-ordinates and pixel values in an image, omitting bad pixels.
- New mode "All" has been added, which lists the entire
supplied NDF.
o MFITTREND
- Permits processing of very large datasets by dividing into
manageable sections.
o NDFTRACE
- Continues when it encounters an error within a WCS Frame.
o NORMALIZE
- The default for the AXES parameter has changed so that by
default axes are only drawn if the picture is cleared.
- The new ZEROFF parameter can be set TRUE to force the fit to
use an offset of zero.
o PASTE
- There is a new SHIFT parameter that applies constant shifts
of origin between successive pasted data.
o PSF
- The default for the AXES parameter has changed so that by
default axes are only drawn if the picture is cleared.
o REGRID
- The new parameter AXES allows regridding of selected
pixel axes.
- It now uses AST_REBINSEQx rather than AST_REBINx. This
introduces a NORM parameter, which permits normalisation of
the output array by the number of contributing input array
elements. Access to Parameter CONSERVE now depends on NORM,
and CONSERVE's default has switched to preserve the total
value.
o SCATTER
- The default for the AXES parameter has changed so that by
default axes are only drawn if the picture is cleared.
- The Pearson correlation coefficient of the data in the
scatter plot is now displayed, and written to the CORR output
parameter.
o SETAXIS
- For MODE="WCS" it tries to find the best WCS axis to use
when the WCS axes are crossed or not parallel to the pixel axes.
- "Linear_WCS" is a new MODE option. It is a variant of "WCS"
where the axis centres are set to the least-squares linear fit
to the values of the selected axis. This is useful for
exporting co-ordinates to software with limited FITS WCS
capabilities, such as no -TAB support, and when the
non-linearity is small.
o SHOWQUAL
- Add new QNAMES output parameter to list the attribute name
associated with each QUALITY bit.
o SQORST
- A new parameter called CONSERVE has been added, which may
be set TRUE to force total flux to be conserved in the output
NDF.
o TRANDAT
- When AUTO=FALSE, the new POFFSET parameter allows a shift
to be specified between the data co-ordinates in the input text
file, and the pixel co-ordinates in the output NDF.
o WCSALIGN
- If an input NDF has more pixel axes than the reference NDF,
an attempt will now be made to align the input using the
reference axes, whilst retaining the other axes. Thus, if a
three-dimensional spectral cube is aligned with a
two-dimensional image, the resulting output NDF would be a
three-dimensional cube, aligned spatially with the image.
- This now performs an extra normalisation step at the end to
remove the effects of aliasing between the input and output
pixel grids.
- This now performs an extra normalisation step at the end
tp remove the effects of aliasing between the input and output
pixel grids.
- The CONSERVE parameter is now used for both rebinning and
resampling. It defaults to the value of REBIN.
o WCSMOSAIC
- Added new CONSERVE and NORM parameters to control flux
conservation and pixel normalisation.
1 KAPPA_Version_1.12
A new release of KAPPA (V1.12-9) has been released. The main
changes are listed below. For complete details of all
changes, see the "Release Notes" appendix in SUN/95.
2 General_changes
o Parameters that set the plotting style can now recognise
temporary attributes that only last for the duration of a
single task, rather than persist until changed or reset. The
list of temporary attributes begin with a plus sign. See
"Temporary Attributes" in SUN/95 for examples.
o Style parameters are consistently documented as type GROUP.
2 Modified_applications
o BEAMFIT
- The model has been extended to a generalised Gaussian,
for which the shape exponent may also be a free parameter of
the fit. This feature is controlled by the new GAUSS
parameter, whose default retains the previous behaviour,
namely fitting to a normal Gaussian (shape exponent=2). There
is a new GAMMA output parameter to record the shape exponent
of the primary beam.
- Added error code KAP__LMFOJ for the most-common failure
of the fitting.
o CLINPLOT
- Parameter MODE has a new option "GapHistogram", which
behaves as "Histogram" except no flanking vertical lines are
drawn either side of a bad value.
o CONVOLVE
- A new parameter NORM determines how the output NDF is
normalised to take account of the total data sum in the PSF,
and of the presence of bad pixels in the input NDF.
- It now permits PSFs with negative areas.
o HISTAT
- Bad percentile values are no longer written to the PERVAL
output parameter.
o LINPLOT
- Parameter MODE has a new option "GapHistogram", which
behaves as "Histogram" except no flanking vertical lines are
drawn either side of a bad value.
- Parameter TEMPSTYLE is deprecated.
o LISTSHOW
- A new Parameter STEP has been added that allows a subset
of the positions identifiers between FIRST and LAST to be
displayed.
o MAKESURFACE
- Output variances can now be created for spline fits.
o NDFCOMPRESS
- Now supports "delta" compression---a lossless compression
scheme suitable for integer arrays.
o NDFTRACE
- Writes Parameter FPIXSCALE even if QUIET=TRUE.
o PASTE
- The maximum number of NDFs that can be supplied via
Parameter IN has increased from 26 to 1000.
o PSF
- A bug has fixed in the normalisation of the fit in cases
where both the NORM and GAUSS parameters are set FALSE.
o STATS
- This now derives and reports the population skewness and
kurtosis, which are also written to new SKEWNESS and KURTOSIS
output parameters. The standard deviation reported is now the
population statistic, not the sample statistic as previously.
For most practical uses the difference will be negligible. To
obtain the sample standard deviation, if appropriate, scale by
(N/(N-1))**0.5, where N is the number of values used to derive
the statistics (accessed through Parameter NUMGOOD).
- It now uses a recursive algorithm less susceptible to
rounding errors for very large datasets or where data values
are concentrated in a narrow range coupled with extreme
outliers.
o WCSMOSAIC
- A bug in the use of the WLIM parameter has been fixed.
If the VARIANCE parameter was set to YES, this bug resulted
in WLIM being scaled by an arbitrary amount, causing the bad
pixels in the output NDF to be wrong. For instance, the
entire output NDF could be filled with bad values as a
result of this bug. The bug did not occur if the VARIANCE
parameter was set to NO.
o WCSSLIDE
- A bug has been fixed that could lead to incorrect shifts
when using the ABS parameter.
1 KAPPA_Version_1.11
A new release of KAPPA (V1.11-11) is available. The main changes
are listed below. For complete details of all changes, see the
"Release Notes" appendix in SUN/95.
2 Global_changes
o Control of the verbosity of informational messages is now
possible through the environment variable MSG_FILTER. ILEVEL
and QUIET parameters that previously controlled messaging are
no longer used. See Modified_applications for details.
o Added support and documentation for the new FRACTION Frame
supplied with every NDF. Documented how NDF sections can now be
defined by percentages along each dimension.
o The default for the CATFRAME parameter (used by various
applications to indicate the Frame in which axis values should be
stored within an output catalogue) has changed. It is now the
current Frame in the WCS FrameSet associated with the input data.
o Additional colour tables from GAIA have been added.
o Application parameters that take "groups" of values are now
stored in expanded form in the HISTORY component of any output
NDFs.
2 New_applications
The following new applications have been added:
o CARPET is intended for the creation of `carpet plots' of images.
It forms a three-dimensional NDF from a two-dimensional NDF where
the original input axes are retained and the new third axis is
proportional to the data values or signal-to-noise ratios of the
input NDF.
2 Modified_applications
o APERADD, BEAMFIT, CENTROID, CREFRAME, CURSOR, LISTSHOW,
LOOK, NDFTRACE, PICCUR, PICTRANS, WCSTRAN
- Parameter QUIET has been withdrawn. Instead set the
MSG_FILTER environment variable to QUIET to control the
output messaging.
o BEAMFIT
- The map of residuals now contains the normal
`data minus fit' evaluations rather than the reverse sense.
- The total background-subtracted data sum in the
multi-Gaussian fit is now written to the output parameter SUM.
- After a bug fix it is now possible to fit beams within an
arbitrary plane of a cube.
- Relax a constraint to cater better for a poor initial
position.
o BLOCK
- The dimensionality restriction is now lifted. This
enables, for example, smoothing of a data cube in all its
dimensions simultaneously. As a consequence the AXES
parameter is withdrawn. However, you can replicate its
function by setting one of the three BOX-parameter sizes to
1 to specify the axis not being smoothed; the remaining two
BOX values of 3 or more define a plane that is smoothed
independently for all parallel planes. The independent
smoothing of axes is now generalised, so for example, you can
smooth all lines in an image or cube; or all lines, planes,
or cubes in a hypercube.
- It reports the input NDF's dimensionality if it is more
than one, before prompting for Parameter BOX.
o CHANMAP, MSTATS
- Fix bug whereby Cmean and Csigma estimators were not
amongst the allowed options.
- Allow ESTIMATOR=Median to operate on just three channels
or NDFs.
o COPYBAD
- The output NDF inherits data type of the input NDF, not that
of the NDF given by Parameter REF.
o FFCLEAN
- Now works with double-precision data.
o FFCLEAN, MSTATS, WCSMOSAIC
- Parameter ILEVEL has been withdrawn. Instead use the
MSG_FILTER environment variable to control the output
messaging.
o FITSLIST
- New Parameters ENCODING and FULLWCS allow the list of
displayed FITS cards to include cards derived from the NDF WCS
component, in addition to those read from the FITS extension.
o HISTAT
- Works for data ranges smaller than the type precision.
- The minimum sparseness increased from 4 to 16 percent to cope
with extreme outliers, at the cost of poorer handling of
quantized distributions.
- Generates a new histogram between any narrowed value limits
to yield more-accurate statistics.
o HISTOGRAM
- This now displays an improved X-axis label on its plot.
o LINPLOT
- The Y-axis Symbol has changed from the NDF's label to the name
of its plotted array component. A long Symbol including spaces
caused issues in other tasks like CURSOR, where the Symbol is used
as a column name in the output catalogue.
o LOOK
- A bug has been fixed that caused logfile output to be
truncated to 255 characters per row even if MAXLEN was greater
than 255.
o NDFCOPY
- There is a new COMP parameter that permits the QUALITY,
or VARIANCE components or the errors (square root of the
VARIANCE) to become the DATA_ARRAY in the output NDF.
o PROVSHOW
- There is a new DOTFILE parameter that permits a summary of
the provenance tree to be written to a text file in "dot"
format, suitable for visualising with third-party tools such
as Graphviz, ZGRViewer or OmniGraffle.
o REGRID
- METHOD=GAUSS can now be used when re-sampling as well as
when re-binning.
o SCATTER
- The calculation of the axis ranges now excludes any pixels
that are bad in either NDF.
o SETAXIS
- If MODE is "WCS" and the selected axis is a celestial
longitude or latitude axis, the axis units are now converted
correctly from radians to degrees.
o WCSTRAN
- There is a new SKYDEG parameter that can be used to force
celestial longitude and latitude axis values to be formatted
as decimal degrees, regardless of the setting of the Format
attributes for the axes.
1 KAPPA_Version_1.10
A new release of KAPPA (V1.10-10) is available. The main
changes so far are listed below. For complete details of all
changes, see the "Release Notes" appendix in SUN/95.
2 Modified_applications
o CHANMAP
- There are new estimators for clipped mean and clipped
standard deviation and associated new CLIP parameter for
controlling the clip level.
o CLINPLOT
- New MODE and MARKER parameters permit different ways to
show the loci of data values including the histogram
`staircase', dots or markers at each point, and lines
connecting data points (the only available mode previously).
- New SPECAXES parameter can be used to suppress the drawing
of axes around each spectrum.
- New ALIGN parameter controls whether to align the spectra
spatially with an existing picture.
o COLCOMP
- Parameter BADCOL has the additional option of an HTML
colour code.
o COLLAPSE
- There are new estimators for clipped mean and clipped
standard deviation and associated new CLIP parameter for
controlling the clip level.
- There is an improved WLIM-related WARNING message. The
calculations used to decide whether or not to issue a
warning and the reported fractions of bad values therein
have been corrected. These fractions had been in terms of
elements along the collapse axis, not the number of elements
in the output NDF.
o CONVOLVE
- No longer aborts if a slice within a cube contains no
good data.
o DISPLAY
- Parameter BADCOL has the additional option of an HTML
colour code.
o FITSMOD
- Parameter EDIT has a new option "Null". This will
nullify the value of the chosen keyword, by substituting
spaces for its value.
- Likewise there is an Null option for Field 1 of the file
format.
o HISCOM
- A new parameter called DATE has been added. This allows
the date and time of the new history record to be set explicitly
rather than to the default current time. There is a choice of
formats including Gregorian Date and Time, and Julian Date.
o LISTMAKE
- The FRAME parameter now allows the co-ordinate frame to be
specified in more ways (for example, as an AST Object dump or
the current Frame in an NDF).
o LISTSHOW
- A new option ``STCS'' has been added to the PLOT parameter.
This marks each position by drawing the shape giving in the
column specified by new parameter STCSCOL. The shape is
specified using the IVOA "STC-S" format.
o LOOK
- A new option "WLIST" has been added to the FORMAT parameter.
This produces a list in which each row contains the WCS
co-ordinates of a pixel follwoed by the pixel value.
o MSTATS
- There are new estimators for clipped mean and clipped
standard deviation and associated new CLIP parameter for
controlling the clip level.
o NDFCOPY
- A new parameter caller EXTEN has been added. This can be set
TRUE to cause any extension NDFs contained within the supplied
NDF to be modified to match the shape of the output NDF.
- A new parameter called LIKEWCS has been added. This
allows the shape of the template NDF in the WCS Frame to be
used to determine the bounds of the output NDF.
- A new logical parameter called TRIMBAD has been added. If
TRUE, the output NDF is trimmed to exclude any border of bad
pixels.
o PROVREM
- Has a new parameter called HIDE that can be set to TRUE
to hide the selected ancestors rather than permanently deleting
them. Hidden ancestors in an NDF PROVENANCE extension will in
general be ignored by subsequent applications, but all the
provenance information for hidden ancestors is retained
unchanged in the PROVENANCE extension.
o PROVSHOW
- Has a new parameter called HISTORY that can be set to TRUE
to display any history records stored in the provenance
extension of each ancestor NDF.
- Has a new parameter called HIDE that can be set to TRUE
to include "hidden" ancestors in the display. Ancestors can be
hidden using PROVREM.
o ROTATE
- Efficiency improvements have been made for rotations of 180
degrees and arbitrary angles that should greatly reduce the
memory requirements for processing cubes. Additional
efficiencies have be made for the 0-degree rotation special
case.
o STATS
- Can calculate accurate median and percentile values using
sorting by setting the new ORDER parameter to TRUE,
and optionally supplying percentiles through the new PERCENTILES
parameter. There are corresponding results parameters---MEDIAN
and PERVAL---to record these additional statistics.
o THRESH
- New result parameters NUMHI, NUMLO, NUMRANGE, and NUMSAME
return the number of changed and unchanged pixels.
1 KAPPA_Version_1.9
A new release of KAPPA (V1.9-11) is available. The main changes
are listed below. For complete details of all changes, see the
"Release Notes" appendix in SUN/95.
2 New_applications
o PROVMOD allows provenance to be modified within an NDF. The
CREATOR, DATE, and PATH components of the PROVENANCE extension
may be altered using a substitution syntax incorporating string
matching atoms and quantifiers.
o PROVREM allows selected provenance to be removed from an NDF.
Ancestors can be removed by their indices or by pattern matching
against their names.
o REGIONMASK masks an NDF using an AST Region description held
in a text file. Such descriptions can be generated, for instance,
using the commands within the ATOOLS package.
o WCSSLIDE applies a translational correction to the World
Co-ordinate System (WCS) of an NDF so that the WCS position of
a given pixel is moved by a specified amount along each WCS axis.
Thus it could be used to correct pointing errors.
2 Modified_applications
o COLLAPSE
- A COMP parameter is now available to collapse variance
and quality information.
o FFCLEAN
- This has been extended to operate on cubes, either by
processing the cubes as a set of independent one-dimensional
spectra, or as a set of independent two-dimensional images
(see the new parameter AXES). Likewise you can process a
two-dimensional NDF as a set of independent one-dimensional
spectra.
- It can store the calculated noise level in the output
variance array (see new parameter GENVAR). If the NDF is
processed as a set of spectra or images, then each
individual spectrum or image is assigned its own noise
level.
o FITSMOD
- Parameter EDIT has a new option "Amend". This will write a
new header if the chosen keyword does not exist, but will only
modify an existing header. Using this option, it is now not
necessary to know whether or not a header exists.
- Likewise there is an Amend option for Field 1 of the file
format.
o MAKESNR
- It is now faster when Parameter MINVAR is supplied on the
command line.
o MFITTREND
- Cubic-spline fitting is now available, the type of fit is
controlled by the new parameter FITTYPE. There are two subtypes
of fit selected by new parameter INTERPOL: interpolation through
specified or equally spaced knots, or smoothing at automatically
generated knots. New parameter KNOTS sets the number or maximum
number of knots respectively for the interpolation and smoothing
splines. For the former, there is an additional parameter
POSKNOT to specify knot locations.
o MSTATS
- This now offers a wider selection of statistics to combine
the supplied NDFs. Note that for consistency with other
applications, the SMODE parameter has been replaced by
ESTIMATOR. Scripts should be modified accordingly.
- There are two further new parameters: VARIANCE to control
whether or not to use variance to weight the statistics
(previously this effectively set true); and WLIM to decide
the minimum fraction of good contributing value to form a
non-bad output value.
- It uses NDF blocking to avoid excessive memory
requirements.
o PROVSHOW has a new parameter SHOW that can be used to select the
ancestors that are to be displayed (root ancestors, direct parents,
or all ancestors).
o SETBB can now use a comma-separated list of quality names
(such as created by SETQUAL) to define the bit mask instead of
a numerical value.
o SETQUAL has new parameter, READONLY, that allows the new
quality name to be flagged as "read only". This flag indicates
that an error should be reported if any subsequent attempt is
made to remove the quality name (for instance, using REMQUAL).
o WCSMOSAIC Parameter GENVAR now allows a null value. Null
requests that a value of FALSE be adopted if and only if all the
input NDFs have variance components. TRUE is used otherwise.
2 General_changes
o Parameters that require one or more WCS axes to be
specified---these are usually called USEAXIS, AXIS or AXES and
appear in applications such LINPLOT, COLLAPSE and PLUCK---now
accept generic names of those axes present (in addition to axis
Symbol or indices). These generic names are: "SPEC" to select
the spectral axis, "TIME" to pick the time axis, and "SKYLON" and
"SKYLAT" to choose the sky longitude and latitude axes
respectively.
1 KAPPA_Version_1.8
A new release of KAPPA (V1.8-9) is available. The main changes are
listed below. For complete details of all changes, see the
"Release Notes" appendix in SUN/95.
2 New_applications
o PLUCK extracts slices parallel to pixel axes from an NDF. The
slices are nominated positions that are not at pixel centres. Thus
it can be used for example, with a spectral imaging cube to extract
spectra at specified equatorial co-ordinates, or an image at a
given spectral co-ordinate.
o PROVADD modifies the provenance information stored in an NDF. It
records a second specified NDF as a direct parent of the first NDF.
o PROVSHOW displays details of the NDFs that were used in the
creation of a supplied NDF. This information is read from the
PROVENANCE extension within the NDF, and includes both immediate
parent NDFs and older ancestor NDFs.
2 Modified_applications
o ARDMASK
- This now has an option to use WCS co-ordinates in the input
NDF as the default co-ordinate system for the supplied ARD
description. See the new parameter DEFPIX.
- It can now use a two-dimensional ARD description to mask each
plane in a three-dimensional NDF.
o COLLAPSE issues a warning whenever any output values are set
bad because there are too few contributing data values. This
reports the fraction of flagged output data in comparison with
the WLIM parameter. Input data containing only bad values are
not counted in the flagged fraction, since no potential good
output value has been lost.
o FILLBAD
- This is no longer limited to two-dimensional data. The scale
lengths (parameter SIZE) may be different along each pixel axis,
and can be disabled along axes by supplying a scale length of
zero for that axis.
o MAKESURFACE parameter VARIANCE set to TRUE now writes a uniform
VARIANCE component to the output NDF. Since the constant
variance is the mean squared residual of the fit, variance
information can be created for a spline fit.
o MFITTREND
- There are three new parameters: METHOD allows a choice of
automatic de-trending methods. The first of these handles each
line independently, finding and masking features by binning and
applying a threshold. MASK stores the feature mask in an NDF.
NUMBIN specifies the number of bins for the automatic mode.
- The reported fitting ranges are now given in the current
co-ordinate system, along with the previously listed
pixel ranges in parentheses.
o PSF has a new output parameter TOTAL which returns the total
flux for the fitted Sersic function.
o SURFIT has a new parameter GENVAR to enable creation of a uniform
VARIANCE component in the output NDF. The constant variance is
the mean squared residual of the fit.
o WCSATTRIB permits the setting of multiple attributes through new
MSET option for parameter MODE, and the new parameter SETTING.
2 General_changes
Each KAPPA command can now store provenance information in its
output NDF(s) describing the input NDFs (this includes the
provenance for each input NDF).
1 KAPPA_Version_1.7
A new release of KAPPA (V1.7-10) has been made. The main changes
are listed below. For complete details of all changes, see the
"Release Notes" appendix in SUN/95.
2 New_applications
o BEAMFIT fits up to five Gaussians to beam features in a
two-dimensional NDF, given initial co-ordinates defined in one
of four modes. Various fixed and relative constraints may be
placed. It reports the coefficients and associated errors to
the terminal, an optional logfile, and to results parameters.
2 Modified_applications
o ADD now propagates the UNITS component if it is the same in
both input NDFs.
o ARDPLOT can now draw outlines around AST regions as well as
ARD regions specified through a new REGION parameter.
o DIV now propagates any UNITS, combining them into a normalised
form.
o COLLAPSE can now correctly collapse along a sky co-ordinate
axis such as right-ascension or declination.
o COLLAPSE: The co-ordinate extent over which the collapse occurs
may be retained in a dummy dimension provided a new parameter TRIM
is set to FALSE. The default of TRUE gives the current behaviour.
o FITSURFACE supports bi-cubic spline fitting and there is a new
parameter KNOTS for that. It creates a new provisional BSPLINE
variant of the POLYNOMIAL structure in the NDF being fitted.
o FITSURFACE now writes PIXEL or AXIS values to the
SURFACEFIT.COSYS component to bring it into line with AST usage.
o HISTAT has new parameters METHOD and NUMBIN that permit other
ways to obtain the mode including the peak bin of an optimally
binned histogram.
o HISTAT has additional and modified results parameters. See
the STATS changes below.
o LINPLOT has a new parameter ALIGNSYS that specifies the
co-ordinate system in which a new plot and an existing plot are
aligned when ALIGN is TRUE.
o MAKESURFACE reads the provisional BSPLINE variant of the
POLYNOMIAL structure, and thus evaluates a spline fit of the
input NDF.
o MAKESURFACE recognises GRID, PIXEL, and AXIS values for the
SURFACEFIT.COSYS component.
o MFITTREND can now cope without an inverse WCS transformation.
o MULT now propagates any UNITS, combining them into a normalised
form.
o NDFTRACE now reports a nominal pixel scale in output parameter
FPIXSCALE.
o NDFTRACE has a new output parameter, FPIXSCALE, to store
the nominal pixel scale or each axis in the current WCS Frame.
o A bug in ROTATE introduced at previous release is fixed. It can
again rotate a two-dimensional array with a dimension of one
element, or a cube with two single-element dimensions.
o SQORST has a new MODE ="PixelScale" option, and new
corresponding PIXSCALE and AXIS parameters. These allow the WCS
scales per pixel to be modified. So for example, it can resample
a spectral cube into a cube with a specified channel width.
o STATS There are two new output parameters---MAXWCS and
MINWCS---that hold formatted WCS co-ordinates of the maximum- and
minimum-valued pixels. MAXCOORD and MINCOORD parameters now
contain the corresponding numerical WCS co-ordinates, provided the
NDF being analysed has a WCS FrameSet; otherwise they continue to
hold the AXIS-component values.
o SUB now propagates the UNITS component if it is the same in
both input NDFs.
o SURFIT This now uses singular value decomposition to solve the
normal equations and hence provide the variances of the Chebyshev
polynomial coefficients, stored in the SURFACEFIT extension.
o For the polynomial fit type, SURFIT creates a SURFACEFIT
extension in the output NDF to hold the polynomial coefficients
just as FITSURFACE does.
o WCSMOSAIC: VARIANCE components may be used to weight the
input data if a new parameter VARIANCE is set to TRUE.
Parameter VARIANCE defaults to the current behaviour.
o WCSMOSAIC has new output parameters FLBND and FUBND to record
the WCS bounds of the output NDF.
1 KAPPA_Version_1.6
A new release of KAPPA (V1.6-5) is available. The main changes
are listed below. For complete details of all changes, see
the "Release Notes" appendix in SUN/95.
2 New_applications
o CUMULVEC sums values cumulatively in a one-dimensional NDF.
o ODDEVEN removes odd-even defects from a one-dimensional NDF.
To correct a two dimensional NDF of odd-even patterning in its
columns or rows, first use COLLAPSE.
2 Modified_applications
o COLLAPSE now has a WCSATTS parameter to allow control of the
frameset before collapsing occurs. This is important for estimators
whose values depend on the WCS. A new parameter VARIANCE controls
whether or not variance information present in the input NDF is
actually used.
o DISPLAY has a new parameter SQRPIX to control whether rectangular
pixels are displayed as squares or rectangles.
o FITSLIST no longer wraps its output at 79 characters.
o LINPLOT has a new parameter TEMPSTYLE. Like STYLE it
controls the plotting style, however, its assignments only apply
to the current invocation.
o LISTSHOW has new parameter LABTYPE to control the sort of
labels created---numerical or textual---when parameter LABEL
is TRUE.
o In MFITTREND fits to lines may be rejected and flagged bad in
the output data using the new parameter CLIPRMS. Given the number
of clipping standard deviations, MFITTREND locates positive
outliers from the distribution of root-mean-squared residuals of
the fits. MFITTREND has a new output parameter, ARANGES, to
record the fitting ranges found in automatic mode. The automatic
ranges are now constrained to the input NDF bounds.
o MLINPLOT now understands SpecFrames and FluxFrames.
o PSF now writes the first star position to the screen and
output parameters as well as the log file.
o ROTATE can now reorient three-dimensional NDFs, in the sense
that it will rotate all the two-dimensional planes within a
three-dimensional NDF independently, applying the same rotation
angle to each plane. The rotation plane can be parallel to any
face of the cube, and is defined by a new parameter AXES.
o WCSMOSAIC has nw eoutput parameters LBOUND and UBOUND record
thec pixel bounds of the output NDF. If parameter OUT is set to
null, the mosaic's bounds can be examined without creating a
potentially huge NDF.