I: pbuilder: network access will be disabled during build I: Current time: Thu Aug 13 23:49:12 +14 2020 I: pbuilder-time-stamp: 1597312152 I: Building the build Environment I: extracting base tarball [/var/cache/pbuilder/buster-reproducible-base.tgz] I: copying local configuration I: mounting /proc filesystem I: mounting /sys filesystem I: creating /{dev,run}/shm I: mounting /dev/pts filesystem I: redirecting /dev/ptmx to /dev/pts/ptmx I: policy-rc.d already exists I: Copying source file I: copying [starlink-ast_8.6.3+dfsg-1.dsc] I: copying [./starlink-ast_8.6.3+dfsg.orig.tar.gz] I: copying [./starlink-ast_8.6.3+dfsg-1.debian.tar.xz] I: Extracting source gpgv: unknown type of key resource 'trustedkeys.kbx' gpgv: keyblock resource '/var/lib/jenkins/.gnupg/trustedkeys.kbx': General error gpgv: Signature made Wed Sep 26 23:20:56 2018 +14 gpgv: using RSA key BAFC6C85F7CB143FEEB6FB157115AFD07710DCF7 gpgv: Can't check signature: No public key dpkg-source: warning: failed to verify signature on ./starlink-ast_8.6.3+dfsg-1.dsc dpkg-source: info: extracting starlink-ast in starlink-ast-8.6.3+dfsg dpkg-source: info: unpacking starlink-ast_8.6.3+dfsg.orig.tar.gz dpkg-source: info: unpacking starlink-ast_8.6.3+dfsg-1.debian.tar.xz dpkg-source: info: using patch list from debian/patches/series dpkg-source: info: applying Rename-library.patch dpkg-source: info: applying use_std_automake.patch dpkg-source: info: applying The-external-PAL-library-in-Debian-is-called-starlink-pal.patch dpkg-source: info: applying Use-cminpack-provided-by-Debian.patch dpkg-source: info: applying workround_armhf_compiler_bug.patch dpkg-source: info: applying Disable-tests.patch I: using fakeroot in build. I: Installing the build-deps I: user script /srv/workspace/pbuilder/17241/tmp/hooks/D01_modify_environment starting debug: Running on codethink-sled14-arm64. I: Changing host+domainname to test build reproducibility I: Adding a custom variable just for the fun of it... I: Changing /bin/sh to bash Removing 'diversion of /bin/sh to /bin/sh.distrib by dash' Adding 'diversion of /bin/sh to /bin/sh.distrib by bash' Removing 'diversion of /usr/share/man/man1/sh.1.gz to /usr/share/man/man1/sh.distrib.1.gz by dash' Adding 'diversion of /usr/share/man/man1/sh.1.gz to /usr/share/man/man1/sh.distrib.1.gz by bash' I: Setting pbuilder2's login shell to /bin/bash I: Setting pbuilder2's GECOS to second user,second room,second work-phone,second home-phone,second other I: user script /srv/workspace/pbuilder/17241/tmp/hooks/D01_modify_environment finished I: user script /srv/workspace/pbuilder/17241/tmp/hooks/D02_print_environment starting I: set BASH=/bin/sh BASHOPTS=checkwinsize:cmdhist:complete_fullquote:extquote:force_fignore:globasciiranges:hostcomplete:interactive_comments:progcomp:promptvars:sourcepath BASH_ALIASES=() BASH_ARGC=() BASH_ARGV=() BASH_CMDS=() BASH_LINENO=([0]="12" [1]="0") BASH_SOURCE=([0]="/tmp/hooks/D02_print_environment" [1]="/tmp/hooks/D02_print_environment") BASH_VERSINFO=([0]="5" [1]="0" [2]="3" [3]="1" [4]="release" [5]="aarch64-unknown-linux-gnu") BASH_VERSION='5.0.3(1)-release' BUILDDIR=/build BUILDUSERGECOS='second user,second room,second work-phone,second home-phone,second other' BUILDUSERNAME=pbuilder2 BUILD_ARCH=arm64 DEBIAN_FRONTEND=noninteractive DEB_BUILD_OPTIONS='buildinfo=+all reproducible=+all parallel=8' DIRSTACK=() DISTRIBUTION= EUID=0 FUNCNAME=([0]="Echo" [1]="main") GROUPS=() HOME=/var/lib/jenkins HOSTNAME=i-capture-the-hostname HOSTTYPE=aarch64 HOST_ARCH=arm64 IFS=' ' LANG=C LANGUAGE=nl_BE:nl LC_ALL=C MACHTYPE=aarch64-unknown-linux-gnu MAIL=/var/mail/root OPTERR=1 OPTIND=1 OSTYPE=linux-gnu PATH=/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/i/capture/the/path PBCURRENTCOMMANDLINEOPERATION=build PBUILDER_OPERATION=build PBUILDER_PKGDATADIR=/usr/share/pbuilder PBUILDER_PKGLIBDIR=/usr/lib/pbuilder PBUILDER_SYSCONFDIR=/etc PIPESTATUS=([0]="0") POSIXLY_CORRECT=y PPID=17241 PS4='+ ' PWD=/ SHELL=/bin/bash SHELLOPTS=braceexpand:errexit:hashall:interactive-comments:posix SHLVL=3 SUDO_COMMAND='/usr/bin/timeout -k 24.1h 24h /usr/bin/ionice -c 3 /usr/bin/nice -n 11 /usr/bin/unshare --uts -- /usr/sbin/pbuilder --build --configfile /srv/reproducible-results/rbuild-debian/tmp.yFBzkHWV2X/pbuilderrc_yaBT --hookdir /etc/pbuilder/rebuild-hooks --debbuildopts -b --basetgz /var/cache/pbuilder/buster-reproducible-base.tgz --buildresult /srv/reproducible-results/rbuild-debian/tmp.yFBzkHWV2X/b2 --logfile b2/build.log starlink-ast_8.6.3+dfsg-1.dsc' SUDO_GID=117 SUDO_UID=110 SUDO_USER=jenkins TERM=unknown TZ=/usr/share/zoneinfo/Etc/GMT-14 UID=0 USER=root USERNAME=root _='I: set' http_proxy=http://192.168.101.16:3128 I: uname -a Linux i-capture-the-hostname 4.4.0-186-generic #216-Ubuntu SMP Wed Jul 1 05:35:21 UTC 2020 aarch64 GNU/Linux I: ls -l /bin total 4928 -rwxr-xr-x 1 root root 1216928 Apr 18 2019 bash -rwxr-xr-x 3 root root 34808 Jul 11 2019 bunzip2 -rwxr-xr-x 3 root root 34808 Jul 11 2019 bzcat lrwxrwxrwx 1 root root 6 Jul 11 2019 bzcmp -> bzdiff -rwxr-xr-x 1 root root 2227 Jul 11 2019 bzdiff lrwxrwxrwx 1 root root 6 Jul 11 2019 bzegrep -> bzgrep -rwxr-xr-x 1 root root 4877 Jun 25 2019 bzexe lrwxrwxrwx 1 root root 6 Jul 11 2019 bzfgrep -> bzgrep -rwxr-xr-x 1 root root 3641 Jul 11 2019 bzgrep -rwxr-xr-x 3 root root 34808 Jul 11 2019 bzip2 -rwxr-xr-x 1 root root 14264 Jul 11 2019 bzip2recover lrwxrwxrwx 1 root root 6 Jul 11 2019 bzless -> bzmore -rwxr-xr-x 1 root root 1297 Jul 11 2019 bzmore -rwxr-xr-x 1 root root 35576 Mar 1 2019 cat -rwxr-xr-x 1 root root 60256 Mar 1 2019 chgrp -rwxr-xr-x 1 root root 56096 Mar 1 2019 chmod -rwxr-xr-x 1 root root 64368 Mar 1 2019 chown -rwxr-xr-x 1 root root 134632 Mar 1 2019 cp -rwxr-xr-x 1 root root 129536 Jan 18 2019 dash -rwxr-xr-x 1 root root 97136 Mar 1 2019 date -rwxr-xr-x 1 root root 76736 Mar 1 2019 dd -rwxr-xr-x 1 root root 93752 Mar 1 2019 df -rwxr-xr-x 1 root root 138848 Mar 1 2019 dir -rwxr-xr-x 1 root root 75984 Jan 10 2019 dmesg lrwxrwxrwx 1 root root 8 Sep 27 2018 dnsdomainname -> hostname lrwxrwxrwx 1 root root 8 Sep 27 2018 domainname -> hostname -rwxr-xr-x 1 root root 31368 Mar 1 2019 echo -rwxr-xr-x 1 root root 28 Jan 8 2019 egrep -rwxr-xr-x 1 root root 27256 Mar 1 2019 false -rwxr-xr-x 1 root root 28 Jan 8 2019 fgrep -rwxr-xr-x 1 root root 68792 Jan 10 2019 findmnt -rwsr-xr-x 1 root root 34824 Apr 23 09:38 fusermount -rwxr-xr-x 1 root root 174304 Jan 8 2019 grep -rwxr-xr-x 2 root root 2345 Jan 6 2019 gunzip -rwxr-xr-x 1 root root 6375 Jan 6 2019 gzexe -rwxr-xr-x 1 root root 89656 Jan 6 2019 gzip -rwxr-xr-x 1 root root 18440 Sep 27 2018 hostname -rwxr-xr-x 1 root root 64472 Mar 1 2019 ln -rwxr-xr-x 1 root root 52544 Jul 27 2018 login -rwxr-xr-x 1 root root 138848 Mar 1 2019 ls -rwxr-xr-x 1 root root 108552 Jan 10 2019 lsblk -rwxr-xr-x 1 root root 76840 Mar 1 2019 mkdir -rwxr-xr-x 1 root root 64480 Mar 1 2019 mknod -rwxr-xr-x 1 root root 39736 Mar 1 2019 mktemp -rwxr-xr-x 1 root root 38840 Jan 10 2019 more -rwsr-xr-x 1 root root 47112 Jan 10 2019 mount -rwxr-xr-x 1 root root 14344 Jan 10 2019 mountpoint -rwxr-xr-x 1 root root 138736 Mar 1 2019 mv lrwxrwxrwx 1 root root 8 Sep 27 2018 nisdomainname -> hostname lrwxrwxrwx 1 root root 14 Feb 15 2019 pidof -> /sbin/killall5 -rwxr-xr-x 1 root root 35560 Mar 1 2019 pwd lrwxrwxrwx 1 root root 4 Apr 18 2019 rbash -> bash -rwxr-xr-x 1 root root 43712 Mar 1 2019 readlink -rwxr-xr-x 1 root root 68440 Mar 1 2019 rm -rwxr-xr-x 1 root root 39624 Mar 1 2019 rmdir -rwxr-xr-x 1 root root 19144 Jan 22 2019 run-parts -rwxr-xr-x 1 root root 114016 Dec 23 2018 sed lrwxrwxrwx 1 root root 4 Aug 13 23:49 sh -> bash lrwxrwxrwx 1 root root 4 Aug 13 22:27 sh.distrib -> dash -rwxr-xr-x 1 root root 31384 Mar 1 2019 sleep -rwxr-xr-x 1 root root 72480 Mar 1 2019 stty -rwsr-xr-x 1 root root 59424 Jan 10 2019 su -rwxr-xr-x 1 root root 31416 Mar 1 2019 sync -rwxr-xr-x 1 root root 449416 Apr 24 2019 tar -rwxr-xr-x 1 root root 10560 Jan 22 2019 tempfile -rwxr-xr-x 1 root root 88968 Mar 1 2019 touch -rwxr-xr-x 1 root root 27256 Mar 1 2019 true -rwxr-xr-x 1 root root 14264 Apr 23 09:38 ulockmgr_server -rwsr-xr-x 1 root root 30728 Jan 10 2019 umount -rwxr-xr-x 1 root root 31384 Mar 1 2019 uname -rwxr-xr-x 2 root root 2345 Jan 6 2019 uncompress -rwxr-xr-x 1 root root 138848 Mar 1 2019 vdir -rwxr-xr-x 1 root root 34824 Jan 10 2019 wdctl -rwxr-xr-x 1 root root 946 Jan 22 2019 which lrwxrwxrwx 1 root root 8 Sep 27 2018 ypdomainname -> hostname -rwxr-xr-x 1 root root 1983 Jan 6 2019 zcat -rwxr-xr-x 1 root root 1677 Jan 6 2019 zcmp -rwxr-xr-x 1 root root 5879 Jan 6 2019 zdiff -rwxr-xr-x 1 root root 29 Jan 6 2019 zegrep -rwxr-xr-x 1 root root 29 Jan 6 2019 zfgrep -rwxr-xr-x 1 root root 2080 Jan 6 2019 zforce -rwxr-xr-x 1 root root 7584 Jan 6 2019 zgrep -rwxr-xr-x 1 root root 2205 Jan 6 2019 zless -rwxr-xr-x 1 root root 1841 Jan 6 2019 zmore -rwxr-xr-x 1 root root 4552 Jan 6 2019 znew I: user script /srv/workspace/pbuilder/17241/tmp/hooks/D02_print_environment finished -> Attempting to satisfy build-dependencies -> Creating pbuilder-satisfydepends-dummy package Package: pbuilder-satisfydepends-dummy Version: 0.invalid.0 Architecture: arm64 Maintainer: Debian Pbuilder Team Description: Dummy package to satisfy dependencies with aptitude - created by pbuilder This package was created automatically by pbuilder to satisfy the build-dependencies of the package being currently built. Depends: libcminpack-dev, debhelper (>= 11), liberfa-dev, libstarlink-pal-dev, ghostscript, latex2html, perl (>= 5.18.1-5), texlive, texlive-font-utils, texlive-latex-extra, texlive-science dpkg-deb: building package 'pbuilder-satisfydepends-dummy' in '/tmp/satisfydepends-aptitude/pbuilder-satisfydepends-dummy.deb'. Selecting previously unselected package pbuilder-satisfydepends-dummy. (Reading database ... 19168 files and directories currently installed.) Preparing to unpack .../pbuilder-satisfydepends-dummy.deb ... Unpacking pbuilder-satisfydepends-dummy (0.invalid.0) ... dpkg: pbuilder-satisfydepends-dummy: dependency problems, but configuring anyway as you requested: pbuilder-satisfydepends-dummy depends on libcminpack-dev; however: Package libcminpack-dev is not installed. pbuilder-satisfydepends-dummy depends on debhelper (>= 11); however: Package debhelper is not installed. pbuilder-satisfydepends-dummy depends on liberfa-dev; however: Package liberfa-dev is not installed. pbuilder-satisfydepends-dummy depends on libstarlink-pal-dev; however: Package libstarlink-pal-dev is not installed. pbuilder-satisfydepends-dummy depends on ghostscript; however: Package ghostscript is not installed. pbuilder-satisfydepends-dummy depends on latex2html; however: Package latex2html is not installed. pbuilder-satisfydepends-dummy depends on texlive; however: Package texlive is not installed. pbuilder-satisfydepends-dummy depends on texlive-font-utils; however: Package texlive-font-utils is not installed. pbuilder-satisfydepends-dummy depends on texlive-latex-extra; however: Package texlive-latex-extra is not installed. pbuilder-satisfydepends-dummy depends on texlive-science; however: Package texlive-science is not installed. Setting up pbuilder-satisfydepends-dummy (0.invalid.0) ... Reading package lists... Building dependency tree... Reading state information... Initializing package states... Writing extended state information... Building tag database... pbuilder-satisfydepends-dummy is already installed at the requested version (0.invalid.0) pbuilder-satisfydepends-dummy is already installed at the requested version (0.invalid.0) The following NEW packages will be installed: autoconf{a} automake{a} autopoint{a} autotools-dev{a} bsdmainutils{a} debhelper{a} dh-autoreconf{a} dh-strip-nondeterminism{a} dwz{a} file{a} fontconfig-config{a} fonts-dejavu-core{a} fonts-gfs-baskerville{a} fonts-gfs-porson{a} fonts-lmodern{a} gettext{a} gettext-base{a} ghostscript{a} ghostscript-x{a} groff-base{a} intltool-debian{a} latex2html{a} libarchive-zip-perl{a} libavahi-client3{a} libavahi-common-data{a} libavahi-common3{a} libbrotli1{a} libbsd0{a} libcairo2{a} libcminpack-dev{a} libcminpack1{a} libcroco3{a} libcups2{a} libcupsimage2{a} libdbus-1-3{a} libelf1{a} liberfa-dev{a} liberfa1{a} libexpat1{a} libfile-stripnondeterminism-perl{a} libfontconfig1{a} libfreetype6{a} libglib2.0-0{a} libgraphite2-3{a} libgs9{a} libgs9-common{a} libgssapi-krb5-2{a} libharfbuzz-icu0{a} libharfbuzz0b{a} libice6{a} libicu63{a} libidn11{a} libijs-0.35{a} libjbig0{a} libjbig2dec0{a} libjpeg62-turbo{a} libk5crypto3{a} libkeyutils1{a} libkpathsea6{a} libkrb5-3{a} libkrb5support0{a} liblcms2-2{a} libmagic-mgc{a} libmagic1{a} libncurses6{a} libnetpbm10{a} libnspr4{a} libnss3{a} libopenjp2-7{a} libpaper-utils{a} libpaper1{a} libpipeline1{a} libpixman-1-0{a} libpng16-16{a} libpoppler82{a} libpotrace0{a} libptexenc1{a} libpython-stdlib{a} libpython2-stdlib{a} libpython2.7-minimal{a} libpython2.7-stdlib{a} libreadline7{a} libsigsegv2{a} libsm6{a} libssl1.1{a} libstarlink-pal-dev{a} libstarlink-pal0{a} libsynctex2{a} libteckit0{a} libtexlua52{a} libtexlua53{a} libtiff5{a} libtool{a} libuchardet0{a} libwebp6{a} libwoff1{a} libx11-6{a} libx11-data{a} libxau6{a} libxaw7{a} libxcb-render0{a} libxcb-shm0{a} libxcb1{a} libxdmcp6{a} libxext6{a} libxi6{a} libxml2{a} libxmu6{a} libxpm4{a} libxrender1{a} libxt6{a} libxxhash0{a} libzzip-0-13{a} lsb-base{a} m4{a} man-db{a} mime-support{a} netpbm{a} perl-doc{a} po-debconf{a} poppler-data{a} poppler-utils{a} preview-latex-style{a} python{a} python-minimal{a} python2{a} python2-minimal{a} python2.7{a} python2.7-minimal{a} readline-common{a} sensible-utils{a} t1utils{a} tex-common{a} texlive{a} texlive-base{a} texlive-binaries{a} texlive-font-utils{a} texlive-fonts-recommended{a} texlive-lang-greek{a} texlive-latex-base{a} texlive-latex-extra{a} texlive-latex-recommended{a} texlive-pictures{a} texlive-science{a} ucf{a} x11-common{a} xdg-utils{a} The following packages are RECOMMENDED but will NOT be installed: curl dbus dvipng fonts-droid-fallback gsfonts krb5-locales libarchive-cpio-perl libcupsfilters1 libfile-mimeinfo-perl libglib2.0-data libgpm2 libltdl-dev libmail-sendmail-perl libnet-dbus-perl libx11-protocol-perl lmodern lynx minpack-dev ps2eps ruby shared-mime-info tex-gyre texlive-plain-generic tipa tk wget x11-utils x11-xserver-utils xdg-user-dirs 0 packages upgraded, 147 newly installed, 0 to remove and 0 not upgraded. Need to get 216 MB of archives. After unpacking 559 MB will be used. Writing extended state information... Get: 1 http://deb.debian.org/debian buster/main arm64 libbsd0 arm64 0.9.1-2 [97.4 kB] Get: 2 http://deb.debian.org/debian buster/main arm64 bsdmainutils arm64 11.1.2+b1 [185 kB] Get: 3 http://deb.debian.org/debian buster/main arm64 libuchardet0 arm64 0.0.6-3 [65.0 kB] Get: 4 http://deb.debian.org/debian buster/main arm64 groff-base arm64 1.22.4-3 [869 kB] Get: 5 http://deb.debian.org/debian buster/main arm64 libpipeline1 arm64 1.5.1-2 [29.8 kB] Get: 6 http://deb.debian.org/debian buster/main arm64 man-db arm64 2.8.5-2 [1258 kB] Get: 7 http://deb.debian.org/debian buster/main arm64 libpython2.7-minimal arm64 2.7.16-2+deb10u1 [395 kB] Get: 8 http://deb.debian.org/debian buster/main arm64 python2.7-minimal arm64 2.7.16-2+deb10u1 [1292 kB] Get: 9 http://deb.debian.org/debian buster/main arm64 python2-minimal arm64 2.7.16-1 [41.4 kB] Get: 10 http://deb.debian.org/debian buster/main arm64 python-minimal arm64 2.7.16-1 [21.0 kB] Get: 11 http://deb.debian.org/debian buster/main arm64 libssl1.1 arm64 1.1.1d-0+deb10u3 [1382 kB] Get: 12 http://deb.debian.org/debian buster/main arm64 mime-support all 3.62 [37.2 kB] Get: 13 http://deb.debian.org/debian buster/main arm64 libexpat1 arm64 2.2.6-2+deb10u1 [85.4 kB] Get: 14 http://deb.debian.org/debian buster/main arm64 readline-common all 7.0-5 [70.6 kB] Get: 15 http://deb.debian.org/debian buster/main arm64 libreadline7 arm64 7.0-5 [134 kB] Get: 16 http://deb.debian.org/debian buster/main arm64 libpython2.7-stdlib arm64 2.7.16-2+deb10u1 [1890 kB] Get: 17 http://deb.debian.org/debian buster/main arm64 python2.7 arm64 2.7.16-2+deb10u1 [305 kB] Get: 18 http://deb.debian.org/debian buster/main arm64 libpython2-stdlib arm64 2.7.16-1 [20.8 kB] Get: 19 http://deb.debian.org/debian buster/main arm64 libpython-stdlib arm64 2.7.16-1 [20.8 kB] Get: 20 http://deb.debian.org/debian buster/main arm64 python2 arm64 2.7.16-1 [41.6 kB] Get: 21 http://deb.debian.org/debian buster/main arm64 python arm64 2.7.16-1 [22.8 kB] Get: 22 http://deb.debian.org/debian buster/main arm64 poppler-data all 0.4.9-2 [1473 kB] Get: 23 http://deb.debian.org/debian buster/main arm64 sensible-utils all 0.0.12 [15.8 kB] Get: 24 http://deb.debian.org/debian buster/main arm64 ucf all 3.0038+nmu1 [69.0 kB] Get: 25 http://deb.debian.org/debian buster/main arm64 tex-common all 6.11 [53.1 kB] Get: 26 http://deb.debian.org/debian buster/main arm64 libmagic-mgc arm64 1:5.35-4+deb10u1 [242 kB] Get: 27 http://deb.debian.org/debian buster/main arm64 libmagic1 arm64 1:5.35-4+deb10u1 [115 kB] Get: 28 http://deb.debian.org/debian buster/main arm64 file arm64 1:5.35-4+deb10u1 [66.4 kB] Get: 29 http://deb.debian.org/debian buster/main arm64 gettext-base arm64 0.19.8.1-9 [120 kB] Get: 30 http://deb.debian.org/debian buster/main arm64 libsigsegv2 arm64 2.12-2 [32.3 kB] Get: 31 http://deb.debian.org/debian buster/main arm64 m4 arm64 1.4.18-2 [198 kB] Get: 32 http://deb.debian.org/debian buster/main arm64 autoconf all 2.69-11 [341 kB] Get: 33 http://deb.debian.org/debian buster/main arm64 autotools-dev all 20180224.1 [77.0 kB] Get: 34 http://deb.debian.org/debian buster/main arm64 automake all 1:1.16.1-4 [771 kB] Get: 35 http://deb.debian.org/debian buster/main arm64 autopoint all 0.19.8.1-9 [434 kB] Get: 36 http://deb.debian.org/debian buster/main arm64 libtool all 2.4.6-9 [547 kB] Get: 37 http://deb.debian.org/debian buster/main arm64 dh-autoreconf all 19 [16.9 kB] Get: 38 http://deb.debian.org/debian buster/main arm64 libarchive-zip-perl all 1.64-1 [96.8 kB] Get: 39 http://deb.debian.org/debian buster/main arm64 libfile-stripnondeterminism-perl all 1.1.2-1 [19.8 kB] Get: 40 http://deb.debian.org/debian buster/main arm64 dh-strip-nondeterminism all 1.1.2-1 [13.0 kB] Get: 41 http://deb.debian.org/debian buster/main arm64 libelf1 arm64 0.176-1.1 [160 kB] Get: 42 http://deb.debian.org/debian buster/main arm64 dwz arm64 0.12-3 [71.7 kB] Get: 43 http://deb.debian.org/debian buster/main arm64 libglib2.0-0 arm64 2.58.3-2+deb10u2 [1185 kB] Get: 44 http://deb.debian.org/debian buster/main arm64 libicu63 arm64 63.1-6+deb10u1 [8151 kB] Get: 45 http://deb.debian.org/debian buster/main arm64 libxml2 arm64 2.9.4+dfsg1-7+b3 [623 kB] Get: 46 http://deb.debian.org/debian buster/main arm64 libcroco3 arm64 0.6.12-3 [140 kB] Get: 47 http://deb.debian.org/debian buster/main arm64 libncurses6 arm64 6.1+20181013-2+deb10u2 [92.6 kB] Get: 48 http://deb.debian.org/debian buster/main arm64 gettext arm64 0.19.8.1-9 [1261 kB] Get: 49 http://deb.debian.org/debian buster/main arm64 intltool-debian all 0.35.0+20060710.5 [26.8 kB] Get: 50 http://deb.debian.org/debian buster/main arm64 po-debconf all 1.0.21 [248 kB] Get: 51 http://deb.debian.org/debian buster/main arm64 debhelper all 12.1.1 [1016 kB] Get: 52 http://deb.debian.org/debian buster/main arm64 fonts-dejavu-core all 2.37-1 [1068 kB] Get: 53 http://deb.debian.org/debian buster/main arm64 fontconfig-config all 2.13.1-2 [280 kB] Get: 54 http://deb.debian.org/debian buster/main arm64 fonts-gfs-baskerville all 1.1-5 [43.4 kB] Get: 55 http://deb.debian.org/debian buster/main arm64 fonts-gfs-porson all 1.1-6 [33.5 kB] Get: 56 http://deb.debian.org/debian buster/main arm64 fonts-lmodern all 2.004.5-6 [4539 kB] Get: 57 http://deb.debian.org/debian buster/main arm64 libgs9-common all 9.27~dfsg-2+deb10u3 [5136 kB] Get: 58 http://deb.debian.org/debian buster/main arm64 libavahi-common-data arm64 0.7-4+b1 [122 kB] Get: 59 http://deb.debian.org/debian buster/main arm64 libavahi-common3 arm64 0.7-4+b1 [53.5 kB] Get: 60 http://deb.debian.org/debian buster/main arm64 libdbus-1-3 arm64 1.12.20-0+deb10u1 [206 kB] Get: 61 http://deb.debian.org/debian buster/main arm64 libavahi-client3 arm64 0.7-4+b1 [56.8 kB] Get: 62 http://deb.debian.org/debian buster/main arm64 libkeyutils1 arm64 1.6-6 [14.9 kB] Get: 63 http://deb.debian.org/debian buster/main arm64 libkrb5support0 arm64 1.17-3 [64.7 kB] Get: 64 http://deb.debian.org/debian buster/main arm64 libk5crypto3 arm64 1.17-3 [122 kB] Get: 65 http://deb.debian.org/debian buster/main arm64 libkrb5-3 arm64 1.17-3 [353 kB] Get: 66 http://deb.debian.org/debian buster/main arm64 libgssapi-krb5-2 arm64 1.17-3 [150 kB] Get: 67 http://deb.debian.org/debian buster/main arm64 libcups2 arm64 2.2.10-6+deb10u3 [310 kB] Get: 68 http://deb.debian.org/debian buster/main arm64 libcupsimage2 arm64 2.2.10-6+deb10u3 [132 kB] Get: 69 http://deb.debian.org/debian buster/main arm64 libpng16-16 arm64 1.6.36-6 [287 kB] Get: 70 http://deb.debian.org/debian buster/main arm64 libfreetype6 arm64 2.9.1-3+deb10u1 [355 kB] Get: 71 http://deb.debian.org/debian buster/main arm64 libfontconfig1 arm64 2.13.1-2 [343 kB] Get: 72 http://deb.debian.org/debian buster/main arm64 libidn11 arm64 1.33-2.2 [113 kB] Get: 73 http://deb.debian.org/debian buster/main arm64 libijs-0.35 arm64 0.35-14 [17.9 kB] Get: 74 http://deb.debian.org/debian buster/main arm64 libjbig2dec0 arm64 0.16-1 [58.1 kB] Get: 75 http://deb.debian.org/debian buster/main arm64 libjpeg62-turbo arm64 1:1.5.2-2+b1 [115 kB] Get: 76 http://deb.debian.org/debian buster/main arm64 liblcms2-2 arm64 2.9-3 [137 kB] Get: 77 http://deb.debian.org/debian buster/main arm64 libopenjp2-7 arm64 2.3.0-2+deb10u1 [148 kB] Get: 78 http://deb.debian.org/debian buster/main arm64 libpaper1 arm64 1.1.28 [21.1 kB] Get: 79 http://deb.debian.org/debian buster/main arm64 libjbig0 arm64 2.1-3.1+b2 [27.8 kB] Get: 80 http://deb.debian.org/debian buster/main arm64 libwebp6 arm64 0.6.1-2 [233 kB] Get: 81 http://deb.debian.org/debian buster/main arm64 libtiff5 arm64 4.1.0+git191117-2~deb10u1 [259 kB] Get: 82 http://deb.debian.org/debian buster/main arm64 libgs9 arm64 9.27~dfsg-2+deb10u3 [2029 kB] Get: 83 http://deb.debian.org/debian buster/main arm64 ghostscript arm64 9.27~dfsg-2+deb10u3 [94.9 kB] Get: 84 http://deb.debian.org/debian buster/main arm64 lsb-base all 10.2019051400 [28.4 kB] Get: 85 http://deb.debian.org/debian buster/main arm64 x11-common all 1:7.7+19 [251 kB] Get: 86 http://deb.debian.org/debian buster/main arm64 libice6 arm64 2:1.0.9-2 [52.0 kB] Get: 87 http://deb.debian.org/debian buster/main arm64 libsm6 arm64 2:1.2.3-1 [34.0 kB] Get: 88 http://deb.debian.org/debian buster/main arm64 libxau6 arm64 1:1.0.8-1+b2 [19.3 kB] Get: 89 http://deb.debian.org/debian buster/main arm64 libxdmcp6 arm64 1:1.1.2-3 [25.4 kB] Get: 90 http://deb.debian.org/debian buster/main arm64 libxcb1 arm64 1.13.1-2 [135 kB] Get: 91 http://deb.debian.org/debian buster/main arm64 libx11-data all 2:1.6.7-1 [298 kB] Get: 92 http://deb.debian.org/debian buster/main arm64 libx11-6 arm64 2:1.6.7-1 [735 kB] Get: 93 http://deb.debian.org/debian buster/main arm64 libxext6 arm64 2:1.3.3-1+b2 [48.6 kB] Get: 94 http://deb.debian.org/debian buster/main arm64 libxt6 arm64 1:1.1.5-1+b3 [175 kB] Get: 95 http://deb.debian.org/debian buster/main arm64 ghostscript-x arm64 9.27~dfsg-2+deb10u3 [88.5 kB] Get: 96 http://deb.debian.org/debian buster/main arm64 libnetpbm10 arm64 2:10.0-15.3+b2 [79.1 kB] Get: 97 http://deb.debian.org/debian buster/main arm64 netpbm arm64 2:10.0-15.3+b2 [942 kB] Get: 98 http://deb.debian.org/debian buster/main arm64 perl-doc all 5.28.1-6+deb10u1 [7654 kB] Get: 99 http://deb.debian.org/debian buster/main arm64 libnspr4 arm64 2:4.20-1 [105 kB] Get: 100 http://deb.debian.org/debian buster/main arm64 libnss3 arm64 2:3.42.1-1+deb10u3 [1082 kB] Get: 101 http://deb.debian.org/debian buster/main arm64 libpoppler82 arm64 0.71.0-5 [1431 kB] Get: 102 http://deb.debian.org/debian buster/main arm64 libpixman-1-0 arm64 0.36.0-1 [436 kB] Get: 103 http://deb.debian.org/debian buster/main arm64 libxcb-render0 arm64 1.13.1-2 [108 kB] Get: 104 http://deb.debian.org/debian buster/main arm64 libxcb-shm0 arm64 1.13.1-2 [99.3 kB] Get: 105 http://deb.debian.org/debian buster/main arm64 libxrender1 arm64 1:0.9.10-1 [30.4 kB] Get: 106 http://deb.debian.org/debian buster/main arm64 libcairo2 arm64 1.16.0-4 [644 kB] Get: 107 http://deb.debian.org/debian buster/main arm64 poppler-utils arm64 0.71.0-5 [172 kB] Get: 108 http://deb.debian.org/debian buster/main arm64 libkpathsea6 arm64 2018.20181218.49446-1 [164 kB] Get: 109 http://deb.debian.org/debian buster/main arm64 libptexenc1 arm64 2018.20181218.49446-1 [60.3 kB] Get: 110 http://deb.debian.org/debian buster/main arm64 libsynctex2 arm64 2018.20181218.49446-1 [77.8 kB] Get: 111 http://deb.debian.org/debian buster/main arm64 libtexlua52 arm64 2018.20181218.49446-1 [107 kB] Get: 112 http://deb.debian.org/debian buster/main arm64 libtexlua53 arm64 2018.20181218.49446-1 [118 kB] Get: 113 http://deb.debian.org/debian buster/main arm64 t1utils arm64 1.41-3 [59.7 kB] Get: 114 http://deb.debian.org/debian buster/main arm64 libbrotli1 arm64 1.0.7-2 [261 kB] Get: 115 http://deb.debian.org/debian buster/main arm64 libgraphite2-3 arm64 1.3.13-7 [75.8 kB] Get: 116 http://deb.debian.org/debian buster/main arm64 libharfbuzz0b arm64 2.3.1-1 [1155 kB] Get: 117 http://deb.debian.org/debian buster/main arm64 libharfbuzz-icu0 arm64 2.3.1-1 [834 kB] Get: 118 http://deb.debian.org/debian buster/main arm64 libpotrace0 arm64 1.15-1 [23.6 kB] Get: 119 http://deb.debian.org/debian buster/main arm64 libteckit0 arm64 2.5.8+ds2-5 [284 kB] Get: 120 http://deb.debian.org/debian buster/main arm64 libwoff1 arm64 1.0.2-1 [40.7 kB] Get: 121 http://deb.debian.org/debian buster/main arm64 libxmu6 arm64 2:1.1.2-2+b3 [57.8 kB] Get: 122 http://deb.debian.org/debian buster/main arm64 libxpm4 arm64 1:3.5.12-1 [43.9 kB] Get: 123 http://deb.debian.org/debian buster/main arm64 libxaw7 arm64 2:1.0.13-1+b2 [167 kB] Get: 124 http://deb.debian.org/debian buster/main arm64 libxi6 arm64 2:1.7.9-1 [79.0 kB] Get: 125 http://deb.debian.org/debian buster/main arm64 libxxhash0 arm64 0.6.5-2 [7684 B] Get: 126 http://deb.debian.org/debian buster/main arm64 libzzip-0-13 arm64 0.13.62-3.2 [55.5 kB] Get: 127 http://deb.debian.org/debian buster/main arm64 texlive-binaries arm64 2018.20181218.49446-1 [8464 kB] Get: 128 http://deb.debian.org/debian buster/main arm64 libpaper-utils arm64 1.1.28 [18.0 kB] Get: 129 http://deb.debian.org/debian buster/main arm64 xdg-utils all 1.1.3-1+deb10u1 [73.7 kB] Get: 130 http://deb.debian.org/debian buster/main arm64 texlive-base all 2018.20190227-2 [19.7 MB] Get: 131 http://deb.debian.org/debian buster/main arm64 texlive-fonts-recommended all 2018.20190227-2 [5228 kB] Get: 132 http://deb.debian.org/debian buster/main arm64 preview-latex-style all 11.91-2 [201 kB] Get: 133 http://deb.debian.org/debian buster/main arm64 texlive-latex-base all 2018.20190227-2 [984 kB] Get: 134 http://deb.debian.org/debian buster/main arm64 texlive-latex-recommended all 2018.20190227-2 [15.2 MB] Get: 135 http://deb.debian.org/debian buster/main arm64 texlive-pictures all 2018.20190227-2 [8201 kB] Get: 136 http://deb.debian.org/debian buster/main arm64 texlive-latex-extra all 2018.20190227-2 [12.3 MB] Get: 137 http://deb.debian.org/debian buster/main arm64 latex2html all 2019-debian1-3 [2510 kB] Get: 138 http://deb.debian.org/debian buster/main arm64 libcminpack1 arm64 1.3.6-4 [34.0 kB] Get: 139 http://deb.debian.org/debian buster/main arm64 libcminpack-dev arm64 1.3.6-4 [11.6 kB] Get: 140 http://deb.debian.org/debian buster/main arm64 liberfa1 arm64 1.4.0-1 [107 kB] Get: 141 http://deb.debian.org/debian buster/main arm64 liberfa-dev arm64 1.4.0-1 [123 kB] Get: 142 http://deb.debian.org/debian buster/main arm64 libstarlink-pal0 arm64 0.9.8-1 [40.3 kB] Get: 143 http://deb.debian.org/debian buster/main arm64 libstarlink-pal-dev arm64 0.9.8-1 [51.6 kB] Get: 144 http://deb.debian.org/debian buster/main arm64 texlive all 2018.20190227-2 [32.6 kB] Get: 145 http://deb.debian.org/debian buster/main arm64 texlive-font-utils all 2018.20190227-2 [1746 kB] Get: 146 http://deb.debian.org/debian buster/main arm64 texlive-lang-greek all 2018.20190227-2 [76.3 MB] Get: 147 http://deb.debian.org/debian buster/main arm64 texlive-science all 2018.20190227-2 [3168 kB] Fetched 216 MB in 6s (33.8 MB/s) debconf: delaying package configuration, since apt-utils is not installed Selecting previously unselected package libbsd0:arm64. (Reading database ... (Reading database ... 5% (Reading database ... 10% (Reading database ... 15% (Reading database ... 20% (Reading database ... 25% (Reading database ... 30% (Reading database ... 35% (Reading database ... 40% (Reading database ... 45% (Reading database ... 50% (Reading database ... 55% (Reading database ... 60% (Reading database ... 65% (Reading database ... 70% (Reading database ... 75% (Reading database ... 80% (Reading database ... 85% (Reading database ... 90% (Reading database ... 95% (Reading database ... 100% (Reading database ... 19168 files and directories currently installed.) Preparing to unpack .../00-libbsd0_0.9.1-2_arm64.deb ... Unpacking libbsd0:arm64 (0.9.1-2) ... Selecting previously unselected package bsdmainutils. Preparing to unpack .../01-bsdmainutils_11.1.2+b1_arm64.deb ... Unpacking bsdmainutils (11.1.2+b1) ... Selecting previously unselected package libuchardet0:arm64. Preparing to unpack .../02-libuchardet0_0.0.6-3_arm64.deb ... Unpacking libuchardet0:arm64 (0.0.6-3) ... Selecting previously unselected package groff-base. Preparing to unpack .../03-groff-base_1.22.4-3_arm64.deb ... Unpacking groff-base (1.22.4-3) ... Selecting previously unselected package libpipeline1:arm64. Preparing to unpack .../04-libpipeline1_1.5.1-2_arm64.deb ... Unpacking libpipeline1:arm64 (1.5.1-2) ... Selecting previously unselected package man-db. Preparing to unpack .../05-man-db_2.8.5-2_arm64.deb ... Unpacking man-db (2.8.5-2) ... Selecting previously unselected package libpython2.7-minimal:arm64. Preparing to unpack .../06-libpython2.7-minimal_2.7.16-2+deb10u1_arm64.deb ... Unpacking libpython2.7-minimal:arm64 (2.7.16-2+deb10u1) ... Selecting previously unselected package python2.7-minimal. Preparing to unpack .../07-python2.7-minimal_2.7.16-2+deb10u1_arm64.deb ... Unpacking python2.7-minimal (2.7.16-2+deb10u1) ... Selecting previously unselected package python2-minimal. Preparing to unpack .../08-python2-minimal_2.7.16-1_arm64.deb ... Unpacking python2-minimal (2.7.16-1) ... Selecting previously unselected package python-minimal. Preparing to unpack .../09-python-minimal_2.7.16-1_arm64.deb ... Unpacking python-minimal (2.7.16-1) ... Selecting previously unselected package libssl1.1:arm64. Preparing to unpack .../10-libssl1.1_1.1.1d-0+deb10u3_arm64.deb ... Unpacking libssl1.1:arm64 (1.1.1d-0+deb10u3) ... Selecting previously unselected package mime-support. Preparing to unpack .../11-mime-support_3.62_all.deb ... Unpacking mime-support (3.62) ... Selecting previously unselected package libexpat1:arm64. Preparing to unpack .../12-libexpat1_2.2.6-2+deb10u1_arm64.deb ... Unpacking libexpat1:arm64 (2.2.6-2+deb10u1) ... Selecting previously unselected package readline-common. Preparing to unpack .../13-readline-common_7.0-5_all.deb ... Unpacking readline-common (7.0-5) ... Selecting previously unselected package libreadline7:arm64. Preparing to unpack .../14-libreadline7_7.0-5_arm64.deb ... Unpacking libreadline7:arm64 (7.0-5) ... Selecting previously unselected package libpython2.7-stdlib:arm64. Preparing to unpack .../15-libpython2.7-stdlib_2.7.16-2+deb10u1_arm64.deb ... Unpacking libpython2.7-stdlib:arm64 (2.7.16-2+deb10u1) ... Selecting previously unselected package python2.7. Preparing to unpack .../16-python2.7_2.7.16-2+deb10u1_arm64.deb ... Unpacking python2.7 (2.7.16-2+deb10u1) ... Selecting previously unselected package libpython2-stdlib:arm64. Preparing to unpack .../17-libpython2-stdlib_2.7.16-1_arm64.deb ... Unpacking libpython2-stdlib:arm64 (2.7.16-1) ... Selecting previously unselected package libpython-stdlib:arm64. Preparing to unpack .../18-libpython-stdlib_2.7.16-1_arm64.deb ... Unpacking libpython-stdlib:arm64 (2.7.16-1) ... Setting up libpython2.7-minimal:arm64 (2.7.16-2+deb10u1) ... Setting up python2.7-minimal (2.7.16-2+deb10u1) ... Setting up python2-minimal (2.7.16-1) ... Selecting previously unselected package python2. (Reading database ... (Reading database ... 5% (Reading database ... 10% (Reading database ... 15% (Reading database ... 20% (Reading database ... 25% (Reading database ... 30% (Reading database ... 35% (Reading database ... 40% (Reading database ... 45% (Reading database ... 50% (Reading database ... 55% (Reading database ... 60% (Reading database ... 65% (Reading database ... 70% (Reading database ... 75% (Reading database ... 80% (Reading database ... 85% (Reading database ... 90% (Reading database ... 95% (Reading database ... 100% (Reading database ... 20631 files and directories currently installed.) Preparing to unpack .../python2_2.7.16-1_arm64.deb ... Unpacking python2 (2.7.16-1) ... Setting up python-minimal (2.7.16-1) ... Selecting previously unselected package python. (Reading database ... (Reading database ... 5% (Reading database ... 10% (Reading database ... 15% (Reading database ... 20% (Reading database ... 25% (Reading database ... 30% (Reading database ... 35% (Reading database ... 40% (Reading database ... 45% (Reading database ... 50% (Reading database ... 55% (Reading database ... 60% (Reading database ... 65% (Reading database ... 70% (Reading database ... 75% (Reading database ... 80% (Reading database ... 85% (Reading database ... 90% (Reading database ... 95% (Reading database ... 100% (Reading database ... 20664 files and directories currently installed.) Preparing to unpack .../000-python_2.7.16-1_arm64.deb ... Unpacking python (2.7.16-1) ... Selecting previously unselected package poppler-data. Preparing to unpack .../001-poppler-data_0.4.9-2_all.deb ... Unpacking poppler-data (0.4.9-2) ... Selecting previously unselected package sensible-utils. Preparing to unpack .../002-sensible-utils_0.0.12_all.deb ... Unpacking sensible-utils (0.0.12) ... Selecting previously unselected package ucf. Preparing to unpack .../003-ucf_3.0038+nmu1_all.deb ... Moving old data out of the way Unpacking ucf (3.0038+nmu1) ... Selecting previously unselected package tex-common. Preparing to unpack .../004-tex-common_6.11_all.deb ... Unpacking tex-common (6.11) ... Selecting previously unselected package libmagic-mgc. Preparing to unpack .../005-libmagic-mgc_1%3a5.35-4+deb10u1_arm64.deb ... Unpacking libmagic-mgc (1:5.35-4+deb10u1) ... Selecting previously unselected package libmagic1:arm64. Preparing to unpack .../006-libmagic1_1%3a5.35-4+deb10u1_arm64.deb ... Unpacking libmagic1:arm64 (1:5.35-4+deb10u1) ... Selecting previously unselected package file. Preparing to unpack .../007-file_1%3a5.35-4+deb10u1_arm64.deb ... Unpacking file (1:5.35-4+deb10u1) ... Selecting previously unselected package gettext-base. Preparing to unpack .../008-gettext-base_0.19.8.1-9_arm64.deb ... Unpacking gettext-base (0.19.8.1-9) ... Selecting previously unselected package libsigsegv2:arm64. Preparing to unpack .../009-libsigsegv2_2.12-2_arm64.deb ... Unpacking libsigsegv2:arm64 (2.12-2) ... Selecting previously unselected package m4. Preparing to unpack .../010-m4_1.4.18-2_arm64.deb ... Unpacking m4 (1.4.18-2) ... Selecting previously unselected package autoconf. Preparing to unpack .../011-autoconf_2.69-11_all.deb ... Unpacking autoconf (2.69-11) ... Selecting previously unselected package autotools-dev. Preparing to unpack .../012-autotools-dev_20180224.1_all.deb ... Unpacking autotools-dev (20180224.1) ... Selecting previously unselected package automake. Preparing to unpack .../013-automake_1%3a1.16.1-4_all.deb ... Unpacking automake (1:1.16.1-4) ... Selecting previously unselected package autopoint. Preparing to unpack .../014-autopoint_0.19.8.1-9_all.deb ... Unpacking autopoint (0.19.8.1-9) ... Selecting previously unselected package libtool. Preparing to unpack .../015-libtool_2.4.6-9_all.deb ... Unpacking libtool (2.4.6-9) ... Selecting previously unselected package dh-autoreconf. Preparing to unpack .../016-dh-autoreconf_19_all.deb ... Unpacking dh-autoreconf (19) ... Selecting previously unselected package libarchive-zip-perl. Preparing to unpack .../017-libarchive-zip-perl_1.64-1_all.deb ... Unpacking libarchive-zip-perl (1.64-1) ... Selecting previously unselected package libfile-stripnondeterminism-perl. Preparing to unpack .../018-libfile-stripnondeterminism-perl_1.1.2-1_all.deb ... Unpacking libfile-stripnondeterminism-perl (1.1.2-1) ... Selecting previously unselected package dh-strip-nondeterminism. Preparing to unpack .../019-dh-strip-nondeterminism_1.1.2-1_all.deb ... Unpacking dh-strip-nondeterminism (1.1.2-1) ... Selecting previously unselected package libelf1:arm64. Preparing to unpack .../020-libelf1_0.176-1.1_arm64.deb ... Unpacking libelf1:arm64 (0.176-1.1) ... Selecting previously unselected package dwz. Preparing to unpack .../021-dwz_0.12-3_arm64.deb ... Unpacking dwz (0.12-3) ... Selecting previously unselected package libglib2.0-0:arm64. Preparing to unpack .../022-libglib2.0-0_2.58.3-2+deb10u2_arm64.deb ... Unpacking libglib2.0-0:arm64 (2.58.3-2+deb10u2) ... Selecting previously unselected package libicu63:arm64. Preparing to unpack .../023-libicu63_63.1-6+deb10u1_arm64.deb ... Unpacking libicu63:arm64 (63.1-6+deb10u1) ... Selecting previously unselected package libxml2:arm64. Preparing to unpack .../024-libxml2_2.9.4+dfsg1-7+b3_arm64.deb ... Unpacking libxml2:arm64 (2.9.4+dfsg1-7+b3) ... Selecting previously unselected package libcroco3:arm64. Preparing to unpack .../025-libcroco3_0.6.12-3_arm64.deb ... Unpacking libcroco3:arm64 (0.6.12-3) ... Selecting previously unselected package libncurses6:arm64. Preparing to unpack .../026-libncurses6_6.1+20181013-2+deb10u2_arm64.deb ... Unpacking libncurses6:arm64 (6.1+20181013-2+deb10u2) ... Selecting previously unselected package gettext. Preparing to unpack .../027-gettext_0.19.8.1-9_arm64.deb ... Unpacking gettext (0.19.8.1-9) ... Selecting previously unselected package intltool-debian. Preparing to unpack .../028-intltool-debian_0.35.0+20060710.5_all.deb ... Unpacking intltool-debian (0.35.0+20060710.5) ... Selecting previously unselected package po-debconf. Preparing to unpack .../029-po-debconf_1.0.21_all.deb ... Unpacking po-debconf (1.0.21) ... Selecting previously unselected package debhelper. Preparing to unpack .../030-debhelper_12.1.1_all.deb ... Unpacking debhelper (12.1.1) ... Selecting previously unselected package fonts-dejavu-core. Preparing to unpack .../031-fonts-dejavu-core_2.37-1_all.deb ... Unpacking fonts-dejavu-core (2.37-1) ... Selecting previously unselected package fontconfig-config. Preparing to unpack .../032-fontconfig-config_2.13.1-2_all.deb ... Unpacking fontconfig-config (2.13.1-2) ... Selecting previously unselected package fonts-gfs-baskerville. Preparing to unpack .../033-fonts-gfs-baskerville_1.1-5_all.deb ... Unpacking fonts-gfs-baskerville (1.1-5) ... Selecting previously unselected package fonts-gfs-porson. Preparing to unpack .../034-fonts-gfs-porson_1.1-6_all.deb ... Unpacking fonts-gfs-porson (1.1-6) ... Selecting previously unselected package fonts-lmodern. Preparing to unpack .../035-fonts-lmodern_2.004.5-6_all.deb ... Unpacking fonts-lmodern (2.004.5-6) ... Selecting previously unselected package libgs9-common. Preparing to unpack .../036-libgs9-common_9.27~dfsg-2+deb10u3_all.deb ... Unpacking libgs9-common (9.27~dfsg-2+deb10u3) ... Selecting previously unselected package libavahi-common-data:arm64. Preparing to unpack .../037-libavahi-common-data_0.7-4+b1_arm64.deb ... Unpacking libavahi-common-data:arm64 (0.7-4+b1) ... Selecting previously unselected package libavahi-common3:arm64. Preparing to unpack .../038-libavahi-common3_0.7-4+b1_arm64.deb ... Unpacking libavahi-common3:arm64 (0.7-4+b1) ... Selecting previously unselected package libdbus-1-3:arm64. Preparing to unpack .../039-libdbus-1-3_1.12.20-0+deb10u1_arm64.deb ... Unpacking libdbus-1-3:arm64 (1.12.20-0+deb10u1) ... Selecting previously unselected package libavahi-client3:arm64. Preparing to unpack .../040-libavahi-client3_0.7-4+b1_arm64.deb ... Unpacking libavahi-client3:arm64 (0.7-4+b1) ... Selecting previously unselected package libkeyutils1:arm64. Preparing to unpack .../041-libkeyutils1_1.6-6_arm64.deb ... Unpacking libkeyutils1:arm64 (1.6-6) ... Selecting previously unselected package libkrb5support0:arm64. Preparing to unpack .../042-libkrb5support0_1.17-3_arm64.deb ... Unpacking libkrb5support0:arm64 (1.17-3) ... Selecting previously unselected package libk5crypto3:arm64. Preparing to unpack .../043-libk5crypto3_1.17-3_arm64.deb ... Unpacking libk5crypto3:arm64 (1.17-3) ... Selecting previously unselected package libkrb5-3:arm64. Preparing to unpack .../044-libkrb5-3_1.17-3_arm64.deb ... Unpacking libkrb5-3:arm64 (1.17-3) ... Selecting previously unselected package libgssapi-krb5-2:arm64. Preparing to unpack .../045-libgssapi-krb5-2_1.17-3_arm64.deb ... Unpacking libgssapi-krb5-2:arm64 (1.17-3) ... Selecting previously unselected package libcups2:arm64. Preparing to unpack .../046-libcups2_2.2.10-6+deb10u3_arm64.deb ... Unpacking libcups2:arm64 (2.2.10-6+deb10u3) ... Selecting previously unselected package libcupsimage2:arm64. Preparing to unpack .../047-libcupsimage2_2.2.10-6+deb10u3_arm64.deb ... Unpacking libcupsimage2:arm64 (2.2.10-6+deb10u3) ... Selecting previously unselected package libpng16-16:arm64. Preparing to unpack .../048-libpng16-16_1.6.36-6_arm64.deb ... Unpacking libpng16-16:arm64 (1.6.36-6) ... Selecting previously unselected package libfreetype6:arm64. Preparing to unpack .../049-libfreetype6_2.9.1-3+deb10u1_arm64.deb ... Unpacking libfreetype6:arm64 (2.9.1-3+deb10u1) ... Selecting previously unselected package libfontconfig1:arm64. Preparing to unpack .../050-libfontconfig1_2.13.1-2_arm64.deb ... Unpacking libfontconfig1:arm64 (2.13.1-2) ... Selecting previously unselected package libidn11:arm64. Preparing to unpack .../051-libidn11_1.33-2.2_arm64.deb ... Unpacking libidn11:arm64 (1.33-2.2) ... Selecting previously unselected package libijs-0.35:arm64. Preparing to unpack .../052-libijs-0.35_0.35-14_arm64.deb ... Unpacking libijs-0.35:arm64 (0.35-14) ... Selecting previously unselected package libjbig2dec0:arm64. Preparing to unpack .../053-libjbig2dec0_0.16-1_arm64.deb ... Unpacking libjbig2dec0:arm64 (0.16-1) ... Selecting previously unselected package libjpeg62-turbo:arm64. Preparing to unpack .../054-libjpeg62-turbo_1%3a1.5.2-2+b1_arm64.deb ... Unpacking libjpeg62-turbo:arm64 (1:1.5.2-2+b1) ... Selecting previously unselected package liblcms2-2:arm64. Preparing to unpack .../055-liblcms2-2_2.9-3_arm64.deb ... Unpacking liblcms2-2:arm64 (2.9-3) ... Selecting previously unselected package libopenjp2-7:arm64. Preparing to unpack .../056-libopenjp2-7_2.3.0-2+deb10u1_arm64.deb ... Unpacking libopenjp2-7:arm64 (2.3.0-2+deb10u1) ... Selecting previously unselected package libpaper1:arm64. Preparing to unpack .../057-libpaper1_1.1.28_arm64.deb ... Unpacking libpaper1:arm64 (1.1.28) ... Selecting previously unselected package libjbig0:arm64. Preparing to unpack .../058-libjbig0_2.1-3.1+b2_arm64.deb ... Unpacking libjbig0:arm64 (2.1-3.1+b2) ... Selecting previously unselected package libwebp6:arm64. Preparing to unpack .../059-libwebp6_0.6.1-2_arm64.deb ... Unpacking libwebp6:arm64 (0.6.1-2) ... Selecting previously unselected package libtiff5:arm64. Preparing to unpack .../060-libtiff5_4.1.0+git191117-2~deb10u1_arm64.deb ... Unpacking libtiff5:arm64 (4.1.0+git191117-2~deb10u1) ... Selecting previously unselected package libgs9:arm64. Preparing to unpack .../061-libgs9_9.27~dfsg-2+deb10u3_arm64.deb ... Unpacking libgs9:arm64 (9.27~dfsg-2+deb10u3) ... Selecting previously unselected package ghostscript. Preparing to unpack .../062-ghostscript_9.27~dfsg-2+deb10u3_arm64.deb ... Unpacking ghostscript (9.27~dfsg-2+deb10u3) ... Selecting previously unselected package lsb-base. Preparing to unpack .../063-lsb-base_10.2019051400_all.deb ... Unpacking lsb-base (10.2019051400) ... Selecting previously unselected package x11-common. Preparing to unpack .../064-x11-common_1%3a7.7+19_all.deb ... Unpacking x11-common (1:7.7+19) ... Selecting previously unselected package libice6:arm64. Preparing to unpack .../065-libice6_2%3a1.0.9-2_arm64.deb ... Unpacking libice6:arm64 (2:1.0.9-2) ... Selecting previously unselected package libsm6:arm64. Preparing to unpack .../066-libsm6_2%3a1.2.3-1_arm64.deb ... Unpacking libsm6:arm64 (2:1.2.3-1) ... Selecting previously unselected package libxau6:arm64. Preparing to unpack .../067-libxau6_1%3a1.0.8-1+b2_arm64.deb ... Unpacking libxau6:arm64 (1:1.0.8-1+b2) ... Selecting previously unselected package libxdmcp6:arm64. Preparing to unpack .../068-libxdmcp6_1%3a1.1.2-3_arm64.deb ... Unpacking libxdmcp6:arm64 (1:1.1.2-3) ... Selecting previously unselected package libxcb1:arm64. Preparing to unpack .../069-libxcb1_1.13.1-2_arm64.deb ... Unpacking libxcb1:arm64 (1.13.1-2) ... Selecting previously unselected package libx11-data. Preparing to unpack .../070-libx11-data_2%3a1.6.7-1_all.deb ... Unpacking libx11-data (2:1.6.7-1) ... Selecting previously unselected package libx11-6:arm64. Preparing to unpack .../071-libx11-6_2%3a1.6.7-1_arm64.deb ... Unpacking libx11-6:arm64 (2:1.6.7-1) ... Selecting previously unselected package libxext6:arm64. Preparing to unpack .../072-libxext6_2%3a1.3.3-1+b2_arm64.deb ... Unpacking libxext6:arm64 (2:1.3.3-1+b2) ... Selecting previously unselected package libxt6:arm64. Preparing to unpack .../073-libxt6_1%3a1.1.5-1+b3_arm64.deb ... Unpacking libxt6:arm64 (1:1.1.5-1+b3) ... Selecting previously unselected package ghostscript-x. Preparing to unpack .../074-ghostscript-x_9.27~dfsg-2+deb10u3_arm64.deb ... Unpacking ghostscript-x (9.27~dfsg-2+deb10u3) ... Selecting previously unselected package libnetpbm10. Preparing to unpack .../075-libnetpbm10_2%3a10.0-15.3+b2_arm64.deb ... Unpacking libnetpbm10 (2:10.0-15.3+b2) ... Selecting previously unselected package netpbm. Preparing to unpack .../076-netpbm_2%3a10.0-15.3+b2_arm64.deb ... Unpacking netpbm (2:10.0-15.3+b2) ... Selecting previously unselected package perl-doc. Preparing to unpack .../077-perl-doc_5.28.1-6+deb10u1_all.deb ... Adding 'diversion of /usr/bin/perldoc to /usr/bin/perldoc.stub by perl-doc' Unpacking perl-doc (5.28.1-6+deb10u1) ... Selecting previously unselected package libnspr4:arm64. Preparing to unpack .../078-libnspr4_2%3a4.20-1_arm64.deb ... Unpacking libnspr4:arm64 (2:4.20-1) ... Selecting previously unselected package libnss3:arm64. Preparing to unpack .../079-libnss3_2%3a3.42.1-1+deb10u3_arm64.deb ... Unpacking libnss3:arm64 (2:3.42.1-1+deb10u3) ... Selecting previously unselected package libpoppler82:arm64. Preparing to unpack .../080-libpoppler82_0.71.0-5_arm64.deb ... Unpacking libpoppler82:arm64 (0.71.0-5) ... Selecting previously unselected package libpixman-1-0:arm64. Preparing to unpack .../081-libpixman-1-0_0.36.0-1_arm64.deb ... Unpacking libpixman-1-0:arm64 (0.36.0-1) ... Selecting previously unselected package libxcb-render0:arm64. Preparing to unpack .../082-libxcb-render0_1.13.1-2_arm64.deb ... Unpacking libxcb-render0:arm64 (1.13.1-2) ... Selecting previously unselected package libxcb-shm0:arm64. Preparing to unpack .../083-libxcb-shm0_1.13.1-2_arm64.deb ... Unpacking libxcb-shm0:arm64 (1.13.1-2) ... Selecting previously unselected package libxrender1:arm64. Preparing to unpack .../084-libxrender1_1%3a0.9.10-1_arm64.deb ... Unpacking libxrender1:arm64 (1:0.9.10-1) ... Selecting previously unselected package libcairo2:arm64. Preparing to unpack .../085-libcairo2_1.16.0-4_arm64.deb ... Unpacking libcairo2:arm64 (1.16.0-4) ... Selecting previously unselected package poppler-utils. Preparing to unpack .../086-poppler-utils_0.71.0-5_arm64.deb ... Unpacking poppler-utils (0.71.0-5) ... Selecting previously unselected package libkpathsea6:arm64. Preparing to unpack .../087-libkpathsea6_2018.20181218.49446-1_arm64.deb ... Unpacking libkpathsea6:arm64 (2018.20181218.49446-1) ... Selecting previously unselected package libptexenc1:arm64. Preparing to unpack .../088-libptexenc1_2018.20181218.49446-1_arm64.deb ... Unpacking libptexenc1:arm64 (2018.20181218.49446-1) ... Selecting previously unselected package libsynctex2:arm64. Preparing to unpack .../089-libsynctex2_2018.20181218.49446-1_arm64.deb ... Unpacking libsynctex2:arm64 (2018.20181218.49446-1) ... Selecting previously unselected package libtexlua52:arm64. Preparing to unpack .../090-libtexlua52_2018.20181218.49446-1_arm64.deb ... Unpacking libtexlua52:arm64 (2018.20181218.49446-1) ... Selecting previously unselected package libtexlua53:arm64. Preparing to unpack .../091-libtexlua53_2018.20181218.49446-1_arm64.deb ... Unpacking libtexlua53:arm64 (2018.20181218.49446-1) ... Selecting previously unselected package t1utils. Preparing to unpack .../092-t1utils_1.41-3_arm64.deb ... Unpacking t1utils (1.41-3) ... Selecting previously unselected package libbrotli1:arm64. Preparing to unpack .../093-libbrotli1_1.0.7-2_arm64.deb ... Unpacking libbrotli1:arm64 (1.0.7-2) ... Selecting previously unselected package libgraphite2-3:arm64. Preparing to unpack .../094-libgraphite2-3_1.3.13-7_arm64.deb ... Unpacking libgraphite2-3:arm64 (1.3.13-7) ... Selecting previously unselected package libharfbuzz0b:arm64. Preparing to unpack .../095-libharfbuzz0b_2.3.1-1_arm64.deb ... Unpacking libharfbuzz0b:arm64 (2.3.1-1) ... Selecting previously unselected package libharfbuzz-icu0:arm64. Preparing to unpack .../096-libharfbuzz-icu0_2.3.1-1_arm64.deb ... Unpacking libharfbuzz-icu0:arm64 (2.3.1-1) ... Selecting previously unselected package libpotrace0:arm64. Preparing to unpack .../097-libpotrace0_1.15-1_arm64.deb ... Unpacking libpotrace0:arm64 (1.15-1) ... Selecting previously unselected package libteckit0:arm64. Preparing to unpack .../098-libteckit0_2.5.8+ds2-5_arm64.deb ... Unpacking libteckit0:arm64 (2.5.8+ds2-5) ... Selecting previously unselected package libwoff1:arm64. Preparing to unpack .../099-libwoff1_1.0.2-1_arm64.deb ... Unpacking libwoff1:arm64 (1.0.2-1) ... Selecting previously unselected package libxmu6:arm64. Preparing to unpack .../100-libxmu6_2%3a1.1.2-2+b3_arm64.deb ... Unpacking libxmu6:arm64 (2:1.1.2-2+b3) ... Selecting previously unselected package libxpm4:arm64. Preparing to unpack .../101-libxpm4_1%3a3.5.12-1_arm64.deb ... Unpacking libxpm4:arm64 (1:3.5.12-1) ... Selecting previously unselected package libxaw7:arm64. Preparing to unpack .../102-libxaw7_2%3a1.0.13-1+b2_arm64.deb ... Unpacking libxaw7:arm64 (2:1.0.13-1+b2) ... Selecting previously unselected package libxi6:arm64. Preparing to unpack .../103-libxi6_2%3a1.7.9-1_arm64.deb ... Unpacking libxi6:arm64 (2:1.7.9-1) ... Selecting previously unselected package libxxhash0:arm64. Preparing to unpack .../104-libxxhash0_0.6.5-2_arm64.deb ... Unpacking libxxhash0:arm64 (0.6.5-2) ... Selecting previously unselected package libzzip-0-13:arm64. Preparing to unpack .../105-libzzip-0-13_0.13.62-3.2_arm64.deb ... Unpacking libzzip-0-13:arm64 (0.13.62-3.2) ... Selecting previously unselected package texlive-binaries. Preparing to unpack .../106-texlive-binaries_2018.20181218.49446-1_arm64.deb ... Unpacking texlive-binaries (2018.20181218.49446-1) ... Selecting previously unselected package libpaper-utils. Preparing to unpack .../107-libpaper-utils_1.1.28_arm64.deb ... Unpacking libpaper-utils (1.1.28) ... Selecting previously unselected package xdg-utils. Preparing to unpack .../108-xdg-utils_1.1.3-1+deb10u1_all.deb ... Unpacking xdg-utils (1.1.3-1+deb10u1) ... Selecting previously unselected package texlive-base. Preparing to unpack .../109-texlive-base_2018.20190227-2_all.deb ... Unpacking texlive-base (2018.20190227-2) ... Selecting previously unselected package texlive-fonts-recommended. Preparing to unpack .../110-texlive-fonts-recommended_2018.20190227-2_all.deb ... Unpacking texlive-fonts-recommended (2018.20190227-2) ... Selecting previously unselected package preview-latex-style. Preparing to unpack .../111-preview-latex-style_11.91-2_all.deb ... Unpacking preview-latex-style (11.91-2) ... Selecting previously unselected package texlive-latex-base. Preparing to unpack .../112-texlive-latex-base_2018.20190227-2_all.deb ... Unpacking texlive-latex-base (2018.20190227-2) ... Selecting previously unselected package texlive-latex-recommended. Preparing to unpack .../113-texlive-latex-recommended_2018.20190227-2_all.deb ... Unpacking texlive-latex-recommended (2018.20190227-2) ... Selecting previously unselected package texlive-pictures. Preparing to unpack .../114-texlive-pictures_2018.20190227-2_all.deb ... Unpacking texlive-pictures (2018.20190227-2) ... Selecting previously unselected package texlive-latex-extra. Preparing to unpack .../115-texlive-latex-extra_2018.20190227-2_all.deb ... Unpacking texlive-latex-extra (2018.20190227-2) ... Selecting previously unselected package latex2html. Preparing to unpack .../116-latex2html_2019-debian1-3_all.deb ... Unpacking latex2html (2019-debian1-3) ... Selecting previously unselected package libcminpack1:arm64. Preparing to unpack .../117-libcminpack1_1.3.6-4_arm64.deb ... Unpacking libcminpack1:arm64 (1.3.6-4) ... Selecting previously unselected package libcminpack-dev:arm64. Preparing to unpack .../118-libcminpack-dev_1.3.6-4_arm64.deb ... Unpacking libcminpack-dev:arm64 (1.3.6-4) ... Selecting previously unselected package liberfa1:arm64. Preparing to unpack .../119-liberfa1_1.4.0-1_arm64.deb ... Unpacking liberfa1:arm64 (1.4.0-1) ... Selecting previously unselected package liberfa-dev. Preparing to unpack .../120-liberfa-dev_1.4.0-1_arm64.deb ... Unpacking liberfa-dev (1.4.0-1) ... Selecting previously unselected package libstarlink-pal0:arm64. Preparing to unpack .../121-libstarlink-pal0_0.9.8-1_arm64.deb ... Unpacking libstarlink-pal0:arm64 (0.9.8-1) ... Selecting previously unselected package libstarlink-pal-dev:arm64. Preparing to unpack .../122-libstarlink-pal-dev_0.9.8-1_arm64.deb ... Unpacking libstarlink-pal-dev:arm64 (0.9.8-1) ... Selecting previously unselected package texlive. Preparing to unpack .../123-texlive_2018.20190227-2_all.deb ... Unpacking texlive (2018.20190227-2) ... Selecting previously unselected package texlive-font-utils. Preparing to unpack .../124-texlive-font-utils_2018.20190227-2_all.deb ... Unpacking texlive-font-utils (2018.20190227-2) ... Selecting previously unselected package texlive-lang-greek. Preparing to unpack .../125-texlive-lang-greek_2018.20190227-2_all.deb ... Unpacking texlive-lang-greek (2018.20190227-2) ... Selecting previously unselected package texlive-science. Preparing to unpack .../126-texlive-science_2018.20190227-2_all.deb ... Unpacking texlive-science (2018.20190227-2) ... Setting up libgs9-common (9.27~dfsg-2+deb10u3) ... Setting up libexpat1:arm64 (2.2.6-2+deb10u1) ... Setting up libpipeline1:arm64 (1.5.1-2) ... Setting up liberfa1:arm64 (1.4.0-1) ... Setting up libgraphite2-3:arm64 (1.3.13-7) ... Setting up liblcms2-2:arm64 (2.9-3) ... Setting up libpixman-1-0:arm64 (0.36.0-1) ... Setting up lsb-base (10.2019051400) ... Setting up libxau6:arm64 (1:1.0.8-1+b2) ... Setting up libkeyutils1:arm64 (1.6-6) ... Setting up mime-support (3.62) ... Setting up libtexlua52:arm64 (2018.20181218.49446-1) ... Setting up fonts-gfs-porson (1.1-6) ... Setting up libmagic-mgc (1:5.35-4+deb10u1) ... Setting up libtexlua53:arm64 (2018.20181218.49446-1) ... Setting up libarchive-zip-perl (1.64-1) ... Setting up libglib2.0-0:arm64 (2.58.3-2+deb10u2) ... No schema files found: doing nothing. Setting up libssl1.1:arm64 (1.1.1d-0+deb10u3) ... Setting up libijs-0.35:arm64 (0.35-14) ... Setting up libbrotli1:arm64 (1.0.7-2) ... Setting up liberfa-dev (1.4.0-1) ... Setting up x11-common (1:7.7+19) ... update-rc.d: warning: start and stop actions are no longer supported; falling back to defaults invoke-rc.d: could not determine current runlevel Setting up X socket directories... /tmp/.X11-unix /tmp/.ICE-unix. Setting up libmagic1:arm64 (1:5.35-4+deb10u1) ... Setting up perl-doc (5.28.1-6+deb10u1) ... Setting up gettext-base (0.19.8.1-9) ... Setting up libcminpack1:arm64 (1.3.6-4) ... Setting up libzzip-0-13:arm64 (0.13.62-3.2) ... Setting up file (1:5.35-4+deb10u1) ... Setting up libnetpbm10 (2:10.0-15.3+b2) ... Setting up libjbig0:arm64 (2.1-3.1+b2) ... Setting up libicu63:arm64 (63.1-6+deb10u1) ... Setting up poppler-data (0.4.9-2) ... Setting up libkrb5support0:arm64 (1.17-3) ... Setting up autotools-dev (20180224.1) ... Setting up libjpeg62-turbo:arm64 (1:1.5.2-2+b1) ... Setting up libx11-data (2:1.6.7-1) ... Setting up libnspr4:arm64 (2:4.20-1) ... Setting up libjbig2dec0:arm64 (0.16-1) ... Setting up libidn11:arm64 (1.33-2.2) ... Setting up libteckit0:arm64 (2.5.8+ds2-5) ... Setting up libavahi-common-data:arm64 (0.7-4+b1) ... Setting up libncurses6:arm64 (6.1+20181013-2+deb10u2) ... Setting up libdbus-1-3:arm64 (1.12.20-0+deb10u1) ... Setting up libsigsegv2:arm64 (2.12-2) ... Setting up t1utils (1.41-3) ... Setting up libpng16-16:arm64 (1.6.36-6) ... Setting up libstarlink-pal0:arm64 (0.9.8-1) ... Setting up autopoint (0.19.8.1-9) ... Setting up libwebp6:arm64 (0.6.1-2) ... Setting up fonts-dejavu-core (2.37-1) ... Setting up libk5crypto3:arm64 (1.17-3) ... Setting up libkpathsea6:arm64 (2018.20181218.49446-1) ... Setting up fonts-gfs-baskerville (1.1-5) ... Setting up sensible-utils (0.0.12) ... Setting up libxxhash0:arm64 (0.6.5-2) ... Setting up libuchardet0:arm64 (0.0.6-3) ... Setting up fonts-lmodern (2.004.5-6) ... Setting up libopenjp2-7:arm64 (2.3.0-2+deb10u1) ... Setting up libkrb5-3:arm64 (1.17-3) ... Setting up libtiff5:arm64 (4.1.0+git191117-2~deb10u1) ... Setting up libbsd0:arm64 (0.9.1-2) ... Setting up libelf1:arm64 (0.176-1.1) ... Setting up readline-common (7.0-5) ... Setting up libxml2:arm64 (2.9.4+dfsg1-7+b3) ... Setting up xdg-utils (1.1.3-1+deb10u1) ... Setting up libsynctex2:arm64 (2018.20181218.49446-1) ... Setting up libreadline7:arm64 (7.0-5) ... Setting up libpotrace0:arm64 (1.15-1) ... Setting up libfile-stripnondeterminism-perl (1.1.2-1) ... Setting up libice6:arm64 (2:1.0.9-2) ... Setting up libxdmcp6:arm64 (1:1.1.2-3) ... Setting up libxcb1:arm64 (1.13.1-2) ... Setting up libcminpack-dev:arm64 (1.3.6-4) ... Setting up libwoff1:arm64 (1.0.2-1) ... Setting up libtool (2.4.6-9) ... Setting up libxcb-render0:arm64 (1.13.1-2) ... Setting up libavahi-common3:arm64 (0.7-4+b1) ... Setting up m4 (1.4.18-2) ... Setting up libnss3:arm64 (2:3.42.1-1+deb10u3) ... Setting up libxcb-shm0:arm64 (1.13.1-2) ... Setting up libstarlink-pal-dev:arm64 (0.9.8-1) ... Setting up libpython2.7-stdlib:arm64 (2.7.16-2+deb10u1) ... Setting up libptexenc1:arm64 (2018.20181218.49446-1) ... Setting up libfreetype6:arm64 (2.9.1-3+deb10u1) ... Setting up bsdmainutils (11.1.2+b1) ... update-alternatives: using /usr/bin/bsd-write to provide /usr/bin/write (write) in auto mode update-alternatives: using /usr/bin/bsd-from to provide /usr/bin/from (from) in auto mode Setting up libgssapi-krb5-2:arm64 (1.17-3) ... Setting up libcroco3:arm64 (0.6.12-3) ... Setting up ucf (3.0038+nmu1) ... Setting up netpbm (2:10.0-15.3+b2) ... Setting up autoconf (2.69-11) ... Setting up dwz (0.12-3) ... Setting up groff-base (1.22.4-3) ... Setting up libx11-6:arm64 (2:1.6.7-1) ... Setting up libharfbuzz0b:arm64 (2.3.1-1) ... Setting up libsm6:arm64 (2:1.2.3-1) ... Setting up libavahi-client3:arm64 (0.7-4+b1) ... Setting up automake (1:1.16.1-4) ... update-alternatives: using /usr/bin/automake-1.16 to provide /usr/bin/automake (automake) in auto mode Setting up libpaper1:arm64 (1.1.28) ... Creating config file /etc/papersize with new version Setting up gettext (0.19.8.1-9) ... Setting up libharfbuzz-icu0:arm64 (2.3.1-1) ... Setting up libxpm4:arm64 (1:3.5.12-1) ... Setting up python2.7 (2.7.16-2+deb10u1) ... Setting up libxrender1:arm64 (1:0.9.10-1) ... Setting up libpython2-stdlib:arm64 (2.7.16-1) ... Setting up fontconfig-config (2.13.1-2) ... Setting up libxext6:arm64 (2:1.3.3-1+b2) ... Setting up libpaper-utils (1.1.28) ... Setting up man-db (2.8.5-2) ... Not building database; man-db/auto-update is not 'true'. Setting up python2 (2.7.16-1) ... Setting up intltool-debian (0.35.0+20060710.5) ... Setting up tex-common (6.11) ... update-language: texlive-base not installed and configured, doing nothing! Setting up libpython-stdlib:arm64 (2.7.16-1) ... Setting up libxt6:arm64 (1:1.1.5-1+b3) ... Setting up libcups2:arm64 (2.2.10-6+deb10u3) ... Setting up libfontconfig1:arm64 (2.13.1-2) ... Setting up python (2.7.16-1) ... Setting up libxmu6:arm64 (2:1.1.2-2+b3) ... Setting up libxi6:arm64 (2:1.7.9-1) ... Setting up po-debconf (1.0.21) ... Setting up preview-latex-style (11.91-2) ... Setting up libpoppler82:arm64 (0.71.0-5) ... Setting up libxaw7:arm64 (2:1.0.13-1+b2) ... Setting up libcairo2:arm64 (1.16.0-4) ... Setting up libcupsimage2:arm64 (2.2.10-6+deb10u3) ... Setting up poppler-utils (0.71.0-5) ... Setting up libgs9:arm64 (9.27~dfsg-2+deb10u3) ... Setting up ghostscript (9.27~dfsg-2+deb10u3) ... Setting up texlive-binaries (2018.20181218.49446-1) ... update-alternatives: using /usr/bin/xdvi-xaw to provide /usr/bin/xdvi.bin (xdvi.bin) in auto mode update-alternatives: using /usr/bin/bibtex.original to provide /usr/bin/bibtex (bibtex) in auto mode Setting up texlive-base (2018.20190227-2) ... tl-paper: setting paper size for dvips to a4: /var/lib/texmf/dvips/config/config-paper.ps tl-paper: setting paper size for dvipdfmx to a4: /var/lib/texmf/dvipdfmx/dvipdfmx-paper.cfg tl-paper: setting paper size for xdvi to a4: /var/lib/texmf/xdvi/XDvi-paper tl-paper: setting paper size for pdftex to a4: /var/lib/texmf/tex/generic/config/pdftexconfig.tex Setting up texlive-lang-greek (2018.20190227-2) ... Setting up ghostscript-x (9.27~dfsg-2+deb10u3) ... Setting up texlive-font-utils (2018.20190227-2) ... Setting up texlive-latex-base (2018.20190227-2) ... Setting up texlive-latex-recommended (2018.20190227-2) ... Setting up texlive-pictures (2018.20190227-2) ... Setting up texlive-fonts-recommended (2018.20190227-2) ... Setting up texlive (2018.20190227-2) ... Setting up texlive-science (2018.20190227-2) ... Setting up texlive-latex-extra (2018.20190227-2) ... Setting up latex2html (2019-debian1-3) ... Setting up debhelper (12.1.1) ... Setting up dh-autoreconf (19) ... Setting up dh-strip-nondeterminism (1.1.2-1) ... Processing triggers for libc-bin (2.28-10) ... Processing triggers for tex-common (6.11) ... Running updmap-sys. This may take some time... done. Running mktexlsr /var/lib/texmf ... done. Building format(s) --all. This may take some time... done. Reading package lists... Building dependency tree... Reading state information... Reading extended state information... Initializing package states... Writing extended state information... Building tag database... -> Finished parsing the build-deps Reading package lists... Building dependency tree... Reading state information... fakeroot is already the newest version (1.23-1). 0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded. I: Building the package I: Running cd /build/starlink-ast-8.6.3+dfsg/ && env PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/i/capture/the/path" HOME="/nonexistent/second-build" dpkg-buildpackage -us -uc -b dpkg-buildpackage: info: source package starlink-ast dpkg-buildpackage: info: source version 8.6.3+dfsg-1 dpkg-buildpackage: info: source distribution unstable dpkg-buildpackage: info: source changed by Ole Streicher dpkg-source --before-build . dpkg-buildpackage: info: host architecture arm64 fakeroot debian/rules clean dh clean --with autoreconf dh_clean debian/rules build dh build --with autoreconf dh_update_autotools_config debian/rules override_dh_autoreconf make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' cp ast.news NEWS dh_autoreconf libtoolize: putting auxiliary files in AC_CONFIG_AUX_DIR, 'build-aux'. libtoolize: copying file 'build-aux/ltmain.sh' libtoolize: Consider adding 'AC_CONFIG_MACRO_DIRS([m4])' to configure.ac, libtoolize: and rerunning libtoolize and aclocal. libtoolize: Consider adding '-I m4' to ACLOCAL_AMFLAGS in Makefile.am. configure.ac:67: installing 'build-aux/compile' configure.ac:16: installing 'build-aux/missing' Makefile.am: installing 'build-aux/depcomp' Makefile.am:682: warning: variable 'libstarlink_ast_drama_la_SOURCES' is defined but no program or Makefile.am:682: library has 'libstarlink_ast_drama_la' as canonical name (possible typo) Makefile.am:679: warning: variable 'libstarlink_ast_ems_la_SOURCES' is defined but no program or Makefile.am:679: library has 'libstarlink_ast_ems_la' as canonical name (possible typo) make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' debian/rules override_dh_auto_configure make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' dh_auto_configure -- --with-external_pal ./configure --build=aarch64-linux-gnu --prefix=/usr --includedir=\${prefix}/include --mandir=\${prefix}/share/man --infodir=\${prefix}/share/info --sysconfdir=/etc --localstatedir=/var --disable-silent-rules --libdir=\${prefix}/lib/aarch64-linux-gnu --libexecdir=\${prefix}/lib/aarch64-linux-gnu --runstatedir=/run --disable-maintainer-mode --disable-dependency-tracking --with-external_pal configure: WARNING: unrecognized options: --disable-maintainer-mode checking for a BSD-compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking for a thread-safe mkdir -p... /bin/mkdir -p checking for gawk... no checking for mawk... mawk checking whether make sets $(MAKE)... yes checking whether make supports nested variables... yes ./configure: line 3304: ,: command not found checking for gcc... gcc checking whether the C compiler works... yes checking for C compiler default output file name... a.out checking for suffix of executables... checking whether we are cross compiling... no checking for suffix of object files... o checking whether we are using the GNU C compiler... yes checking whether gcc accepts -g... yes checking for gcc option to accept ISO C89... none needed checking whether gcc understands -c and -o together... yes checking whether make supports the include directive... yes (GNU style) checking dependency style of gcc... none checking how to run the C preprocessor... gcc -E checking build system type... aarch64-unknown-linux-gnu checking host system type... aarch64-unknown-linux-gnu checking how to print strings... printf checking for a sed that does not truncate output... /bin/sed checking for grep that handles long lines and -e... /bin/grep checking for egrep... /bin/grep -E checking for fgrep... /bin/grep -F checking for ld used by gcc... /usr/bin/ld checking if the linker (/usr/bin/ld) is GNU ld... yes checking for BSD- or MS-compatible name lister (nm)... /usr/bin/nm -B checking the name lister (/usr/bin/nm -B) interface... BSD nm checking whether ln -s works... yes checking the maximum length of command line arguments... 1572864 checking how to convert aarch64-unknown-linux-gnu file names to aarch64-unknown-linux-gnu format... func_convert_file_noop checking how to convert aarch64-unknown-linux-gnu file names to toolchain format... func_convert_file_noop checking for /usr/bin/ld option to reload object files... -r checking for objdump... objdump checking how to recognize dependent libraries... pass_all checking for dlltool... no checking how to associate runtime and link libraries... printf %s\n checking for ar... ar checking for archiver @FILE support... @ checking for strip... strip checking for ranlib... ranlib checking command to parse /usr/bin/nm -B output from gcc object... ok checking for sysroot... no checking for a working dd... /bin/dd checking how to truncate binary pipes... /bin/dd bs=4096 count=1 checking for mt... no checking if : is a manifest tool... no checking for ANSI C header files... yes checking for sys/types.h... yes checking for sys/stat.h... yes checking for stdlib.h... yes checking for string.h... yes checking for memory.h... yes checking for strings.h... yes checking for inttypes.h... yes checking for stdint.h... yes checking for unistd.h... yes checking for dlfcn.h... yes checking for objdir... .libs checking if gcc supports -fno-rtti -fno-exceptions... no checking for gcc option to produce PIC... -fPIC -DPIC checking if gcc PIC flag -fPIC -DPIC works... yes checking if gcc static flag -static works... yes checking if gcc supports -c -o file.o... yes checking if gcc supports -c -o file.o... (cached) yes checking whether the gcc linker (/usr/bin/ld) supports shared libraries... yes checking whether -lc should be explicitly linked in... no checking dynamic linker characteristics... GNU/Linux ld.so checking how to hardcode library paths into programs... immediate checking whether stripping libraries is possible... yes checking if libtool supports shared libraries... yes checking whether to build shared libraries... yes checking whether to build static libraries... yes checking whether ln -s works... yes checking for pthread_create in -lpthread... yes checking stdarg.h usability... yes checking stdarg.h presence... yes checking for stdarg.h... yes checking execinfo.h usability... yes checking execinfo.h presence... yes checking for execinfo.h... yes checking for backtrace... yes checking for strerror_r... yes checking for strtok_r... yes checking for vsnprintf... yes checking for long double... yes checking for int64_t... yes checking for uint64_t... yes checking size of long... 8 checking size of long long... 8 checking whether C compiler defines __func__... yes checking for gfortran... no checking for g95... no checking for xlf95... no checking for f95... no checking for fort... no checking for ifort... no checking for ifc... no checking for efc... no checking for pgfortran... no checking for pgf95... no checking for lf95... no checking for ftn... no checking for nagfor... no checking for xlf90... no checking for f90... no checking for pgf90... no checking for pghpf... no checking for epcf90... no checking for g77... no checking for xlf... no checking for f77... no checking for frt... no checking for pgf77... no checking for cf77... no checking for fort77... no checking for fl32... no checking for af77... no checking whether we are using the GNU Fortran compiler... no checking whether accepts -g... no checking how to get verbose linking output from ... configure: WARNING: compilation failed checking for Fortran libraries of ... checking for perl... /usr/bin/perl checking for isnan... yes checking whether isnan is declared... yes checking for isfinite... no checking whether isfinite is declared... yes checking whether the sscanf function is ANSI-compatible... yes checking that generated files are newer than configure... done configure: creating ./config.status config.status: creating Makefile config.status: creating component.xml config.status: creating ast_link config.status: creating ast_link_adam config.status: creating object.h config.status: creating f77.h config.status: creating ast_cpp config.status: creating config.h config.status: executing depfiles commands config.status: executing libtool commands configure: WARNING: unrecognized options: --disable-maintainer-mode make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' dh_auto_build make -j8 make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make all-am make[2]: Entering directory '/build/starlink-ast-8.6.3+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o astbad.o astbad.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-axis.lo `test -f 'axis.c' || echo './'`axis.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-box.lo `test -f 'box.c' || echo './'`box.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-channel.lo `test -f 'channel.c' || echo './'`channel.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-chebymap.lo `test -f 'chebymap.c' || echo './'`chebymap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-circle.lo `test -f 'circle.c' || echo './'`circle.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-cmpframe.lo `test -f 'cmpframe.c' || echo './'`cmpframe.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-cmpmap.lo `test -f 'cmpmap.c' || echo './'`cmpmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c box.c -fPIC -DPIC -o .libs/libstarlink_ast_la-box.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c chebymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-chebymap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c axis.c -fPIC -DPIC -o .libs/libstarlink_ast_la-axis.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c circle.c -fPIC -DPIC -o .libs/libstarlink_ast_la-circle.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c channel.c -fPIC -DPIC -o .libs/libstarlink_ast_la-channel.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-cmpframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-cmpmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-cmpregion.lo `test -f 'cmpregion.c' || echo './'`cmpregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpregion.c -fPIC -DPIC -o .libs/libstarlink_ast_la-cmpregion.o cmpframe.c: In function 'GetAttrib': cmpframe.c:3289:32: warning: '%d' directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~ cmpframe.c:3289:28: note: directive argument in the range [-2147483647, 2147483647] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from cmpframe.c:551: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 4 and 93 bytes into a destination of size 80 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c chebymap.c -fPIC -DPIC -o libstarlink_ast_la-chebymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c circle.c -fPIC -DPIC -o libstarlink_ast_la-circle.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c axis.c -fPIC -DPIC -o libstarlink_ast_la-axis.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpmap.c -fPIC -DPIC -o libstarlink_ast_la-cmpmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpregion.c -fPIC -DPIC -o libstarlink_ast_la-cmpregion.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c box.c -fPIC -DPIC -o libstarlink_ast_la-box.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-dsbspecframe.lo `test -f 'dsbspecframe.c' || echo './'`dsbspecframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c dsbspecframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-dsbspecframe.o cmpframe.c: In function 'TestAttrib': cmpframe.c:9614:35: warning: '%d' directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~ cmpframe.c:9614:31: note: directive argument in the range [-2147483647, 2147483647] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from cmpframe.c:551: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 4 and 93 bytes into a destination of size 80 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ cmpframe.c: In function 'SetAttrib.part.72': cmpframe.c:8308:21: warning: '%d' directive writing between 1 and 11 bytes into a region of size between 0 and 1023 [-Wformat-overflow=] nc = sprintf( buf2, "%s(%d)=%s", buf1, paxis + 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ setting+value ); ~~~~~~~~~~~~~~~ cmpframe.c:8308:21: note: directive argument in the range [-2147483647, 2147483647] In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from cmpframe.c:551: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output 5 or more bytes (assuming 1038) into a destination of size 1024 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ cmpframe.c:8322:43: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( buf2, "%s=%s", buf1, setting+value ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from cmpframe.c:551: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output 2 or more bytes (assuming 1025) into a destination of size 1024 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ cmpframe.c: In function 'ClearAttrib': cmpframe.c:1612:35: warning: '%d' directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~ cmpframe.c:1612:31: note: directive argument in the range [-2147483647, 2147483647] sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); ^~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from cmpframe.c:551: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 4 and 93 bytes into a destination of size 80 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c channel.c -fPIC -DPIC -o libstarlink_ast_la-channel.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-dssmap.lo `test -f 'dssmap.c' || echo './'`dssmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c dssmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-dssmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ellipse.lo `test -f 'ellipse.c' || echo './'`ellipse.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ellipse.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ellipse.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c dsbspecframe.c -fPIC -DPIC -o libstarlink_ast_la-dsbspecframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c dssmap.c -fPIC -DPIC -o libstarlink_ast_la-dssmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-error.lo `test -f 'error.c' || echo './'`error.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fitschan.lo `test -f 'fitschan.c' || echo './'`fitschan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c error.c -fPIC -DPIC -o .libs/libstarlink_ast_la-error.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c cmpframe.c -fPIC -DPIC -o libstarlink_ast_la-cmpframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fitschan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fitschan.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fitstable.lo `test -f 'fitstable.c' || echo './'`fitstable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fitstable.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fitstable.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fluxframe.lo `test -f 'fluxframe.c' || echo './'`fluxframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fluxframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fluxframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c error.c -fPIC -DPIC -o libstarlink_ast_la-error.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ellipse.c -fPIC -DPIC -o libstarlink_ast_la-ellipse.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-frame.lo `test -f 'frame.c' || echo './'`frame.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c frame.c -fPIC -DPIC -o .libs/libstarlink_ast_la-frame.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-frameset.lo `test -f 'frameset.c' || echo './'`frameset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c frameset.c -fPIC -DPIC -o .libs/libstarlink_ast_la-frameset.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-globals.lo `test -f 'globals.c' || echo './'`globals.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c globals.c -fPIC -DPIC -o .libs/libstarlink_ast_la-globals.o fitstable.c: In function 'GetTableHeader': fitstable.c:2271:34: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] sprintf( keyword, "TFORM%d", icol ); ^~ fitstable.c:2271:28: note: directive argument in the range [1, 2147483647] sprintf( keyword, "TFORM%d", icol ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from fitstable.c:103: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitstable.c:2275:34: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] sprintf( keyword, "TTYPE%d", icol ); ^~ fitstable.c:2275:28: note: directive argument in the range [1, 2147483647] sprintf( keyword, "TTYPE%d", icol ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from fitstable.c:103: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitstable.c:2280:37: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] sprintf( keyword, "TUNIT%d", icol ); ^~ fitstable.c:2280:31: note: directive argument in the range [1, 2147483647] sprintf( keyword, "TUNIT%d", icol ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from fitstable.c:103: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitstable.c:2291:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] sprintf( keyword, "TNULL%d", icol ); ^~ fitstable.c:2291:34: note: directive argument in the range [1, 2147483647] sprintf( keyword, "TNULL%d", icol ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from fitstable.c:103: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitstable.c:2317:41: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( keyword, "TDIM%d", icol ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from fitstable.c:103: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 6 and 15 bytes into a destination of size 14 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c globals.c -fPIC -DPIC -o libstarlink_ast_la-globals.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fitstable.c -fPIC -DPIC -o libstarlink_ast_la-fitstable.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-grismmap.lo `test -f 'grismmap.c' || echo './'`grismmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grismmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-grismmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-interval.lo `test -f 'interval.c' || echo './'`interval.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fluxframe.c -fPIC -DPIC -o libstarlink_ast_la-fluxframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c interval.c -fPIC -DPIC -o .libs/libstarlink_ast_la-interval.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-intramap.lo `test -f 'intramap.c' || echo './'`intramap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c intramap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-intramap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-keymap.lo `test -f 'keymap.c' || echo './'`keymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c keymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-keymap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grismmap.c -fPIC -DPIC -o libstarlink_ast_la-grismmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c interval.c -fPIC -DPIC -o libstarlink_ast_la-interval.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c intramap.c -fPIC -DPIC -o libstarlink_ast_la-intramap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-loader.lo `test -f 'loader.c' || echo './'`loader.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c loader.c -fPIC -DPIC -o .libs/libstarlink_ast_la-loader.o fitschan.c: In function 'CnvValue.isra.42.part.43': fitschan.c:7085:47: warning: '%s' directive writing up to 80 bytes into a region of size between 0 and 80 [-Wformat-overflow=] (void) sprintf( cnvtype_text, "%s %s", cnvtype_text0, cnvtype_text1 ); ^~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 2 and 162 bytes into a destination of size 81 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c loader.c -fPIC -DPIC -o libstarlink_ast_la-loader.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-lutmap.lo `test -f 'lutmap.c' || echo './'`lutmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c lutmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-lutmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-mapping.lo `test -f 'mapping.c' || echo './'`mapping.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c mapping.c -fPIC -DPIC -o .libs/libstarlink_ast_la-mapping.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-mathmap.lo `test -f 'mathmap.c' || echo './'`mathmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c mathmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-mathmap.o fitschan.c: In function 'IsMapTab1D': fitschan.c:18903:44: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( cellname, "COORDS%d(1)", iwcs + 1 ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 11 and 21 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:18993:44: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( cellname, "COORDS%d(1)", iwcs + 1 ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 11 and 21 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c frameset.c -fPIC -DPIC -o libstarlink_ast_la-frameset.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-matrixmap.lo `test -f 'matrixmap.c' || echo './'`matrixmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c matrixmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-matrixmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c lutmap.c -fPIC -DPIC -o libstarlink_ast_la-lutmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c frame.c -fPIC -DPIC -o libstarlink_ast_la-frame.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-memory.lo `test -f 'memory.c' || echo './'`memory.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c memory.c -fPIC -DPIC -o .libs/libstarlink_ast_la-memory.o memory.c: In function 'ChrMatcher': memory.c:3383:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 6 [-Wformat-overflow=] sprintf( stemp, ".*($%d).*", dollar ); ^~ memory.c:3383:35: note: directive argument in the range [1, 2147483647] sprintf( stemp, ".*($%d).*", dollar ); ^~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from axis.h:254, from globals.h:11, from memory.c:215: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 9 and 18 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c memory.c -fPIC -DPIC -o libstarlink_ast_la-memory.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c matrixmap.c -fPIC -DPIC -o libstarlink_ast_la-matrixmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c mathmap.c -fPIC -DPIC -o libstarlink_ast_la-mathmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-normmap.lo `test -f 'normmap.c' || echo './'`normmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c normmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-normmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-nullregion.lo `test -f 'nullregion.c' || echo './'`nullregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c nullregion.c -fPIC -DPIC -o .libs/libstarlink_ast_la-nullregion.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c normmap.c -fPIC -DPIC -o libstarlink_ast_la-normmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c nullregion.c -fPIC -DPIC -o libstarlink_ast_la-nullregion.o >/dev/null 2>&1 fitschan.c: In function 'MakeFitsFrameSet.isra.161': fitschan.c:20586:46: warning: '%d' directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] sprintf( system_attr, "System(%d)", ilon + 1 ); ^~ fitschan.c:20586:38: note: directive argument in the range [0, 2147483647] sprintf( system_attr, "System(%d)", ilon + 1 ); ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 10 and 19 bytes into a destination of size 12 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:20593:48: warning: '%d' directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] sprintf( equinox_attr, "Equinox(%d)", ilon + 1 ); ^~ fitschan.c:20593:39: note: directive argument in the range [0, 2147483647] sprintf( equinox_attr, "Equinox(%d)", ilon + 1 ); ^~~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 11 and 20 bytes into a destination of size 13 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-object.lo `test -f 'object.c' || echo './'`object.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-pcdmap.lo `test -f 'pcdmap.c' || echo './'`pcdmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c object.c -fPIC -DPIC -o .libs/libstarlink_ast_la-object.o fitschan.c: In function 'ConcatWAT.constprop': fitschan.c:7366:26: warning: '%d' directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); ^~ fitschan.c:7366:22: note: directive argument in the range [-2147483647, 2147483647] sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 9 and 19 bytes into a destination of size 13 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:7386:32: warning: '%d' directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); ^~ fitschan.c:7386:28: note: directive argument in the range [-2147483647, 2147483647] sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); ^~~~~~~~~~~~ fitschan.c:7386:28: note: directive argument in the range [2, 2147483647] In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 9 and 26 bytes into a destination of size 13 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c keymap.c -fPIC -DPIC -o libstarlink_ast_la-keymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pcdmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-pcdmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-permmap.lo `test -f 'permmap.c' || echo './'`permmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c permmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-permmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-plot.lo `test -f 'plot.c' || echo './'`plot.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c plot.c -fPIC -DPIC -o .libs/libstarlink_ast_la-plot.o fitschan.c: In function 'CLASSFromStore.constprop': fitschan.c:5848:44: warning: '%d' directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] sprintf( attbuf, "IsLonAxis(%d)", i + 1 ); ^~ fitschan.c:5848:33: note: directive argument in the range [-2147483647, 3] sprintf( attbuf, "IsLonAxis(%d)", i + 1 ); ^~~~~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 13 and 23 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c: In function 'PCFromStore.constprop': fitschan.c:23818:38: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] sprintf( keyname, "C%dYPE%d", is, i + 1 ); ^~ fitschan.c:23818:31: note: directive argument in the range [1, 2147483647] sprintf( keyname, "C%dYPE%d", is, i + 1 ); ^~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 18 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:23816:37: warning: '%d' directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] sprintf( keyname, "CTYPE%d", i + 1 ); ^~ fitschan.c:23816:31: note: directive argument in the range [1, 2147483647] sprintf( keyname, "CTYPE%d", i + 1 ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:23861:41: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] sprintf( keyname, "C%dNIT%d", is, i + 1 ); ^~ fitschan.c:23861:34: note: directive argument in the range [1, 2147483647] sprintf( keyname, "C%dNIT%d", is, i + 1 ); ^~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 18 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:23859:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] sprintf( keyname, "CUNIT%d", i + 1 ); ^~ fitschan.c:23859:34: note: directive argument in the range [1, 2147483647] sprintf( keyname, "CUNIT%d", i + 1 ); ^~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pcdmap.c -fPIC -DPIC -o libstarlink_ast_la-pcdmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c permmap.c -fPIC -DPIC -o libstarlink_ast_la-permmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c object.c -fPIC -DPIC -o libstarlink_ast_la-object.o >/dev/null 2>&1 fitschan.c: In function 'SkySys.part.187.constprop': fitschan.c:28702:40: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( attr, "SkyRefP(%d)", axlon + 1 ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 11 and 21 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:28704:40: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( attr, "SkyRefP(%d)", axlat + 1 ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 11 and 21 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-plot3d.lo `test -f 'plot3d.c' || echo './'`plot3d.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c plot3d.c -fPIC -DPIC -o .libs/libstarlink_ast_la-plot3d.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-pointlist.lo `test -f 'pointlist.c' || echo './'`pointlist.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pointlist.c -fPIC -DPIC -o .libs/libstarlink_ast_la-pointlist.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-pointset.lo `test -f 'pointset.c' || echo './'`pointset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pointset.c -fPIC -DPIC -o .libs/libstarlink_ast_la-pointset.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-polygon.lo `test -f 'polygon.c' || echo './'`polygon.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c polygon.c -fPIC -DPIC -o .libs/libstarlink_ast_la-polygon.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pointset.c -fPIC -DPIC -o libstarlink_ast_la-pointset.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c pointlist.c -fPIC -DPIC -o libstarlink_ast_la-pointlist.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-polymap.lo `test -f 'polymap.c' || echo './'`polymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c polymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-polymap.o fitschan.c: In function 'AddFrame.part.207.constprop': fitschan.c:37551:39: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] sprintf( buf, "%s-%s", newdom, buf2 ); ^ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output 2 or more bytes (assuming 101) into a destination of size 100 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-prism.lo `test -f 'prism.c' || echo './'`prism.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c prism.c -fPIC -DPIC -o .libs/libstarlink_ast_la-prism.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c plot3d.c -fPIC -DPIC -o libstarlink_ast_la-plot3d.o >/dev/null 2>&1 fitschan.c: In function 'SpecTrans.constprop': fitschan.c:29997:44: warning: '%.3d' directive writing between 3 and 11 bytes into a region of size between 1 and 8 [-Wformat-overflow=] sprintf( keyname, "CD%.3d%.3d", j + 1, i + 1 ); ^~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 9 and 24 bytes into a destination of size 13 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:25785:34: warning: '%d' directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] sprintf( keyname, "CO%d_%d", i + 1, m + 1 ); ^~ fitschan.c:25785:31: note: directive argument in the range [1, 2147483647] sprintf( keyname, "CO%d_%d", i + 1, m + 1 ); ^~~~~~~~~ fitschan.c:25785:31: note: directive argument in the range [1, 13] In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 6 and 16 bytes into a destination of size 10 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ratemap.lo `test -f 'ratemap.c' || echo './'`ratemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ratemap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ratemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c prism.c -fPIC -DPIC -o libstarlink_ast_la-prism.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c polymap.c -fPIC -DPIC -o libstarlink_ast_la-polymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ratemap.c -fPIC -DPIC -o libstarlink_ast_la-ratemap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-region.lo `test -f 'region.c' || echo './'`region.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c region.c -fPIC -DPIC -o .libs/libstarlink_ast_la-region.o fitschan.c: In function 'AddVersion.constprop': fitschan.c:10414:38: warning: '%d' directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] sprintf( attr_name, "Symbol(%d)", i + 1 ); ^~ fitschan.c:10414:30: note: directive argument in the range [1, 2147483647] sprintf( attr_name, "Symbol(%d)", i + 1 ); ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 10 and 19 bytes into a destination of size 15 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ fitschan.c:10451:41: warning: '%d' directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] sprintf( attr_name, "Symbol(%d)", i + 1 ); ^~ fitschan.c:10451:33: note: directive argument in the range [1, 2147483647] sprintf( attr_name, "Symbol(%d)", i + 1 ); ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 10 and 19 bytes into a destination of size 15 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-selectormap.lo `test -f 'selectormap.c' || echo './'`selectormap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c selectormap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-selectormap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c selectormap.c -fPIC -DPIC -o libstarlink_ast_la-selectormap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-shiftmap.lo `test -f 'shiftmap.c' || echo './'`shiftmap.c fitschan.c: In function 'Read': fitschan.c:11201:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] sprintf( buff, "Pixel axis %d", i + 1 ); ^~ fitschan.c:11201:28: note: directive argument in the range [1, 2147483647] sprintf( buff, "Pixel axis %d", i + 1 ); ^~~~~~~~~~~~~~~ In file included from /usr/include/stdio.h:873, from object.h:350, from channel.h:220, from fitschan.c:1374: /usr/include/aarch64-linux-gnu/bits/stdio2.h:36:10: note: '__builtin___sprintf_chk' output between 13 and 22 bytes into a destination of size 20 return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ __bos (__s), __fmt, __va_arg_pack ()); ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c shiftmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-shiftmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-skyaxis.lo `test -f 'skyaxis.c' || echo './'`skyaxis.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c skyaxis.c -fPIC -DPIC -o .libs/libstarlink_ast_la-skyaxis.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-skyframe.lo `test -f 'skyframe.c' || echo './'`skyframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c skyframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-skyframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c shiftmap.c -fPIC -DPIC -o libstarlink_ast_la-shiftmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-slamap.lo `test -f 'slamap.c' || echo './'`slamap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c slamap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-slamap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c skyaxis.c -fPIC -DPIC -o libstarlink_ast_la-skyaxis.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c slamap.c -fPIC -DPIC -o libstarlink_ast_la-slamap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c region.c -fPIC -DPIC -o libstarlink_ast_la-region.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fitschan.c -fPIC -DPIC -o libstarlink_ast_la-fitschan.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-specfluxframe.lo `test -f 'specfluxframe.c' || echo './'`specfluxframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specfluxframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-specfluxframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c skyframe.c -fPIC -DPIC -o libstarlink_ast_la-skyframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specfluxframe.c -fPIC -DPIC -o libstarlink_ast_la-specfluxframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-specframe.lo `test -f 'specframe.c' || echo './'`specframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-specframe.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-specmap.lo `test -f 'specmap.c' || echo './'`specmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-specmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c plot.c -fPIC -DPIC -o libstarlink_ast_la-plot.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specmap.c -fPIC -DPIC -o libstarlink_ast_la-specmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c specframe.c -fPIC -DPIC -o libstarlink_ast_la-specframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-sphmap.lo `test -f 'sphmap.c' || echo './'`sphmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c sphmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-sphmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c sphmap.c -fPIC -DPIC -o libstarlink_ast_la-sphmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stc.lo `test -f 'stc.c' || echo './'`stc.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stc.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stc.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stccatalogentrylocation.lo `test -f 'stccatalogentrylocation.c' || echo './'`stccatalogentrylocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stccatalogentrylocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stccatalogentrylocation.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stcobsdatalocation.lo `test -f 'stcobsdatalocation.c' || echo './'`stcobsdatalocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcobsdatalocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stcobsdatalocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stccatalogentrylocation.c -fPIC -DPIC -o libstarlink_ast_la-stccatalogentrylocation.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcobsdatalocation.c -fPIC -DPIC -o libstarlink_ast_la-stcobsdatalocation.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stc.c -fPIC -DPIC -o libstarlink_ast_la-stc.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stcresourceprofile.lo `test -f 'stcresourceprofile.c' || echo './'`stcresourceprofile.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcresourceprofile.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stcresourceprofile.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stcschan.lo `test -f 'stcschan.c' || echo './'`stcschan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcschan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stcschan.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-stcsearchlocation.lo `test -f 'stcsearchlocation.c' || echo './'`stcsearchlocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcsearchlocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-stcsearchlocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcresourceprofile.c -fPIC -DPIC -o libstarlink_ast_la-stcresourceprofile.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-switchmap.lo `test -f 'switchmap.c' || echo './'`switchmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcsearchlocation.c -fPIC -DPIC -o libstarlink_ast_la-stcsearchlocation.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-table.lo `test -f 'table.c' || echo './'`table.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c switchmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-switchmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c table.c -fPIC -DPIC -o .libs/libstarlink_ast_la-table.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-timeframe.lo `test -f 'timeframe.c' || echo './'`timeframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c timeframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-timeframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c switchmap.c -fPIC -DPIC -o libstarlink_ast_la-switchmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-timemap.lo `test -f 'timemap.c' || echo './'`timemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c timemap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-timemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c table.c -fPIC -DPIC -o libstarlink_ast_la-table.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c timeframe.c -fPIC -DPIC -o libstarlink_ast_la-timeframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c stcschan.c -fPIC -DPIC -o libstarlink_ast_la-stcschan.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c timemap.c -fPIC -DPIC -o libstarlink_ast_la-timemap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-tranmap.lo `test -f 'tranmap.c' || echo './'`tranmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c tranmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-tranmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-unit.lo `test -f 'unit.c' || echo './'`unit.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unit.c -fPIC -DPIC -o .libs/libstarlink_ast_la-unit.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c tranmap.c -fPIC -DPIC -o libstarlink_ast_la-tranmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-unitmap.lo `test -f 'unitmap.c' || echo './'`unitmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unitmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-unitmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unitmap.c -fPIC -DPIC -o libstarlink_ast_la-unitmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-unitnormmap.lo `test -f 'unitnormmap.c' || echo './'`unitnormmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unitnormmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-unitnormmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-wcsmap.lo `test -f 'wcsmap.c' || echo './'`wcsmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcsmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-wcsmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unitnormmap.c -fPIC -DPIC -o libstarlink_ast_la-unitnormmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c unit.c -fPIC -DPIC -o libstarlink_ast_la-unit.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-winmap.lo `test -f 'winmap.c' || echo './'`winmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c winmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-winmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcsmap.c -fPIC -DPIC -o libstarlink_ast_la-wcsmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-xml.lo `test -f 'xml.c' || echo './'`xml.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c xml.c -fPIC -DPIC -o .libs/libstarlink_ast_la-xml.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c winmap.c -fPIC -DPIC -o libstarlink_ast_la-winmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-xmlchan.lo `test -f 'xmlchan.c' || echo './'`xmlchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c xmlchan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-xmlchan.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-zoommap.lo `test -f 'zoommap.c' || echo './'`zoommap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c zoommap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-zoommap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-c2f77.lo `test -f 'c2f77.c' || echo './'`c2f77.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c zoommap.c -fPIC -DPIC -o libstarlink_ast_la-zoommap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c c2f77.c -fPIC -DPIC -o .libs/libstarlink_ast_la-c2f77.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c c2f77.c -fPIC -DPIC -o libstarlink_ast_la-c2f77.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fbox.lo `test -f 'fbox.c' || echo './'`fbox.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fchannel.lo `test -f 'fchannel.c' || echo './'`fchannel.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fbox.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fbox.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fchannel.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fchannel.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fbox.c -fPIC -DPIC -o libstarlink_ast_la-fbox.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fchannel.c -fPIC -DPIC -o libstarlink_ast_la-fchannel.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fchebymap.lo `test -f 'fchebymap.c' || echo './'`fchebymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fchebymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fchebymap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fcircle.lo `test -f 'fcircle.c' || echo './'`fcircle.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fchebymap.c -fPIC -DPIC -o libstarlink_ast_la-fchebymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcircle.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fcircle.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fcmpframe.lo `test -f 'fcmpframe.c' || echo './'`fcmpframe.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fcmpmap.lo `test -f 'fcmpmap.c' || echo './'`fcmpmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fcmpframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcircle.c -fPIC -DPIC -o libstarlink_ast_la-fcircle.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fcmpmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpframe.c -fPIC -DPIC -o libstarlink_ast_la-fcmpframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c xml.c -fPIC -DPIC -o libstarlink_ast_la-xml.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fcmpregion.lo `test -f 'fcmpregion.c' || echo './'`fcmpregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpmap.c -fPIC -DPIC -o libstarlink_ast_la-fcmpmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpregion.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fcmpregion.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fdsbspecframe.lo `test -f 'fdsbspecframe.c' || echo './'`fdsbspecframe.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fdssmap.lo `test -f 'fdssmap.c' || echo './'`fdssmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fdsbspecframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fdsbspecframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fdssmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fdssmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fcmpregion.c -fPIC -DPIC -o libstarlink_ast_la-fcmpregion.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fdsbspecframe.c -fPIC -DPIC -o libstarlink_ast_la-fdsbspecframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fdssmap.c -fPIC -DPIC -o libstarlink_ast_la-fdssmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fellipse.lo `test -f 'fellipse.c' || echo './'`fellipse.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ferror.lo `test -f 'ferror.c' || echo './'`ferror.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fellipse.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fellipse.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ffitschan.lo `test -f 'ffitschan.c' || echo './'`ffitschan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ferror.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ferror.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffitschan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ffitschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fellipse.c -fPIC -DPIC -o libstarlink_ast_la-fellipse.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ferror.c -fPIC -DPIC -o libstarlink_ast_la-ferror.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ffitstable.lo `test -f 'ffitstable.c' || echo './'`ffitstable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffitstable.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ffitstable.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ffluxframe.lo `test -f 'ffluxframe.c' || echo './'`ffluxframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffluxframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ffluxframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffluxframe.c -fPIC -DPIC -o libstarlink_ast_la-ffluxframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fframe.lo `test -f 'fframe.c' || echo './'`fframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffitstable.c -fPIC -DPIC -o libstarlink_ast_la-ffitstable.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fframe.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fframeset.lo `test -f 'fframeset.c' || echo './'`fframeset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fframeset.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fframeset.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fframeset.c -fPIC -DPIC -o libstarlink_ast_la-fframeset.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ffitschan.c -fPIC -DPIC -o libstarlink_ast_la-ffitschan.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fframe.c -fPIC -DPIC -o libstarlink_ast_la-fframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fgrismmap.lo `test -f 'fgrismmap.c' || echo './'`fgrismmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fgrismmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fgrismmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fgrismmap.c -fPIC -DPIC -o libstarlink_ast_la-fgrismmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-finterval.lo `test -f 'finterval.c' || echo './'`finterval.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fintramap.lo `test -f 'fintramap.c' || echo './'`fintramap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c finterval.c -fPIC -DPIC -o .libs/libstarlink_ast_la-finterval.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fintramap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fintramap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c finterval.c -fPIC -DPIC -o libstarlink_ast_la-finterval.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fintramap.c -fPIC -DPIC -o libstarlink_ast_la-fintramap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fkeymap.lo `test -f 'fkeymap.c' || echo './'`fkeymap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-flutmap.lo `test -f 'flutmap.c' || echo './'`flutmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fkeymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fkeymap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c flutmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-flutmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fmapping.lo `test -f 'fmapping.c' || echo './'`fmapping.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmapping.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fmapping.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c flutmap.c -fPIC -DPIC -o libstarlink_ast_la-flutmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fmathmap.lo `test -f 'fmathmap.c' || echo './'`fmathmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmathmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fmathmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmathmap.c -fPIC -DPIC -o libstarlink_ast_la-fmathmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fmatrixmap.lo `test -f 'fmatrixmap.c' || echo './'`fmatrixmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmatrixmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fmatrixmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmatrixmap.c -fPIC -DPIC -o libstarlink_ast_la-fmatrixmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fnormmap.lo `test -f 'fnormmap.c' || echo './'`fnormmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fnormmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fnormmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fnormmap.c -fPIC -DPIC -o libstarlink_ast_la-fnormmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fnullregion.lo `test -f 'fnullregion.c' || echo './'`fnullregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fkeymap.c -fPIC -DPIC -o libstarlink_ast_la-fkeymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fnullregion.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fnullregion.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fobject.lo `test -f 'fobject.c' || echo './'`fobject.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fobject.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fobject.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fmapping.c -fPIC -DPIC -o libstarlink_ast_la-fmapping.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fnullregion.c -fPIC -DPIC -o libstarlink_ast_la-fnullregion.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fpcdmap.lo `test -f 'fpcdmap.c' || echo './'`fpcdmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpcdmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fpcdmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpcdmap.c -fPIC -DPIC -o libstarlink_ast_la-fpcdmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fpermmap.lo `test -f 'fpermmap.c' || echo './'`fpermmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpermmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fpermmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fobject.c -fPIC -DPIC -o libstarlink_ast_la-fobject.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpermmap.c -fPIC -DPIC -o libstarlink_ast_la-fpermmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fplot.lo `test -f 'fplot.c' || echo './'`fplot.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fplot.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fplot.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fplot3d.lo `test -f 'fplot3d.c' || echo './'`fplot3d.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fpointlist.lo `test -f 'fpointlist.c' || echo './'`fpointlist.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpointlist.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fpointlist.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fplot3d.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fplot3d.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpointlist.c -fPIC -DPIC -o libstarlink_ast_la-fpointlist.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fpolygon.lo `test -f 'fpolygon.c' || echo './'`fpolygon.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fplot3d.c -fPIC -DPIC -o libstarlink_ast_la-fplot3d.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpolygon.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fpolygon.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fpolymap.lo `test -f 'fpolymap.c' || echo './'`fpolymap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fprism.lo `test -f 'fprism.c' || echo './'`fprism.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fplot.c -fPIC -DPIC -o libstarlink_ast_la-fplot.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpolymap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fpolymap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fprism.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fprism.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c xmlchan.c -fPIC -DPIC -o libstarlink_ast_la-xmlchan.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpolymap.c -fPIC -DPIC -o libstarlink_ast_la-fpolymap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fprism.c -fPIC -DPIC -o libstarlink_ast_la-fprism.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fratemap.lo `test -f 'fratemap.c' || echo './'`fratemap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fregion.lo `test -f 'fregion.c' || echo './'`fregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fratemap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fratemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fregion.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fregion.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fpolygon.c -fPIC -DPIC -o libstarlink_ast_la-fpolygon.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fselectormap.lo `test -f 'fselectormap.c' || echo './'`fselectormap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fratemap.c -fPIC -DPIC -o libstarlink_ast_la-fratemap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fselectormap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fselectormap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fshiftmap.lo `test -f 'fshiftmap.c' || echo './'`fshiftmap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fskyframe.lo `test -f 'fskyframe.c' || echo './'`fskyframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fselectormap.c -fPIC -DPIC -o libstarlink_ast_la-fselectormap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fshiftmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fshiftmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fskyframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fskyframe.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fslamap.lo `test -f 'fslamap.c' || echo './'`fslamap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fshiftmap.c -fPIC -DPIC -o libstarlink_ast_la-fshiftmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fskyframe.c -fPIC -DPIC -o libstarlink_ast_la-fskyframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fslamap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fslamap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fspecfluxframe.lo `test -f 'fspecfluxframe.c' || echo './'`fspecfluxframe.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fspecframe.lo `test -f 'fspecframe.c' || echo './'`fspecframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fregion.c -fPIC -DPIC -o libstarlink_ast_la-fregion.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fspecmap.lo `test -f 'fspecmap.c' || echo './'`fspecmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecfluxframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fspecfluxframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fslamap.c -fPIC -DPIC -o libstarlink_ast_la-fslamap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fspecframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fspecmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecfluxframe.c -fPIC -DPIC -o libstarlink_ast_la-fspecfluxframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fsphmap.lo `test -f 'fsphmap.c' || echo './'`fsphmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecmap.c -fPIC -DPIC -o libstarlink_ast_la-fspecmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fspecframe.c -fPIC -DPIC -o libstarlink_ast_la-fspecframe.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstc.lo `test -f 'fstc.c' || echo './'`fstc.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fsphmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fsphmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstc.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstc.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstccatalogentrylocation.lo `test -f 'fstccatalogentrylocation.c' || echo './'`fstccatalogentrylocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fsphmap.c -fPIC -DPIC -o libstarlink_ast_la-fsphmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstcobsdatalocation.lo `test -f 'fstcobsdatalocation.c' || echo './'`fstcobsdatalocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstccatalogentrylocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstccatalogentrylocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstc.c -fPIC -DPIC -o libstarlink_ast_la-fstc.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcobsdatalocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstcobsdatalocation.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstcresourceprofile.lo `test -f 'fstcresourceprofile.c' || echo './'`fstcresourceprofile.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstcschan.lo `test -f 'fstcschan.c' || echo './'`fstcschan.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fstcsearchlocation.lo `test -f 'fstcsearchlocation.c' || echo './'`fstcsearchlocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstccatalogentrylocation.c -fPIC -DPIC -o libstarlink_ast_la-fstccatalogentrylocation.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcobsdatalocation.c -fPIC -DPIC -o libstarlink_ast_la-fstcobsdatalocation.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcresourceprofile.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstcresourceprofile.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcschan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstcschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c polygon.c -fPIC -DPIC -o libstarlink_ast_la-polygon.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcsearchlocation.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fstcsearchlocation.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fswitchmap.lo `test -f 'fswitchmap.c' || echo './'`fswitchmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcresourceprofile.c -fPIC -DPIC -o libstarlink_ast_la-fstcresourceprofile.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ftable.lo `test -f 'ftable.c' || echo './'`ftable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcschan.c -fPIC -DPIC -o libstarlink_ast_la-fstcschan.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fstcsearchlocation.c -fPIC -DPIC -o libstarlink_ast_la-fstcsearchlocation.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftable.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ftable.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fswitchmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fswitchmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ftimeframe.lo `test -f 'ftimeframe.c' || echo './'`ftimeframe.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ftimemap.lo `test -f 'ftimemap.c' || echo './'`ftimemap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-ftranmap.lo `test -f 'ftranmap.c' || echo './'`ftranmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fswitchmap.c -fPIC -DPIC -o libstarlink_ast_la-fswitchmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftimemap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ftimemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftimeframe.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ftimeframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftranmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-ftranmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-funitmap.lo `test -f 'funitmap.c' || echo './'`funitmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftimemap.c -fPIC -DPIC -o libstarlink_ast_la-ftimemap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftranmap.c -fPIC -DPIC -o libstarlink_ast_la-ftranmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftimeframe.c -fPIC -DPIC -o libstarlink_ast_la-ftimeframe.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c funitmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-funitmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c ftable.c -fPIC -DPIC -o libstarlink_ast_la-ftable.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-funitnormmap.lo `test -f 'funitnormmap.c' || echo './'`funitnormmap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fwcsmap.lo `test -f 'fwcsmap.c' || echo './'`fwcsmap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fwinmap.lo `test -f 'fwinmap.c' || echo './'`fwinmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c funitmap.c -fPIC -DPIC -o libstarlink_ast_la-funitmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c funitnormmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-funitnormmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fwcsmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fwcsmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fwinmap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fwinmap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fxmlchan.lo `test -f 'fxmlchan.c' || echo './'`fxmlchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c funitnormmap.c -fPIC -DPIC -o libstarlink_ast_la-funitnormmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fwcsmap.c -fPIC -DPIC -o libstarlink_ast_la-fwcsmap.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fxmlchan.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fxmlchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fwinmap.c -fPIC -DPIC -o libstarlink_ast_la-fwinmap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-fzoommap.lo `test -f 'fzoommap.c' || echo './'`fzoommap.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-proj.lo `test -f 'proj.c' || echo './'`proj.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-tpn.lo `test -f 'tpn.c' || echo './'`tpn.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fzoommap.c -fPIC -DPIC -o .libs/libstarlink_ast_la-fzoommap.o /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_la-wcstrig.lo `test -f 'wcstrig.c' || echo './'`wcstrig.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fxmlchan.c -fPIC -DPIC -o libstarlink_ast_la-fxmlchan.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c proj.c -fPIC -DPIC -o .libs/libstarlink_ast_la-proj.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c tpn.c -fPIC -DPIC -o .libs/libstarlink_ast_la-tpn.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcstrig.c -fPIC -DPIC -o .libs/libstarlink_ast_la-wcstrig.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c fzoommap.c -fPIC -DPIC -o libstarlink_ast_la-fzoommap.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_err_la-err_null.lo `test -f 'err_null.c' || echo './'`err_null.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_grf3d_la-grf3d.lo `test -f 'grf3d.c' || echo './'`grf3d.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c err_null.c -fPIC -DPIC -o .libs/libstarlink_ast_err_la-err_null.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcstrig.c -fPIC -DPIC -o libstarlink_ast_la-wcstrig.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf3d.c -fPIC -DPIC -o .libs/libstarlink_ast_grf3d_la-grf3d.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c err_null.c -fPIC -DPIC -o libstarlink_ast_err_la-err_null.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf3d.c -fPIC -DPIC -o libstarlink_ast_grf3d_la-grf3d.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_grf_2_0_la-grf_2.0.lo `test -f 'grf_2.0.c' || echo './'`grf_2.0.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_grf_3_2_la-grf_3.2.lo `test -f 'grf_3.2.c' || echo './'`grf_3.2.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_grf_5_6_la-grf_5.6.lo `test -f 'grf_5.6.c' || echo './'`grf_5.6.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_2.0.c -fPIC -DPIC -o .libs/libstarlink_ast_grf_2_0_la-grf_2.0.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_3.2.c -fPIC -DPIC -o .libs/libstarlink_ast_grf_3_2_la-grf_3.2.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_5.6.c -fPIC -DPIC -o .libs/libstarlink_ast_grf_5_6_la-grf_5.6.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_3.2.c -fPIC -DPIC -o libstarlink_ast_grf_3_2_la-grf_3.2.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_2.0.c -fPIC -DPIC -o libstarlink_ast_grf_2_0_la-grf_2.0.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_5.6.c -fPIC -DPIC -o libstarlink_ast_grf_5_6_la-grf_5.6.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_pgplot_la-grf_pgplot.lo `test -f 'grf_pgplot.c' || echo './'`grf_pgplot.c /bin/sh ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o libstarlink_ast_pgplot3d_la-grf3d_pgplot.lo `test -f 'grf3d_pgplot.c' || echo './'`grf3d_pgplot.c /bin/sh ./libtool --tag=CC --mode=link gcc -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o astbad astbad.o -lpthread libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c tpn.c -fPIC -DPIC -o libstarlink_ast_la-tpn.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_pgplot.c -fPIC -DPIC -o .libs/libstarlink_ast_pgplot_la-grf_pgplot.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf3d_pgplot.c -fPIC -DPIC -o .libs/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o libtool: link: gcc -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -o astbad astbad.o -lpthread /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_err.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_err_la-err_null.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_err_la-err_null.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_err.so.0 -o .libs/libstarlink_ast_err.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so.0" && ln -s "libstarlink_ast_err.so.0.0.0" "libstarlink_ast_err.so.0") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so" && ln -s "libstarlink_ast_err.so.0.0.0" "libstarlink_ast_err.so") libtool: link: ar cru .libs/libstarlink_ast_err.a libstarlink_ast_err_la-err_null.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_err.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_err.la" && ln -s "../libstarlink_ast_err.la" "libstarlink_ast_err.la" ) /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_grf3d.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_grf3d_la-grf3d.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_grf3d_la-grf3d.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_grf3d.so.0 -o .libs/libstarlink_ast_grf3d.so.0.0.0 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf_pgplot.c -fPIC -DPIC -o libstarlink_ast_pgplot_la-grf_pgplot.o >/dev/null 2>&1 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so.0" && ln -s "libstarlink_ast_grf3d.so.0.0.0" "libstarlink_ast_grf3d.so.0") /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_grf_2.0.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_grf_2_0_la-grf_2.0.lo -lpthread libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so" && ln -s "libstarlink_ast_grf3d.so.0.0.0" "libstarlink_ast_grf3d.so") libtool: link: ar cru .libs/libstarlink_ast_grf3d.a libstarlink_ast_grf3d_la-grf3d.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_grf3d.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_grf3d.la" && ln -s "../libstarlink_ast_grf3d.la" "libstarlink_ast_grf3d.la" ) /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_grf_3.2.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_grf_3_2_la-grf_3.2.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_grf_2_0_la-grf_2.0.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_grf_2.0.so.0 -o .libs/libstarlink_ast_grf_2.0.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so.0" && ln -s "libstarlink_ast_grf_2.0.so.0.0.0" "libstarlink_ast_grf_2.0.so.0") libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_grf_3_2_la-grf_3.2.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_grf_3.2.so.0 -o .libs/libstarlink_ast_grf_3.2.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so" && ln -s "libstarlink_ast_grf_2.0.so.0.0.0" "libstarlink_ast_grf_2.0.so") libtool: link: ar cru .libs/libstarlink_ast_grf_2.0.a libstarlink_ast_grf_2_0_la-grf_2.0.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_grf_2.0.a libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so.0" && ln -s "libstarlink_ast_grf_3.2.so.0.0.0" "libstarlink_ast_grf_3.2.so.0") libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_grf_2.0.la" && ln -s "../libstarlink_ast_grf_2.0.la" "libstarlink_ast_grf_2.0.la" ) /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_grf_5.6.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_grf_5_6_la-grf_5.6.lo -lpthread libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so" && ln -s "libstarlink_ast_grf_3.2.so.0.0.0" "libstarlink_ast_grf_3.2.so") libtool: link: ar cru .libs/libstarlink_ast_grf_3.2.a libstarlink_ast_grf_3_2_la-grf_3.2.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_grf_3.2.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_grf_3.2.la" && ln -s "../libstarlink_ast_grf_3.2.la" "libstarlink_ast_grf_3.2.la" ) /usr/bin/perl ./makeh -s . xml.h wcstrig.h proj.h memory.h error.h globals.h unit.h ast_err.h version.h object.h keymap.h table.h fitstable.h pointset.h axis.h skyaxis.h mapping.h cmpmap.h dssmap.h grismmap.h intramap.h lutmap.h mathmap.h matrixmap.h pcdmap.h permmap.h polymap.h chebymap.h ratemap.h normmap.h shiftmap.h slamap.h specmap.h sphmap.h timemap.h selectormap.h switchmap.h tranmap.h unitmap.h unitnormmap.h wcsmap.h winmap.h zoommap.h frame.h cmpframe.h specfluxframe.h fluxframe.h frameset.h plot.h plot3d.h skyframe.h specframe.h dsbspecframe.h region.h box.h circle.h cmpregion.h ellipse.h interval.h nullregion.h pointlist.h polygon.h prism.h stc.h stcresourceprofile.h stcsearchlocation.h stccatalogentrylocation.h stcobsdatalocation.h timeframe.h channel.h fitschan.h stcschan.h xmlchan.h >ast.h libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_grf_5_6_la-grf_5.6.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_grf_5.6.so.0 -o .libs/libstarlink_ast_grf_5.6.so.0.0.0 sed -e 's//'`./astbad AST__BAD | tr 'E' 'D'`'/' \ -e 's//'`./astbad AST__NAN | tr 'E' 'D'`'/' \ -e 's//'`./astbad AST__NANF | tr 'E' 'D'`'/' \ ast_par.source >AST_PAR /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_pgplot.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_pgplot_la-grf_pgplot.lo -lpthread libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_5.6.so.0" && ln -s "libstarlink_ast_grf_5.6.so.0.0.0" "libstarlink_ast_grf_5.6.so.0") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_5.6.so" && ln -s "libstarlink_ast_grf_5.6.so.0.0.0" "libstarlink_ast_grf_5.6.so") libtool: link: ar cru .libs/libstarlink_ast_grf_5.6.a libstarlink_ast_grf_5_6_la-grf_5.6.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_grf_5.6.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_grf_5.6.la" && ln -s "../libstarlink_ast_grf_5.6.la" "libstarlink_ast_grf_5.6.la" ) libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_pgplot_la-grf_pgplot.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_pgplot.so.0 -o .libs/libstarlink_ast_pgplot.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so.0" && ln -s "libstarlink_ast_pgplot.so.0.0.0" "libstarlink_ast_pgplot.so.0") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so" && ln -s "libstarlink_ast_pgplot.so.0.0.0" "libstarlink_ast_pgplot.so") libtool: link: ar cru .libs/libstarlink_ast_pgplot.a libstarlink_ast_pgplot_la-grf_pgplot.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_pgplot.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_pgplot.la" && ln -s "../libstarlink_ast_pgplot.la" "libstarlink_ast_pgplot.la" ) libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c grf3d_pgplot.c -fPIC -DPIC -o libstarlink_ast_pgplot3d_la-grf3d_pgplot.o >/dev/null 2>&1 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c proj.c -fPIC -DPIC -o libstarlink_ast_la-proj.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast_pgplot3d.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_pgplot3d_la-grf3d_pgplot.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast_pgplot3d.so.0 -o .libs/libstarlink_ast_pgplot3d.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so.0" && ln -s "libstarlink_ast_pgplot3d.so.0.0.0" "libstarlink_ast_pgplot3d.so.0") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so" && ln -s "libstarlink_ast_pgplot3d.so.0.0.0" "libstarlink_ast_pgplot3d.so") libtool: link: ar cru .libs/libstarlink_ast_pgplot3d.a libstarlink_ast_pgplot3d_la-grf3d_pgplot.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast_pgplot3d.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_pgplot3d.la" && ln -s "../libstarlink_ast_pgplot3d.la" "libstarlink_ast_pgplot3d.la" ) libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c mapping.c -fPIC -DPIC -o libstarlink_ast_la-mapping.o >/dev/null 2>&1 /bin/sh ./libtool --tag=CC --mode=link gcc -prefer-pic -DTHREAD_SAFE -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o libstarlink_ast.la -rpath /usr/lib/aarch64-linux-gnu libstarlink_ast_la-axis.lo libstarlink_ast_la-box.lo libstarlink_ast_la-channel.lo libstarlink_ast_la-chebymap.lo libstarlink_ast_la-circle.lo libstarlink_ast_la-cmpframe.lo libstarlink_ast_la-cmpmap.lo libstarlink_ast_la-cmpregion.lo libstarlink_ast_la-dsbspecframe.lo libstarlink_ast_la-dssmap.lo libstarlink_ast_la-ellipse.lo libstarlink_ast_la-error.lo libstarlink_ast_la-fitschan.lo libstarlink_ast_la-fitstable.lo libstarlink_ast_la-fluxframe.lo libstarlink_ast_la-frame.lo libstarlink_ast_la-frameset.lo libstarlink_ast_la-globals.lo libstarlink_ast_la-grismmap.lo libstarlink_ast_la-interval.lo libstarlink_ast_la-intramap.lo libstarlink_ast_la-keymap.lo libstarlink_ast_la-loader.lo libstarlink_ast_la-lutmap.lo libstarlink_ast_la-mapping.lo libstarlink_ast_la-mathmap.lo libstarlink_ast_la-matrixmap.lo libstarlink_ast_la-memory.lo libstarlink_ast_la-normmap.lo libstarlink_ast_la-nullregion.lo libstarlink_ast_la-object.lo libstarlink_ast_la-pcdmap.lo libstarlink_ast_la-permmap.lo libstarlink_ast_la-plot.lo libstarlink_ast_la-plot3d.lo libstarlink_ast_la-pointlist.lo libstarlink_ast_la-pointset.lo libstarlink_ast_la-polygon.lo libstarlink_ast_la-polymap.lo libstarlink_ast_la-prism.lo libstarlink_ast_la-ratemap.lo libstarlink_ast_la-region.lo libstarlink_ast_la-selectormap.lo libstarlink_ast_la-shiftmap.lo libstarlink_ast_la-skyaxis.lo libstarlink_ast_la-skyframe.lo libstarlink_ast_la-slamap.lo libstarlink_ast_la-specfluxframe.lo libstarlink_ast_la-specframe.lo libstarlink_ast_la-specmap.lo libstarlink_ast_la-sphmap.lo libstarlink_ast_la-stc.lo libstarlink_ast_la-stccatalogentrylocation.lo libstarlink_ast_la-stcobsdatalocation.lo libstarlink_ast_la-stcresourceprofile.lo libstarlink_ast_la-stcschan.lo libstarlink_ast_la-stcsearchlocation.lo libstarlink_ast_la-switchmap.lo libstarlink_ast_la-table.lo libstarlink_ast_la-timeframe.lo libstarlink_ast_la-timemap.lo libstarlink_ast_la-tranmap.lo libstarlink_ast_la-unit.lo libstarlink_ast_la-unitmap.lo libstarlink_ast_la-unitnormmap.lo libstarlink_ast_la-wcsmap.lo libstarlink_ast_la-winmap.lo libstarlink_ast_la-xml.lo libstarlink_ast_la-xmlchan.lo libstarlink_ast_la-zoommap.lo libstarlink_ast_la-c2f77.lo libstarlink_ast_la-fbox.lo libstarlink_ast_la-fchannel.lo libstarlink_ast_la-fchebymap.lo libstarlink_ast_la-fcircle.lo libstarlink_ast_la-fcmpframe.lo libstarlink_ast_la-fcmpmap.lo libstarlink_ast_la-fcmpregion.lo libstarlink_ast_la-fdsbspecframe.lo libstarlink_ast_la-fdssmap.lo libstarlink_ast_la-fellipse.lo libstarlink_ast_la-ferror.lo libstarlink_ast_la-ffitschan.lo libstarlink_ast_la-ffitstable.lo libstarlink_ast_la-ffluxframe.lo libstarlink_ast_la-fframe.lo libstarlink_ast_la-fframeset.lo libstarlink_ast_la-fgrismmap.lo libstarlink_ast_la-finterval.lo libstarlink_ast_la-fintramap.lo libstarlink_ast_la-fkeymap.lo libstarlink_ast_la-flutmap.lo libstarlink_ast_la-fmapping.lo libstarlink_ast_la-fmathmap.lo libstarlink_ast_la-fmatrixmap.lo libstarlink_ast_la-fnormmap.lo libstarlink_ast_la-fnullregion.lo libstarlink_ast_la-fobject.lo libstarlink_ast_la-fpcdmap.lo libstarlink_ast_la-fpermmap.lo libstarlink_ast_la-fplot.lo libstarlink_ast_la-fplot3d.lo libstarlink_ast_la-fpointlist.lo libstarlink_ast_la-fpolygon.lo libstarlink_ast_la-fpolymap.lo libstarlink_ast_la-fprism.lo libstarlink_ast_la-fratemap.lo libstarlink_ast_la-fregion.lo libstarlink_ast_la-fselectormap.lo libstarlink_ast_la-fshiftmap.lo libstarlink_ast_la-fskyframe.lo libstarlink_ast_la-fslamap.lo libstarlink_ast_la-fspecfluxframe.lo libstarlink_ast_la-fspecframe.lo libstarlink_ast_la-fspecmap.lo libstarlink_ast_la-fsphmap.lo libstarlink_ast_la-fstc.lo libstarlink_ast_la-fstccatalogentrylocation.lo libstarlink_ast_la-fstcobsdatalocation.lo libstarlink_ast_la-fstcresourceprofile.lo libstarlink_ast_la-fstcschan.lo libstarlink_ast_la-fstcsearchlocation.lo libstarlink_ast_la-fswitchmap.lo libstarlink_ast_la-ftable.lo libstarlink_ast_la-ftimeframe.lo libstarlink_ast_la-ftimemap.lo libstarlink_ast_la-ftranmap.lo libstarlink_ast_la-funitmap.lo libstarlink_ast_la-funitnormmap.lo libstarlink_ast_la-fwcsmap.lo libstarlink_ast_la-fwinmap.lo libstarlink_ast_la-fxmlchan.lo libstarlink_ast_la-fzoommap.lo libstarlink_ast_la-proj.lo libstarlink_ast_la-tpn.lo libstarlink_ast_la-wcstrig.lo -lstarlink_pal -lerfa -lcminpack -lm -lpthread libtool: link: gcc -shared -fPIC -DPIC .libs/libstarlink_ast_la-axis.o .libs/libstarlink_ast_la-box.o .libs/libstarlink_ast_la-channel.o .libs/libstarlink_ast_la-chebymap.o .libs/libstarlink_ast_la-circle.o .libs/libstarlink_ast_la-cmpframe.o .libs/libstarlink_ast_la-cmpmap.o .libs/libstarlink_ast_la-cmpregion.o .libs/libstarlink_ast_la-dsbspecframe.o .libs/libstarlink_ast_la-dssmap.o .libs/libstarlink_ast_la-ellipse.o .libs/libstarlink_ast_la-error.o .libs/libstarlink_ast_la-fitschan.o .libs/libstarlink_ast_la-fitstable.o .libs/libstarlink_ast_la-fluxframe.o .libs/libstarlink_ast_la-frame.o .libs/libstarlink_ast_la-frameset.o .libs/libstarlink_ast_la-globals.o .libs/libstarlink_ast_la-grismmap.o .libs/libstarlink_ast_la-interval.o .libs/libstarlink_ast_la-intramap.o .libs/libstarlink_ast_la-keymap.o .libs/libstarlink_ast_la-loader.o .libs/libstarlink_ast_la-lutmap.o .libs/libstarlink_ast_la-mapping.o .libs/libstarlink_ast_la-mathmap.o .libs/libstarlink_ast_la-matrixmap.o .libs/libstarlink_ast_la-memory.o .libs/libstarlink_ast_la-normmap.o .libs/libstarlink_ast_la-nullregion.o .libs/libstarlink_ast_la-object.o .libs/libstarlink_ast_la-pcdmap.o .libs/libstarlink_ast_la-permmap.o .libs/libstarlink_ast_la-plot.o .libs/libstarlink_ast_la-plot3d.o .libs/libstarlink_ast_la-pointlist.o .libs/libstarlink_ast_la-pointset.o .libs/libstarlink_ast_la-polygon.o .libs/libstarlink_ast_la-polymap.o .libs/libstarlink_ast_la-prism.o .libs/libstarlink_ast_la-ratemap.o .libs/libstarlink_ast_la-region.o .libs/libstarlink_ast_la-selectormap.o .libs/libstarlink_ast_la-shiftmap.o .libs/libstarlink_ast_la-skyaxis.o .libs/libstarlink_ast_la-skyframe.o .libs/libstarlink_ast_la-slamap.o .libs/libstarlink_ast_la-specfluxframe.o .libs/libstarlink_ast_la-specframe.o .libs/libstarlink_ast_la-specmap.o .libs/libstarlink_ast_la-sphmap.o .libs/libstarlink_ast_la-stc.o .libs/libstarlink_ast_la-stccatalogentrylocation.o .libs/libstarlink_ast_la-stcobsdatalocation.o .libs/libstarlink_ast_la-stcresourceprofile.o .libs/libstarlink_ast_la-stcschan.o .libs/libstarlink_ast_la-stcsearchlocation.o .libs/libstarlink_ast_la-switchmap.o .libs/libstarlink_ast_la-table.o .libs/libstarlink_ast_la-timeframe.o .libs/libstarlink_ast_la-timemap.o .libs/libstarlink_ast_la-tranmap.o .libs/libstarlink_ast_la-unit.o .libs/libstarlink_ast_la-unitmap.o .libs/libstarlink_ast_la-unitnormmap.o .libs/libstarlink_ast_la-wcsmap.o .libs/libstarlink_ast_la-winmap.o .libs/libstarlink_ast_la-xml.o .libs/libstarlink_ast_la-xmlchan.o .libs/libstarlink_ast_la-zoommap.o .libs/libstarlink_ast_la-c2f77.o .libs/libstarlink_ast_la-fbox.o .libs/libstarlink_ast_la-fchannel.o .libs/libstarlink_ast_la-fchebymap.o .libs/libstarlink_ast_la-fcircle.o .libs/libstarlink_ast_la-fcmpframe.o .libs/libstarlink_ast_la-fcmpmap.o .libs/libstarlink_ast_la-fcmpregion.o .libs/libstarlink_ast_la-fdsbspecframe.o .libs/libstarlink_ast_la-fdssmap.o .libs/libstarlink_ast_la-fellipse.o .libs/libstarlink_ast_la-ferror.o .libs/libstarlink_ast_la-ffitschan.o .libs/libstarlink_ast_la-ffitstable.o .libs/libstarlink_ast_la-ffluxframe.o .libs/libstarlink_ast_la-fframe.o .libs/libstarlink_ast_la-fframeset.o .libs/libstarlink_ast_la-fgrismmap.o .libs/libstarlink_ast_la-finterval.o .libs/libstarlink_ast_la-fintramap.o .libs/libstarlink_ast_la-fkeymap.o .libs/libstarlink_ast_la-flutmap.o .libs/libstarlink_ast_la-fmapping.o .libs/libstarlink_ast_la-fmathmap.o .libs/libstarlink_ast_la-fmatrixmap.o .libs/libstarlink_ast_la-fnormmap.o .libs/libstarlink_ast_la-fnullregion.o .libs/libstarlink_ast_la-fobject.o .libs/libstarlink_ast_la-fpcdmap.o .libs/libstarlink_ast_la-fpermmap.o .libs/libstarlink_ast_la-fplot.o .libs/libstarlink_ast_la-fplot3d.o .libs/libstarlink_ast_la-fpointlist.o .libs/libstarlink_ast_la-fpolygon.o .libs/libstarlink_ast_la-fpolymap.o .libs/libstarlink_ast_la-fprism.o .libs/libstarlink_ast_la-fratemap.o .libs/libstarlink_ast_la-fregion.o .libs/libstarlink_ast_la-fselectormap.o .libs/libstarlink_ast_la-fshiftmap.o .libs/libstarlink_ast_la-fskyframe.o .libs/libstarlink_ast_la-fslamap.o .libs/libstarlink_ast_la-fspecfluxframe.o .libs/libstarlink_ast_la-fspecframe.o .libs/libstarlink_ast_la-fspecmap.o .libs/libstarlink_ast_la-fsphmap.o .libs/libstarlink_ast_la-fstc.o .libs/libstarlink_ast_la-fstccatalogentrylocation.o .libs/libstarlink_ast_la-fstcobsdatalocation.o .libs/libstarlink_ast_la-fstcresourceprofile.o .libs/libstarlink_ast_la-fstcschan.o .libs/libstarlink_ast_la-fstcsearchlocation.o .libs/libstarlink_ast_la-fswitchmap.o .libs/libstarlink_ast_la-ftable.o .libs/libstarlink_ast_la-ftimeframe.o .libs/libstarlink_ast_la-ftimemap.o .libs/libstarlink_ast_la-ftranmap.o .libs/libstarlink_ast_la-funitmap.o .libs/libstarlink_ast_la-funitnormmap.o .libs/libstarlink_ast_la-fwcsmap.o .libs/libstarlink_ast_la-fwinmap.o .libs/libstarlink_ast_la-fxmlchan.o .libs/libstarlink_ast_la-fzoommap.o .libs/libstarlink_ast_la-proj.o .libs/libstarlink_ast_la-tpn.o .libs/libstarlink_ast_la-wcstrig.o -lstarlink_pal -lerfa -lcminpack -lm -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast.so.0 -o .libs/libstarlink_ast.so.0.0.0 libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so.0" && ln -s "libstarlink_ast.so.0.0.0" "libstarlink_ast.so.0") libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so" && ln -s "libstarlink_ast.so.0.0.0" "libstarlink_ast.so") libtool: link: ar cru .libs/libstarlink_ast.a libstarlink_ast_la-axis.o libstarlink_ast_la-box.o libstarlink_ast_la-channel.o libstarlink_ast_la-chebymap.o libstarlink_ast_la-circle.o libstarlink_ast_la-cmpframe.o libstarlink_ast_la-cmpmap.o libstarlink_ast_la-cmpregion.o libstarlink_ast_la-dsbspecframe.o libstarlink_ast_la-dssmap.o libstarlink_ast_la-ellipse.o libstarlink_ast_la-error.o libstarlink_ast_la-fitschan.o libstarlink_ast_la-fitstable.o libstarlink_ast_la-fluxframe.o libstarlink_ast_la-frame.o libstarlink_ast_la-frameset.o libstarlink_ast_la-globals.o libstarlink_ast_la-grismmap.o libstarlink_ast_la-interval.o libstarlink_ast_la-intramap.o libstarlink_ast_la-keymap.o libstarlink_ast_la-loader.o libstarlink_ast_la-lutmap.o libstarlink_ast_la-mapping.o libstarlink_ast_la-mathmap.o libstarlink_ast_la-matrixmap.o libstarlink_ast_la-memory.o libstarlink_ast_la-normmap.o libstarlink_ast_la-nullregion.o libstarlink_ast_la-object.o libstarlink_ast_la-pcdmap.o libstarlink_ast_la-permmap.o libstarlink_ast_la-plot.o libstarlink_ast_la-plot3d.o libstarlink_ast_la-pointlist.o libstarlink_ast_la-pointset.o libstarlink_ast_la-polygon.o libstarlink_ast_la-polymap.o libstarlink_ast_la-prism.o libstarlink_ast_la-ratemap.o libstarlink_ast_la-region.o libstarlink_ast_la-selectormap.o libstarlink_ast_la-shiftmap.o libstarlink_ast_la-skyaxis.o libstarlink_ast_la-skyframe.o libstarlink_ast_la-slamap.o libstarlink_ast_la-specfluxframe.o libstarlink_ast_la-specframe.o libstarlink_ast_la-specmap.o libstarlink_ast_la-sphmap.o libstarlink_ast_la-stc.o libstarlink_ast_la-stccatalogentrylocation.o libstarlink_ast_la-stcobsdatalocation.o libstarlink_ast_la-stcresourceprofile.o libstarlink_ast_la-stcschan.o libstarlink_ast_la-stcsearchlocation.o libstarlink_ast_la-switchmap.o libstarlink_ast_la-table.o libstarlink_ast_la-timeframe.o libstarlink_ast_la-timemap.o libstarlink_ast_la-tranmap.o libstarlink_ast_la-unit.o libstarlink_ast_la-unitmap.o libstarlink_ast_la-unitnormmap.o libstarlink_ast_la-wcsmap.o libstarlink_ast_la-winmap.o libstarlink_ast_la-xml.o libstarlink_ast_la-xmlchan.o libstarlink_ast_la-zoommap.o libstarlink_ast_la-c2f77.o libstarlink_ast_la-fbox.o libstarlink_ast_la-fchannel.o libstarlink_ast_la-fchebymap.o libstarlink_ast_la-fcircle.o libstarlink_ast_la-fcmpframe.o libstarlink_ast_la-fcmpmap.o libstarlink_ast_la-fcmpregion.o libstarlink_ast_la-fdsbspecframe.o libstarlink_ast_la-fdssmap.o libstarlink_ast_la-fellipse.o libstarlink_ast_la-ferror.o libstarlink_ast_la-ffitschan.o libstarlink_ast_la-ffitstable.o libstarlink_ast_la-ffluxframe.o libstarlink_ast_la-fframe.o libstarlink_ast_la-fframeset.o libstarlink_ast_la-fgrismmap.o libstarlink_ast_la-finterval.o libstarlink_ast_la-fintramap.o libstarlink_ast_la-fkeymap.o libstarlink_ast_la-flutmap.o libstarlink_ast_la-fmapping.o libstarlink_ast_la-fmathmap.o libstarlink_ast_la-fmatrixmap.o libstarlink_ast_la-fnormmap.o libstarlink_ast_la-fnullregion.o libstarlink_ast_la-fobject.o libstarlink_ast_la-fpcdmap.o libstarlink_ast_la-fpermmap.o libstarlink_ast_la-fplot.o libstarlink_ast_la-fplot3d.o libstarlink_ast_la-fpointlist.o libstarlink_ast_la-fpolygon.o libstarlink_ast_la-fpolymap.o libstarlink_ast_la-fprism.o libstarlink_ast_la-fratemap.o libstarlink_ast_la-fregion.o libstarlink_ast_la-fselectormap.o libstarlink_ast_la-fshiftmap.o libstarlink_ast_la-fskyframe.o libstarlink_ast_la-fslamap.o libstarlink_ast_la-fspecfluxframe.o libstarlink_ast_la-fspecframe.o libstarlink_ast_la-fspecmap.o libstarlink_ast_la-fsphmap.o libstarlink_ast_la-fstc.o libstarlink_ast_la-fstccatalogentrylocation.o libstarlink_ast_la-fstcobsdatalocation.o libstarlink_ast_la-fstcresourceprofile.o libstarlink_ast_la-fstcschan.o libstarlink_ast_la-fstcsearchlocation.o libstarlink_ast_la-fswitchmap.o libstarlink_ast_la-ftable.o libstarlink_ast_la-ftimeframe.o libstarlink_ast_la-ftimemap.o libstarlink_ast_la-ftranmap.o libstarlink_ast_la-funitmap.o libstarlink_ast_la-funitnormmap.o libstarlink_ast_la-fwcsmap.o libstarlink_ast_la-fwinmap.o libstarlink_ast_la-fxmlchan.o libstarlink_ast_la-fzoommap.o libstarlink_ast_la-proj.o libstarlink_ast_la-tpn.o libstarlink_ast_la-wcstrig.o ar: `u' modifier ignored since `D' is the default (see `U') libtool: link: ranlib .libs/libstarlink_ast.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast.la" && ln -s "../libstarlink_ast.la" "libstarlink_ast.la" ) make[2]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' dh_auto_test make -j8 check VERBOSE=1 make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make check-am make[2]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make ast_test make[3]: Entering directory '/build/starlink-ast-8.6.3+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o ast_test.o ast_test.c /bin/sh ./libtool --tag=CC --mode=link gcc -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o ast_test ast_test.o -lstarlink_pal libstarlink_ast.la libstarlink_ast_grf_3.2.la libstarlink_ast_grf_5.6.la libstarlink_ast_grf_2.0.la libstarlink_ast_grf3d.la libstarlink_ast_err.la -lm -lpthread libtool: link: gcc -g -O2 -ffile-prefix-map=/build/starlink-ast-8.6.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -o .libs/ast_test ast_test.o -lstarlink_pal ./.libs/libstarlink_ast.so ./.libs/libstarlink_ast_grf_3.2.so ./.libs/libstarlink_ast_grf_5.6.so ./.libs/libstarlink_ast_grf_2.0.so ./.libs/libstarlink_ast_grf3d.so ./.libs/libstarlink_ast_err.so -lm -lpthread make[3]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make check-TESTS make[3]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make[4]: Entering directory '/build/starlink-ast-8.6.3+dfsg' PASS: ast_test ============================================================================ Testsuite summary for ast 8.6.3 ============================================================================ # TOTAL: 1 # PASS: 1 # SKIP: 0 # XFAIL: 0 # FAIL: 0 # XPASS: 0 # ERROR: 0 ============================================================================ make[4]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[3]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[2]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' create-stamp debian/debhelper-build-stamp fakeroot debian/rules binary dh binary --with autoreconf dh_testroot dh_prep dh_installdirs dh_auto_install make -j1 install DESTDIR=/build/starlink-ast-8.6.3\+dfsg/debian/tmp AM_UPDATE_INFO_DIR=no make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make install-am make[2]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make[3]: Entering directory '/build/starlink-ast-8.6.3+dfsg' /bin/mkdir -p '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/bin' /bin/mkdir -p '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link_adam '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/bin' /bin/mkdir -p '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu' /bin/sh ./libtool --mode=install /usr/bin/install -c libstarlink_ast.la libstarlink_ast_err.la libstarlink_ast_grf3d.la libstarlink_ast_grf_2.0.la libstarlink_ast_grf_3.2.la libstarlink_ast_grf_5.6.la libstarlink_ast_pgplot.la libstarlink_ast_pgplot3d.la '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu' libtool: install: /usr/bin/install -c .libs/libstarlink_ast.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast.so.0.0.0 libstarlink_ast.so.0 || { rm -f libstarlink_ast.so.0 && ln -s libstarlink_ast.so.0.0.0 libstarlink_ast.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast.so.0.0.0 libstarlink_ast.so || { rm -f libstarlink_ast.so && ln -s libstarlink_ast.so.0.0.0 libstarlink_ast.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_err.so.0.0.0 libstarlink_ast_err.so.0 || { rm -f libstarlink_ast_err.so.0 && ln -s libstarlink_ast_err.so.0.0.0 libstarlink_ast_err.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_err.so.0.0.0 libstarlink_ast_err.so || { rm -f libstarlink_ast_err.so && ln -s libstarlink_ast_err.so.0.0.0 libstarlink_ast_err.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.0.0.0 libstarlink_ast_grf3d.so.0 || { rm -f libstarlink_ast_grf3d.so.0 && ln -s libstarlink_ast_grf3d.so.0.0.0 libstarlink_ast_grf3d.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.0.0.0 libstarlink_ast_grf3d.so || { rm -f libstarlink_ast_grf3d.so && ln -s libstarlink_ast_grf3d.so.0.0.0 libstarlink_ast_grf3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_2.0.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.0.0.0 libstarlink_ast_grf_2.0.so.0 || { rm -f libstarlink_ast_grf_2.0.so.0 && ln -s libstarlink_ast_grf_2.0.so.0.0.0 libstarlink_ast_grf_2.0.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.0.0.0 libstarlink_ast_grf_2.0.so || { rm -f libstarlink_ast_grf_2.0.so && ln -s libstarlink_ast_grf_2.0.so.0.0.0 libstarlink_ast_grf_2.0.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_2.0.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_3.2.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.0.0.0 libstarlink_ast_grf_3.2.so.0 || { rm -f libstarlink_ast_grf_3.2.so.0 && ln -s libstarlink_ast_grf_3.2.so.0.0.0 libstarlink_ast_grf_3.2.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.0.0.0 libstarlink_ast_grf_3.2.so || { rm -f libstarlink_ast_grf_3.2.so && ln -s libstarlink_ast_grf_3.2.so.0.0.0 libstarlink_ast_grf_3.2.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_3.2.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_5.6.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.0.0.0 libstarlink_ast_grf_5.6.so.0 || { rm -f libstarlink_ast_grf_5.6.so.0 && ln -s libstarlink_ast_grf_5.6.so.0.0.0 libstarlink_ast_grf_5.6.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.0.0.0 libstarlink_ast_grf_5.6.so || { rm -f libstarlink_ast_grf_5.6.so && ln -s libstarlink_ast_grf_5.6.so.0.0.0 libstarlink_ast_grf_5.6.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_5.6.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.0.0.0 libstarlink_ast_pgplot.so.0 || { rm -f libstarlink_ast_pgplot.so.0 && ln -s libstarlink_ast_pgplot.so.0.0.0 libstarlink_ast_pgplot.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.0.0.0 libstarlink_ast_pgplot.so || { rm -f libstarlink_ast_pgplot.so && ln -s libstarlink_ast_pgplot.so.0.0.0 libstarlink_ast_pgplot.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.so.0.0.0 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot3d.so.0.0.0 libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.0.0.0 libstarlink_ast_pgplot3d.so.0 || { rm -f libstarlink_ast_pgplot3d.so.0 && ln -s libstarlink_ast_pgplot3d.so.0.0.0 libstarlink_ast_pgplot3d.so.0; }; }) libtool: install: (cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.0.0.0 libstarlink_ast_pgplot3d.so || { rm -f libstarlink_ast_pgplot3d.so && ln -s libstarlink_ast_pgplot3d.so.0.0.0 libstarlink_ast_pgplot3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.lai /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.a /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: chmod 644 /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: ranlib /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: warning: remember to run 'libtool --finish /usr/lib/aarch64-linux-gnu' make install-exec-hook make[4]: Entering directory '/build/starlink-ast-8.6.3+dfsg' /bin/mkdir -p /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu cd /build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu; \ for f in `ls libstarlink_ast.*`; do \ ff=`echo $f | sed -e 's/libstarlink_ast/libstarlink_ast_pass2/'`; \ if test -f "$ff"; then rm "$ff"; fi; \ ln -s $f $ff; \ /bin/true && echo "MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/$ff" || :; \ done; \ if test -f "libstarlink_ast.la"; then \ if test -f "libstarlink_ast_pass2.la"; then rm "libstarlink_ast_pass2.la"; fi; \ sed -e 's/libstarlink_ast\./libstarlink_ast_pass2\./g' libstarlink_ast.la > libstarlink_ast_pass2.la; \ fi MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pass2.a MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pass2.la MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pass2.so MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pass2.so.0 MANIFEST:/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/lib/aarch64-linux-gnu/libstarlink_ast_pass2.so.0.0.0 make[4]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' /bin/mkdir -p '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 GRF_PAR grf.h grf3d.h '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/include' /bin/mkdir -p '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 ast.h AST_PAR '/build/starlink-ast-8.6.3+dfsg/debian/tmp/usr/include' make[3]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[2]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' dh_install debian/rules override_dh_installdocs-indep make[1]: Entering directory '/build/starlink-ast-8.6.3+dfsg' make doc make[2]: Entering directory '/build/starlink-ast-8.6.3+dfsg' pdflatex sun211.tex && pdflatex sun211.tex This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2019/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2018-12-01> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2018/09/03 v1.4i Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size11.clo)) ..........Article!.......... (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifpdf.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty (/usr/share/texlive/texmf-dist/tex/latex/base/t1enc.def)) (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype-pdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/mathpazo.sty) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3-code.tex) (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/l3pdfmode.def)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/multirow/multirow.sty) (/usr/share/texlive/texmf-dist/tex/latex/enumitem/enumitem.sty) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/dvipsnam.def) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/svgnam.def)) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/kvsetkeys.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/etexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifluatex.sty)))) (/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/zref-abspage.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/zref-base.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/pdftexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/auxhook.sty)) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/atbegshi.sty)) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/frontendlayer/tikz.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgf.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfrcs.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common-lists.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-latex.def (/usr/share/texlive/texmf-dist/tex/latex/ms/everyshi.sty)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfrcs.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/pgf.revision.tex))) (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgfcore.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/systemlayer/pgfsys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeysfiltered.code.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgf.cfg) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-pdftex.def (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-common-pdf.de f))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsyssoftpath.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsysprotocol.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcore.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathcalc.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathutil.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathparser.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.basic.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.trigonomet ric.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.random.cod e.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.comparison .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.base.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.round.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.misc.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.integerari thmetics.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepoints.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathconstruct. code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathusage.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorescopes.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoregraphicstate.c ode.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoretransformation s.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorequick.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreobjects.code.t ex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathprocessing .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorearrows.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreshade.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreimage.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreexternal.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorelayers.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoretransparency.c ode.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepatterns.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorerdf.code.tex)) ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmoduleshapes.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmoduleplot.code.tex ) (/usr/share/texlive/texmf-dist/tex/latex/pgf/compatibility/pgfcomp-version-0-65 .sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/compatibility/pgfcomp-version-1-18 .sty)) (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgffor.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfkeys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex)) (/usr/share/texlive/texmf-dist/tex/latex/pgf/math/pgfmath.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgffor.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/tikz.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/libraries/pgflibraryplothandlers .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmodulematrix.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/libraries/tik zlibrarytopaths.code.tex))) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/md-frame-1.mdf)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/rotating.sty (/usr/share/texlive/texmf-dist/tex/latex/base/ifthen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/pdflscape.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/lscape.sty) (/usr/share/texlive/texmf-dist/tex/generic/ifxetex/ifxetex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifvtex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titling/titling.sty) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty) (/usr/share/texlive/texmf-dist/tex/latex/tocloft/tocloft.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-generic.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/hyperref.cfg) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/rerunfilecheck.sty)) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty Style option: `fancyvrb' v3.2a <2019/01/15> (tvz)) (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty) (/usr/share/texlive/texmf-dist/tex/latex/eqparbox/eqparbox.sty (/usr/share/texlive/texmf-dist/tex/latex/environ/environ.sty (/usr/share/texlive/texmf-dist/tex/latex/trimspaces/trimspaces.sty))) (./starabbrev.sty ... Using standard SIunitx degrees ) (./starstyle.sty (/usr/share/texlive/texmf-dist/tex/latex/titlesec/ttlkeys.def)) (./sst.sty)) No file sun211.aux. (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/base/ts1enc.dfu) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator-basic-dictionary -English.dict) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx-abbreviations.cfg) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/grfext.sty) (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) ABD: EveryShipout initializing macros *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omlzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omszplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omxzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1zplm.fd) Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map} <./sun211_figures/fronta. pdf> <./sun211_figures/frontb.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontb.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page > <./sun211_figures/frontc.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontc.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page >] [2] [3] [4] [1] LaTeX Warning: Hyper reference `System' on page 2 undefined on input line 146. (/usr/share/texlive/texmf-dist/tex/latex/base/t1cmtt.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omsppl.fd) [2] LaTeX Warning: Hyper reference `Object' on page 3 undefined on input line 216. [3] [4] LaTeX Warning: Hyper reference `Mapping' on page 5 undefined on input line 256. LaTeX Warning: Reference `fig:mapping' on page 5 undefined on input line 261. LaTeX Warning: Reference `ss:mappings' on page 5 undefined on input line 288. LaTeX Warning: Hyper reference `Mapping' on page 5 undefined on input line 292. LaTeX Warning: Reference `ss:mappingoverview' on page 5 undefined on input line 292. LaTeX Warning: Hyper reference `SlaMap' on page 5 undefined on input line 300. LaTeX Warning: Hyper reference `SpecMap' on page 5 undefined on input line 303. LaTeX Warning: Hyper reference `GrismMap' on page 5 undefined on input line 303 . [5 <./sun211_figures/mapping.pdf>] LaTeX Warning: Hyper reference `TimeMap' on page 6 undefined on input line 305. LaTeX Warning: Hyper reference `SphMap' on page 6 undefined on input line 308. LaTeX Warning: Hyper reference `DssMap' on page 6 undefined on input line 311. LaTeX Warning: Hyper reference `WcsMap' on page 6 undefined on input line 311. LaTeX Warning: Hyper reference `PermMap' on page 6 undefined on input line 314. LaTeX Warning: Hyper reference `MatrixMap' on page 6 undefined on input line 31 6. LaTeX Warning: Hyper reference `WinMap' on page 6 undefined on input line 316. LaTeX Warning: Hyper reference `ShiftMap' on page 6 undefined on input line 317 . LaTeX Warning: Hyper reference `ZoomMap' on page 6 undefined on input line 317. Overfull \hbox (16.86678pt too wide) in paragraph at lines 316--318 []\T1/ppl/m/n/10.95 (-20) Various lin-ear co-or-di-nate trans-for-ma-tions (the Ma-trixMap, Win-Map, ShiftMap and ZoomMap). LaTeX Warning: Hyper reference `PolyMap' on page 6 undefined on input line 319. LaTeX Warning: Hyper reference `ChebyMap' on page 6 undefined on input line 320 . LaTeX Warning: Hyper reference `LutMap' on page 6 undefined on input line 322. LaTeX Warning: Hyper reference `MathMap' on page 6 undefined on input line 326. LaTeX Warning: Hyper reference `IntraMap' on page 6 undefined on input line 330 . LaTeX Warning: Reference `ss:classdescriptions' on page 6 undefined on input li ne 335. LaTeX Warning: Reference `ss:permmapexample' on page 6 undefined on input line 336. LaTeX Warning: Hyper reference `UnitMap' on page 6 undefined on input line 336. LaTeX Warning: Reference `ss:unitmapexample' on page 6 undefined on input line 337. LaTeX Warning: Reference `ss:intramaps' on page 6 undefined on input line 338. LaTeX Warning: Reference `ss:primer' on page 6 undefined on input line 339. LaTeX Warning: Reference `ss:mappingselection' on page 6 undefined on input lin e 343. LaTeX Warning: Hyper reference `Mapping' on page 6 undefined on input line 345. LaTeX Warning: Hyper reference `CmpMap' on page 6 undefined on input line 346. LaTeX Warning: Reference `fig:seriescmpmap' on page 6 undefined on input line 3 53. LaTeX Warning: Reference `fig:parallelcmpmap' on page 6 undefined on input line 369. LaTeX Warning: Hyper reference `TranMap' on page 6 undefined on input line 384. LaTeX Warning: Reference `fig:complexcmpmap' on page 6 undefined on input line 389. LaTeX Warning: Reference `ss:cmpmaps' on page 6 undefined on input line 406. LaTeX Warning: Reference `ss:classdescriptions' on page 6 undefined on input li ne 407. [6] [7 <./sun211_figures/series.pdf> <./sun211_figures/parallel.pdf>] LaTeX Warning: Reference `ss:mappingoverview' on page 8 undefined on input line 411. LaTeX Warning: Reference `fig:frames' on page 8 undefined on input line 414. LaTeX Warning: Hyper reference `SkyFrame' on page 8 undefined on input line 421 . LaTeX Warning: Hyper reference `Frame' on page 8 undefined on input line 421. LaTeX Warning: Hyper reference `SkyFrame' on page 8 undefined on input line 421 . LaTeX Warning: Hyper reference `Frame' on page 8 undefined on input line 421. LaTeX Warning: Reference `fig:frames' on page 8 undefined on input line 446. LaTeX Warning: Hyper reference `SpecFrame' on page 8 undefined on input line 44 7. LaTeX Warning: Hyper reference `TimeFrame' on page 8 undefined on input line 44 7. LaTeX Warning: Reference `ss:cmpmapoverview' on page 8 undefined on input line 452. LaTeX Warning: Hyper reference `CmpFrame' on page 8 undefined on input line 453 . LaTeX Warning: Reference `fig:cmpframe' on page 8 undefined on input line 456. LaTeX Warning: Reference `fig:complexcmpmap' on page 8 undefined on input line 468. LaTeX Warning: Reference `fig:complexcmpmap' on page 8 undefined on input line 468. [8 <./sun211_figures/complex.pdf>] LaTeX Warning: Reference `ss:frames' on page 9 undefined on input line 474. LaTeX Warning: Reference `ss:skyframes' on page 9 undefined on input line 474. LaTeX Warning: Reference `ss:specframes' on page 9 undefined on input line 475. LaTeX Warning: Reference `ss:classdescriptions' on page 9 undefined on input li ne 476. LaTeX Warning: Reference `fig:frameset' on page 9 undefined on input line 482. LaTeX Warning: Hyper reference `FrameSet' on page 9 undefined on input line 494 . LaTeX Warning: Hyper reference `Frame' on page 9 undefined on input line 494. LaTeX Warning: Hyper reference `Mapping' on page 9 undefined on input line 495. LaTeX Warning: Reference `ss:framesets' on page 9 undefined on input line 516. LaTeX Warning: Reference `ss:fshigher' on page 9 undefined on input line 516. LaTeX Warning: Reference `ss:classdescriptions' on page 9 undefined on input li ne 517. [9 <./sun211_figures/frames.pdf>] LaTeX Warning: Hyper reference `Object' on page 10 undefined on input line 521. LaTeX Warning: Hyper reference `Channel' on page 10 undefined on input line 527 . LaTeX Warning: Hyper reference `FitsChan' on page 10 undefined on input line 54 1. LaTeX Warning: Hyper reference `XmlChan' on page 10 undefined on input line 547 . LaTeX Warning: Hyper reference `Stc' on page 10 undefined on input line 559. [10 <./sun211_figures/cmpframe.pdf>] [11 <./sun211_figures/frameset.pdf>] LaTeX Warning: Hyper reference `StcsChan' on page 12 undefined on input line 56 3. LaTeX Warning: Hyper reference `Region' on page 12 undefined on input line 569. LaTeX Warning: Reference `ss:channels' on page 12 undefined on input line 572. LaTeX Warning: Reference `ss:nativefits' on page 12 undefined on input line 572 . LaTeX Warning: Reference `ss:foreignfits' on page 12 undefined on input line 57 3. LaTeX Warning: Reference `ss:classdescriptions' on page 12 undefined on input l ine 574. LaTeX Warning: Hyper reference `Encoding' on page 12 undefined on input line 57 4. LaTeX Warning: Reference `ss:attributedescriptions' on page 12 undefined on inp ut line 575. LaTeX Warning: Hyper reference `FrameSet' on page 12 undefined on input line 58 0. LaTeX Warning: Hyper reference `Plot' on page 12 undefined on input line 581. LaTeX Warning: Hyper reference `Frame' on page 12 undefined on input line 581. LaTeX Warning: Hyper reference `Plot3D' on page 12 undefined on input line 586. LaTeX Warning: Hyper reference `CmpFrame' on page 12 undefined on input line 60 5. LaTeX Warning: Reference `fig:gridplot' on page 12 undefined on input line 611. LaTeX Warning: Reference `ss:plots' on page 12 undefined on input line 632. LaTeX Warning: Reference `ss:classdescriptions' on page 12 undefined on input l ine 633. [12] [13 <./sun211_figures/gridplot_bw.pdf>] [14] LaTeX Warning: Reference `ss:primer' on page 15 undefined on input line 649. LaTeX Warning: Hyper reference `astBegin' on page 15 undefined on input line 68 6. LaTeX Warning: Hyper reference `astEnd' on page 15 undefined on input line 686. LaTeX Warning: Reference `ss:contexts' on page 15 undefined on input line 688. LaTeX Warning: Reference `ss:accessingheaderfile' on page 15 undefined on input line 690. [15] LaTeX Warning: Reference `ss:accessingheaderfile' on page 16 undefined on input line 711. LaTeX Warning: Reference `ss:linking' on page 16 undefined on input line 712. LaTeX Warning: Hyper reference `ast_link' on page 16 undefined on input line 71 3. LaTeX Warning: Reference `ss:commanddescriptions' on page 16 undefined on input line 714. LaTeX Warning: Hyper reference `FrameSet' on page 16 undefined on input line 76 3. LaTeX Warning: Hyper reference `Channel' on page 16 undefined on input line 769 . LaTeX Warning: Hyper reference `XmlChan' on page 16 undefined on input line 769 . LaTeX Warning: Reference `ss:channels' on page 16 undefined on input line 770. LaTeX Warning: Hyper reference `FitsChan' on page 16 undefined on input line 77 0. [16] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 17 undefined on i nput line 778. LaTeX Warning: Reference `ss:readingforeignfits' on page 17 undefined on input line 779. LaTeX Warning: Reference `ss:nativefits' on page 17 undefined on input line 781 . LaTeX Warning: Reference `ss:foreignfits' on page 17 undefined on input line 78 1. LaTeX Warning: Reference `ss:framesets' on page 17 undefined on input line 782. LaTeX Warning: Reference `ss:fshigher' on page 17 undefined on input line 782. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 7 87. LaTeX Warning: Reference `ss:errordetection' on page 17 undefined on input line 810. LaTeX Warning: Reference `ss:validatinginput' on page 17 undefined on input lin e 811. LaTeX Warning: Reference `ss:readingforeignfits' on page 17 undefined on input line 812. LaTeX Warning: Hyper reference `Object' on page 17 undefined on input line 816. LaTeX Warning: Hyper reference `FrameSet' on page 17 undefined on input line 82 5. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 8 26. LaTeX Warning: Hyper reference `astShow' on page 17 undefined on input line 829 . LaTeX Warning: Reference `ss:displayingobjects' on page 17 undefined on input l ine 830. LaTeX Warning: Reference `ss:textualoutputformat' on page 17 undefined on input line 831. LaTeX Warning: Hyper reference `FrameSet' on page 17 undefined on input line 83 5. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 8 36. [17] LaTeX Warning: Hyper reference `astTran2' on page 18 undefined on input line 86 0. LaTeX Warning: Hyper reference `astTran1' on page 18 undefined on input line 86 2. LaTeX Warning: Hyper reference `astTranN' on page 18 undefined on input line 86 4. LaTeX Warning: Hyper reference `astTranP' on page 18 undefined on input line 86 4. LaTeX Warning: Reference `ss:functiondescriptions' on page 18 undefined on inpu t line 865. LaTeX Warning: Reference `ss:transforming' on page 18 undefined on input line 8 68. LaTeX Warning: Reference `ss:framesetasmapping' on page 18 undefined on input l ine 868. LaTeX Warning: Reference `ss:badcoordinates' on page 18 undefined on input line 870. LaTeX Warning: Reference `ss:howtoreadwcs' on page 18 undefined on input line 8 81. LaTeX Warning: Hyper reference `FrameSet' on page 18 undefined on input line 88 2. LaTeX Warning: Reference `ss:howtotransform' on page 18 undefined on input line 914. LaTeX Warning: Hyper reference `FrameSet' on page 18 undefined on input line 91 6. LaTeX Warning: Reference `ss:howtoreadwcs' on page 18 undefined on input line 9 17. LaTeX Warning: Reference `ss:howtotransform' on page 18 undefined on input line 919. [18] LaTeX Warning: Hyper reference `astFormat' on page 19 undefined on input line 9 36. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 19 undefined on inpu t line 945. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 19 undefined on i nput line 946. LaTeX Warning: Reference `ss:normalising' on page 19 undefined on input line 94 7. LaTeX Warning: Hyper reference `FrameSet' on page 19 undefined on input line 95 8. LaTeX Warning: Reference `ss:howtoreadwcs' on page 19 undefined on input line 9 59. LaTeX Warning: Reference `ss:howtotransform' on page 19 undefined on input line 960. LaTeX Warning: Hyper reference `Report' on page 19 undefined on input line 970. LaTeX Warning: Reference `ss:attributedescriptions' on page 19 undefined on inp ut line 988. LaTeX Warning: Reference `ss:settingattributes' on page 19 undefined on input l ine 989. LaTeX Warning: Reference `ss:gettingattributes' on page 19 undefined on input l ine 990. [19] LaTeX Warning: Reference `ss:howtoformatcoordinates' on page 20 undefined on in put line 995. LaTeX Warning: Hyper reference `FrameSet' on page 20 undefined on input line 10 03. LaTeX Warning: Reference `ss:howtoreadwcs' on page 20 undefined on input line 1 004. [20] LaTeX Warning: Hyper reference `astUnformat' on page 21 undefined on input line 1069. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 21 undefined on in put line 1069. LaTeX Warning: Reference `ss:unformattingskyaxisvalues' on page 21 undefined on input line 1072. LaTeX Warning: Hyper reference `FrameSet' on page 21 undefined on input line 10 82. [21] LaTeX Warning: Hyper reference `FitsChan' on page 22 undefined on input line 11 54. LaTeX Warning: Reference `ss:howtoreadwcs' on page 22 undefined on input line 1 155. LaTeX Warning: Reference `ss:howtowritewcs' on page 22 undefined on input line 1158. LaTeX Warning: Hyper reference `Frame' on page 22 undefined on input line 1164. LaTeX Warning: Hyper reference `SkyFrame' on page 22 undefined on input line 11 67. LaTeX Warning: Hyper reference `SpecFrame' on page 22 undefined on input line 1 167. LaTeX Warning: Hyper reference `CmpFrame' on page 22 undefined on input line 11 68. LaTeX Warning: Hyper reference `Mapping' on page 22 undefined on input line 117 0. [22] LaTeX Warning: Hyper reference `Mapping' on page 23 undefined on input line 118 7. LaTeX Warning: Hyper reference `MatrixMap' on page 23 undefined on input line 1 217. LaTeX Warning: Hyper reference `WinMap' on page 23 undefined on input line 1218 . LaTeX Warning: Hyper reference `ShiftMap' on page 23 undefined on input line 12 20. [23] LaTeX Warning: Reference `ss:mappingselection' on page 24 undefined on input li ne 1255. LaTeX Warning: Reference `ss:classdescriptions' on page 24 undefined on input l ine 1257. LaTeX Warning: Reference `ss:cmpmapoverview' on page 24 undefined on input line 1258. LaTeX Warning: Reference `ss:cmpmaps' on page 24 undefined on input line 1259. LaTeX Warning: Hyper reference `FrameSet' on page 24 undefined on input line 12 62. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 263. LaTeX Warning: Reference `ss:remapframe' on page 24 undefined on input line 128 8. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 24 undefined on inpu t line 1288. LaTeX Warning: Reference `ss:howtomodifywcs' on page 24 undefined on input line 1295. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 299. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 304. [24] LaTeX Warning: Hyper reference `Encoding' on page 25 undefined on input line 13 38. LaTeX Warning: Reference `ss:howtomodifywcs' on page 25 undefined on input line 1341. LaTeX Warning: Hyper reference `FrameSet' on page 25 undefined on input line 13 42. LaTeX Warning: Hyper reference `FitsChan' on page 25 undefined on input line 13 43. [25] LaTeX Warning: Reference `ss:addressingfitscards' on page 26 undefined on input line 1385. LaTeX Warning: Reference `ss:addingmulticards' on page 26 undefined on input li ne 1385. LaTeX Warning: Reference `ss:addingfitscards' on page 26 undefined on input lin e 1385. LaTeX Warning: Reference `ss:findingandchangingfits' on page 26 undefined on in put line 1386. LaTeX Warning: Hyper reference `Channel' on page 26 undefined on input line 140 8. LaTeX Warning: Hyper reference `XmlChan' on page 26 undefined on input line 140 8. LaTeX Warning: Reference `ss:channels' on page 26 undefined on input line 1409. LaTeX Warning: Reference `ss:propagatingwcsinformation' on page 26 undefined on input line 1417. LaTeX Warning: Reference `ss:writingnativefits' on page 26 undefined on input l ine 1419. LaTeX Warning: Reference `ss:writingforeignfits' on page 26 undefined on input line 1419. LaTeX Warning: Reference `ss:nativeencoding' on page 26 undefined on input line 1421. LaTeX Warning: Reference `ss:foreignencodings' on page 26 undefined on input li ne 1422. LaTeX Warning: Reference `ss:attributedescriptions' on page 26 undefined on inp ut line 1423. LaTeX Warning: Reference `ss:nativefits' on page 26 undefined on input line 142 5. LaTeX Warning: Reference `ss:foreignfits' on page 26 undefined on input line 14 25. LaTeX Warning: Reference `fig:overgrid' on page 26 undefined on input line 1430 . LaTeX Warning: Hyper reference `FrameSet' on page 26 undefined on input line 14 59. LaTeX Warning: Reference `ss:howtoreadwcs' on page 26 undefined on input line 1 460. [26] [27 <./sun211_figures/overgrid_bw.pdf>] [28] LaTeX Warning: Hyper reference `Plot' on page 29 undefined on input line 1554. LaTeX Warning: Reference `ss:plots' on page 29 undefined on input line 1560. LaTeX Warning: Reference `ss:classdescriptions' on page 29 undefined on input l ine 1561. LaTeX Warning: Reference `ss:howtobuild' on page 29 undefined on input line 156 4. LaTeX Warning: Hyper reference `ast_link' on page 29 undefined on input line 15 64. LaTeX Warning: Reference `ss:commanddescriptions' on page 29 undefined on input line 1565. LaTeX Warning: Hyper reference `Plot' on page 29 undefined on input line 1569. LaTeX Warning: Reference `ss:howtoplotgrid' on page 29 undefined on input line 1570. LaTeX Warning: Hyper reference `astPlot' on page 29 undefined on input line 157 2. [29] LaTeX Warning: Reference `ss:howtotestforcelestial' on page 30 undefined on inp ut line 1589. LaTeX Warning: Hyper reference `FrameSet' on page 30 undefined on input line 15 91. LaTeX Warning: Hyper reference `System' on page 30 undefined on input line 1595 . LaTeX Warning: Hyper reference `Equinox' on page 30 undefined on input line 159 5. LaTeX Warning: Hyper reference `Epoch' on page 30 undefined on input line 1595. LaTeX Warning: Reference `ss:attributedescriptions' on page 30 undefined on inp ut line 1596. LaTeX Warning: Hyper reference `Plot' on page 30 undefined on input line 1600. LaTeX Warning: Reference `ss:howtoplotgrid' on page 30 undefined on input line 1601. LaTeX Warning: Reference `ss:howtoswitchgrid' on page 30 undefined on input lin e 1602. LaTeX Warning: Hyper reference `Base' on page 30 undefined on input line 1644. LaTeX Warning: Hyper reference `Frame' on page 30 undefined on input line 1646. [30] LaTeX Warning: Reference `ss:classdescriptions' on page 31 undefined on input l ine 1675. LaTeX Warning: Reference `ss:attributedescriptions' on page 31 undefined on inp ut line 1677. [31] [32] LaTeX Warning: Hyper reference `Object' on page 33 undefined on input line 1705 . LaTeX Warning: Hyper reference `ZoomMap' on page 33 undefined on input line 170 8. LaTeX Warning: Hyper reference `Zoom' on page 33 undefined on input line 1714. LaTeX Warning: Hyper reference `Mapping' on page 33 undefined on input line 171 7. LaTeX Warning: Hyper reference `ZoomMap' on page 33 undefined on input line 172 2. LaTeX Warning: Hyper reference `astZoomMap' on page 33 undefined on input line 1738. LaTeX Warning: Hyper reference `Object' on page 33 undefined on input line 1740 . LaTeX Warning: Reference `ss:functiondescriptions' on page 33 undefined on inpu t line 1746. LaTeX Warning: Hyper reference `Zoom' on page 33 undefined on input line 1750. LaTeX Warning: Reference `ss:attributeinitialisation' on page 33 undefined on i nput line 1752. [33] LaTeX Warning: Hyper reference `ZoomMap' on page 34 undefined on input line 176 1. LaTeX Warning: Hyper reference `Object' on page 34 undefined on input line 1762 . LaTeX Warning: Hyper reference `Mapping' on page 34 undefined on input line 176 6. LaTeX Warning: Hyper reference `Plot' on page 34 undefined on input line 1810. LaTeX Warning: Reference `ss:plots' on page 34 undefined on input line 1811. LaTeX Warning: Hyper reference `FrameSet' on page 34 undefined on input line 18 12. LaTeX Warning: Hyper reference `Frame' on page 34 undefined on input line 1812. [34] LaTeX Warning: Reference `ss:classhierarchy' on page 35 undefined on input line 1830. LaTeX Warning: Hyper reference `ZoomMap' on page 35 undefined on input line 183 6. LaTeX Warning: Reference `ss:objectcreation' on page 35 undefined on input line 1837. LaTeX Warning: Hyper reference `astShow' on page 35 undefined on input line 183 8. LaTeX Warning: Reference `ss:functiondescriptions' on page 35 undefined on inpu t line 1842. LaTeX Warning: Hyper reference `Object' on page 35 undefined on input line 1843 . LaTeX Warning: Reference `ss:mappinghierarchy' on page 35 undefined on input li ne 1846. LaTeX Warning: Reference `ss:objectcreation' on page 35 undefined on input line 1872. LaTeX Warning: Hyper reference `Mapping' on page 35 undefined on input line 187 5. LaTeX Warning: Hyper reference `Nin' on page 35 undefined on input line 1876. LaTeX Warning: Hyper reference `Zoom' on page 35 undefined on input line 1878. LaTeX Warning: Reference `ss:displayingobjects' on page 35 undefined on input l ine 1883. LaTeX Warning: Hyper reference `Object' on page 35 undefined on input line 1884 . LaTeX Warning: Reference `ss:attributedescriptions' on page 35 undefined on inp ut line 1888. LaTeX Warning: Hyper reference `Nin' on page 35 undefined on input line 1892. LaTeX Warning: Hyper reference `ZoomMap' on page 35 undefined on input line 189 3. [35] LaTeX Warning: Hyper reference `Zoom' on page 36 undefined on input line 1912. LaTeX Warning: Hyper reference `Object' on page 36 undefined on input line 1940 . LaTeX Warning: Hyper reference `Nin' on page 36 undefined on input line 1940. LaTeX Warning: Hyper reference `ZoomMap' on page 36 undefined on input line 194 0. LaTeX Warning: Hyper reference `Zoom' on page 36 undefined on input line 1945. LaTeX Warning: Reference `ss:gettingattributes' on page 36 undefined on input l ine 1955. LaTeX Warning: Hyper reference `astSet' on page 36 undefined on input line 1972 . [36] LaTeX Warning: Hyper reference `Report' on page 37 undefined on input line 1984 . LaTeX Warning: Reference `ss:transforming' on page 37 undefined on input line 1 985. [37] LaTeX Warning: Reference `ss:gettingattributes' on page 38 undefined on input l ine 2076. LaTeX Warning: Hyper reference `Object' on page 38 undefined on input line 2076 . LaTeX Warning: Hyper reference `ZoomMap' on page 38 undefined on input line 208 7. LaTeX Warning: Hyper reference `astTest' on page 38 undefined on input line 209 8. LaTeX Warning: Hyper reference `astClear' on page 38 undefined on input line 21 11. LaTeX Warning: Hyper reference `Report' on page 38 undefined on input line 2120 . LaTeX Warning: Hyper reference `ZoomMap' on page 38 undefined on input line 212 7. [38] LaTeX Warning: Hyper reference `Report' on page 39 undefined on input line 2132 . LaTeX Warning: Hyper reference `Mapping' on page 39 undefined on input line 214 2. LaTeX Warning: Hyper reference `astTran2' on page 39 undefined on input line 21 62. LaTeX Warning: Reference `ss:functiondescriptions' on page 39 undefined on inpu t line 2165. LaTeX Warning: Hyper reference `Object' on page 39 undefined on input line 2166 . LaTeX Warning: Reference `ss:classhierarchy' on page 39 undefined on input line 2170. LaTeX Warning: Hyper reference `Zoom' on page 39 undefined on input line 2204. [39] LaTeX Warning: Hyper reference `Object' on page 40 undefined on input line 2244 . LaTeX Warning: Reference `ss:contexts' on page 40 undefined on input line 2247. LaTeX Warning: Hyper reference `astAnnul' on page 40 undefined on input line 22 48. LaTeX Warning: Hyper reference `RefCount' on page 40 undefined on input line 22 68. LaTeX Warning: Hyper reference `astAnnul' on page 40 undefined on input line 22 72. LaTeX Warning: Reference `ss:annullingpointers' on page 40 undefined on input l ine 2272. [40] LaTeX Warning: Hyper reference `ZoomMap' on page 41 undefined on input line 228 1. LaTeX Warning: Reference `ss:displayingobjects' on page 41 undefined on input l ine 2282. LaTeX Warning: Hyper reference `astZoomMap' on page 41 undefined on input line 2285. LaTeX Warning: Hyper reference `astBegin' on page 41 undefined on input line 22 90. LaTeX Warning: Hyper reference `astEnd' on page 41 undefined on input line 2290 . LaTeX Warning: Hyper reference `Object' on page 41 undefined on input line 2300 . LaTeX Warning: Hyper reference `astExport' on page 41 undefined on input line 2 317. LaTeX Warning: Reference `ss:contexts' on page 41 undefined on input line 2318. LaTeX Warning: Hyper reference `astEnd' on page 41 undefined on input line 2329 . LaTeX Warning: Hyper reference `astBegin' on page 41 undefined on input line 23 32. LaTeX Warning: Hyper reference `Object' on page 41 undefined on input line 2333 . LaTeX Warning: Hyper reference `astImport' on page 41 undefined on input line 2 337. LaTeX Warning: Hyper reference `astExempt' on page 41 undefined on input line 2 348. [41] LaTeX Warning: Hyper reference `astAnnul' on page 42 undefined on input line 23 58. LaTeX Warning: Hyper reference `Channel' on page 42 undefined on input line 237 5. LaTeX Warning: Hyper reference `Plot' on page 42 undefined on input line 2376. LaTeX Warning: Hyper reference `Object' on page 42 undefined on input line 2383 . LaTeX Warning: Hyper reference `Object' on page 42 undefined on input line 2392 . LaTeX Warning: Hyper reference `astAnnul' on page 42 undefined on input line 23 94. LaTeX Warning: Hyper reference `astUnlock' on page 42 undefined on input line 2 398. LaTeX Warning: Hyper reference `astLock' on page 42 undefined on input line 240 1. [42] LaTeX Warning: Hyper reference `astThread' on page 43 undefined on input line 2 417. LaTeX Warning: Hyper reference `astCopy' on page 43 undefined on input line 242 1. LaTeX Warning: Hyper reference `astEnd' on page 43 undefined on input line 2429 . LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2433 . LaTeX Warning: Hyper reference `astUnlock' on page 43 undefined on input line 2 433. LaTeX Warning: Hyper reference `astExempt' on page 43 undefined on input line 2 435. LaTeX Warning: Hyper reference `astLock' on page 43 undefined on input line 243 6. LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2445 . LaTeX Warning: Hyper reference `astCopy' on page 43 undefined on input line 245 9. LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2482 . [43] LaTeX Warning: Reference `ss:objecthierarchy' on page 44 undefined on input lin e 2494. LaTeX Warning: Hyper reference `ZoomMap' on page 44 undefined on input line 250 5. LaTeX Warning: Hyper reference `astShow' on page 44 undefined on input line 250 5. LaTeX Warning: Reference `ss:functiondescriptions' on page 44 undefined on inpu t line 2534. LaTeX Warning: Hyper reference `astRead' on page 44 undefined on input line 253 6. [44] LaTeX Warning: Reference `ss:displayingobjects' on page 45 undefined on input l ine 2591. LaTeX Warning: Hyper reference `Object' on page 45 undefined on input line 2598 . LaTeX Warning: Hyper reference `astOK' on page 45 undefined on input line 2622. LaTeX Warning: Hyper reference `Title' on page 45 undefined on input line 2624. LaTeX Warning: Hyper reference `ZoomMap' on page 45 undefined on input line 262 4. LaTeX Warning: Hyper reference `astStatus' on page 45 undefined on input line 2 626. [45] LaTeX Warning: Hyper reference `astAnnul' on page 46 undefined on input line 26 60. LaTeX Warning: Reference `ss:functiondescriptions' on page 46 undefined on inpu t line 2682. LaTeX Warning: Hyper reference `astClearStatus' on page 46 undefined on input l ine 2687. LaTeX Warning: Reference `ss:channelsink' on page 46 undefined on input line 27 00. LaTeX Warning: Hyper reference `astSetStatus' on page 46 undefined on input lin e 2701. [46] LaTeX Warning: Hyper reference `astWatch' on page 47 undefined on input line 27 32. [47] [48] LaTeX Warning: Reference `ss:primer' on page 49 undefined on input line 2757. LaTeX Warning: Hyper reference `ZoomMap' on page 49 undefined on input line 275 7. LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 275 8. LaTeX Warning: Reference `ss:transforming' on page 49 undefined on input line 2 759. LaTeX Warning: Hyper reference `Zoom' on page 49 undefined on input line 2761. LaTeX Warning: Hyper reference `Report' on page 49 undefined on input line 2761 . LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 277 2. LaTeX Warning: Hyper reference `Frame' on page 49 undefined on input line 2798. LaTeX Warning: Reference `ss:frames' on page 49 undefined on input line 2799. LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 281 5. LaTeX Warning: Reference `fig:mapping' on page 49 undefined on input line 2815. LaTeX Warning: Reference `ss:transforming' on page 49 undefined on input line 2 820. [49] LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 282 4. LaTeX Warning: Hyper reference `ZoomMap' on page 50 undefined on input line 282 5. LaTeX Warning: Hyper reference `Zoom' on page 50 undefined on input line 2826. LaTeX Warning: Hyper reference `Object' on page 50 undefined on input line 2838 . LaTeX Warning: Hyper reference `Invert' on page 50 undefined on input line 2842 . LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 284 7. LaTeX Warning: Hyper reference `Nin' on page 50 undefined on input line 2854. LaTeX Warning: Hyper reference `Nout' on page 50 undefined on input line 2855. LaTeX Warning: Reference `ss:objectcreation' on page 50 undefined on input line 2859. LaTeX Warning: Hyper reference `ZoomMap' on page 50 undefined on input line 286 0. LaTeX Warning: Hyper reference `astZoomMap' on page 50 undefined on input line 2861. LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 287 9. [50] LaTeX Warning: Hyper reference `TranForward' on page 51 undefined on input line 2889. LaTeX Warning: Hyper reference `TranInverse' on page 51 undefined on input line 2889. LaTeX Warning: Hyper reference `LutMap' on page 51 undefined on input line 2895 . LaTeX Warning: Hyper reference `Invert' on page 51 undefined on input line 2901 . LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 290 4. LaTeX Warning: Hyper reference `Nin' on page 51 undefined on input line 2911. LaTeX Warning: Hyper reference `Nout' on page 51 undefined on input line 2911. LaTeX Warning: Hyper reference `TranForward' on page 51 undefined on input line 2912. LaTeX Warning: Hyper reference `TranInverse' on page 51 undefined on input line 2912. LaTeX Warning: Hyper reference `astInvert' on page 51 undefined on input line 2 921. LaTeX Warning: Hyper reference `astRate' on page 51 undefined on input line 293 8. LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 293 9. LaTeX Warning: Reference `ss:transforming' on page 51 undefined on input line 2 948. LaTeX Warning: Hyper reference `Report' on page 51 undefined on input line 2949 . LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 294 9. [51] LaTeX Warning: Hyper reference `astCopy' on page 52 undefined on input line 296 1. LaTeX Warning: Reference `ss:copyingobjects' on page 52 undefined on input line 2961. LaTeX Warning: Hyper reference `Channel' on page 52 undefined on input line 296 4. LaTeX Warning: Reference `ss:channels' on page 52 undefined on input line 2964. LaTeX Warning: Hyper reference `Mapping' on page 52 undefined on input line 297 1. LaTeX Warning: Hyper reference `ZoomMap' on page 52 undefined on input line 299 4. LaTeX Warning: Hyper reference `Zoom' on page 52 undefined on input line 2994. [52] LaTeX Warning: Hyper reference `UnitMap' on page 53 undefined on input line 302 4. LaTeX Warning: Hyper reference `Mapping' on page 53 undefined on input line 302 4. LaTeX Warning: Hyper reference `Nin' on page 53 undefined on input line 3029. LaTeX Warning: Hyper reference `Nout' on page 53 undefined on input line 3029. LaTeX Warning: Hyper reference `Invert' on page 53 undefined on input line 3044 . LaTeX Warning: Hyper reference `PermMap' on page 53 undefined on input line 305 3. LaTeX Warning: Hyper reference `Mapping' on page 53 undefined on input line 305 3. [53] [54] LaTeX Warning: Reference `ss:badcoordinates' on page 55 undefined on input line 3177. [55] [56] LaTeX Warning: Hyper reference `Mapping' on page 57 undefined on input line 318 8. LaTeX Warning: Hyper reference `CmpMap' on page 57 undefined on input line 3188 . LaTeX Warning: Hyper reference `Object' on page 57 undefined on input line 3194 . LaTeX Warning: Hyper reference `PermMap' on page 57 undefined on input line 320 6. LaTeX Warning: Reference `ss:permmapexample' on page 57 undefined on input line 3206. LaTeX Warning: Hyper reference `ZoomMap' on page 57 undefined on input line 320 9. LaTeX Warning: Reference `ss:transforming' on page 57 undefined on input line 3 209. LaTeX Warning: Reference `fig:seriescmpmap' on page 57 undefined on input line 3215. LaTeX Warning: Hyper reference `CmpMap' on page 57 undefined on input line 3215 . LaTeX Warning: Hyper reference `astCmpMap' on page 57 undefined on input line 3 244. LaTeX Warning: Hyper reference `Mapping' on page 57 undefined on input line 324 8. LaTeX Warning: Hyper reference `Nout' on page 57 undefined on input line 3254. LaTeX Warning: Hyper reference `Nin' on page 57 undefined on input line 3255. [57] LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 260. LaTeX Warning: Hyper reference `PermMap' on page 58 undefined on input line 326 9. LaTeX Warning: Hyper reference `ZoomMap' on page 58 undefined on input line 326 9. LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 270. LaTeX Warning: Reference `fig:parallelcmpmap' on page 58 undefined on input lin e 3272. LaTeX Warning: Hyper reference `CmpMap' on page 58 undefined on input line 3274 . LaTeX Warning: Hyper reference `astCmpMap' on page 58 undefined on input line 3 282. LaTeX Warning: Hyper reference `Mapping' on page 58 undefined on input line 328 8. LaTeX Warning: Hyper reference `Nin' on page 58 undefined on input line 3295. LaTeX Warning: Hyper reference `Nout' on page 58 undefined on input line 3295. LaTeX Warning: Hyper reference `CmpMap' on page 58 undefined on input line 3301 . LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 303. LaTeX Warning: Hyper reference `Mapping' on page 58 undefined on input line 330 4. LaTeX Warning: Hyper reference `RefCount' on page 58 undefined on input line 33 05. LaTeX Warning: Hyper reference `astAnnul' on page 58 undefined on input line 33 07. LaTeX Warning: Reference `ss:annullingpointers' on page 58 undefined on input l ine 3309. LaTeX Warning: Reference `ss:contexts' on page 58 undefined on input line 3310. LaTeX Warning: Hyper reference `Invert' on page 58 undefined on input line 3320 . [58] LaTeX Warning: Hyper reference `CmpMap' on page 59 undefined on input line 3329 . LaTeX Warning: Hyper reference `Mapping' on page 59 undefined on input line 332 9. LaTeX Warning: Reference `ss:objecthierarchy' on page 59 undefined on input lin e 3330. LaTeX Warning: Hyper reference `astCmpMap' on page 59 undefined on input line 3 331. LaTeX Warning: Reference `fig:complexcmpmap' on page 59 undefined on input line 3351. LaTeX Warning: Hyper reference `Mapping' on page 59 undefined on input line 336 4. LaTeX Warning: Hyper reference `CmpMap' on page 59 undefined on input line 3373 . [59] LaTeX Warning: Hyper reference `astInvert' on page 60 undefined on input line 3 390. LaTeX Warning: Reference `ss:invertingmappings' on page 60 undefined on input l ine 3390. LaTeX Warning: Reference `ss:cmpmapcomponents' on page 60 undefined on input li ne 3394. LaTeX Warning: Hyper reference `CmpMap' on page 60 undefined on input line 3403 . LaTeX Warning: Reference `ss:complexcmpmap' on page 60 undefined on input line 3404. LaTeX Warning: Reference `ss:cmpmapexample' on page 60 undefined on input line 3409. LaTeX Warning: Hyper reference `Mapping' on page 60 undefined on input line 342 5. LaTeX Warning: Reference `ss:foreignfits' on page 60 undefined on input line 34 41. LaTeX Warning: Hyper reference `astSimplify' on page 60 undefined on input line 3452. LaTeX Warning: Hyper reference `CmpMap' on page 60 undefined on input line 3454 . LaTeX Warning: Reference `ss:complexcmpmap' on page 60 undefined on input line 3459. [60] LaTeX Warning: Reference `fig:simplifyexample' on page 61 undefined on input li ne 3462. LaTeX Warning: Hyper reference `UnitMap' on page 61 undefined on input line 346 8. LaTeX Warning: Hyper reference `UnitMap' on page 61 undefined on input line 346 8. LaTeX Warning: Hyper reference `Mapping' on page 61 undefined on input line 348 6. LaTeX Warning: Hyper reference `ZoomMap' on page 61 undefined on input line 349 1. LaTeX Warning: Hyper reference `Zoom' on page 61 undefined on input line 3491. LaTeX Warning: Hyper reference `PermMap' on page 61 undefined on input line 349 9. [61 <./sun211_figures/simpexamp.pdf>] [62] LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3517. LaTeX Warning: Hyper reference `Object' on page 63 undefined on input line 3517 . LaTeX Warning: Hyper reference `Mapping' on page 63 undefined on input line 351 8. LaTeX Warning: Reference `ss:mappings' on page 63 undefined on input line 3518. LaTeX Warning: Reference `ss:framesets' on page 63 undefined on input line 3521 . LaTeX Warning: Hyper reference `SkyFrame' on page 63 undefined on input line 35 25. LaTeX Warning: Hyper reference `SpecFrame' on page 63 undefined on input line 3 526. LaTeX Warning: Reference `ss:skyframes' on page 63 undefined on input line 3527 . LaTeX Warning: Reference `ss:specframes' on page 63 undefined on input line 352 7. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3533. LaTeX Warning: Hyper reference `Title' on page 63 undefined on input line 3550. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3554. LaTeX Warning: Hyper reference `astFrame' on page 63 undefined on input line 35 67. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3572. LaTeX Warning: Reference `ss:creatingframes' on page 63 undefined on input line 3573. LaTeX Warning: Hyper reference `Mapping' on page 63 undefined on input line 357 3. LaTeX Warning: Reference `ss:mappingclass' on page 63 undefined on input line 3 574. LaTeX Warning: Hyper reference `Report' on page 63 undefined on input line 3577 . LaTeX Warning: Hyper reference `astTran2' on page 63 undefined on input line 35 79. [63] LaTeX Warning: Hyper reference `UnitMap' on page 64 undefined on input line 360 6. LaTeX Warning: Reference `ss:unitmapexample' on page 64 undefined on input line 3607. LaTeX Warning: Hyper reference `Nin' on page 64 undefined on input line 3608. LaTeX Warning: Hyper reference `Nout' on page 64 undefined on input line 3608. LaTeX Warning: Reference `ss:framesets' on page 64 undefined on input line 3612 . LaTeX Warning: Hyper reference `Axis' on page 64 undefined on input line 3623. LaTeX Warning: Reference `ss:gettingattributes' on page 64 undefined on input l ine 3624. LaTeX Warning: Reference `ss:settingattributes' on page 64 undefined on input l ine 3624. LaTeX Warning: Reference `ss:defaultingattributes' on page 64 undefined on inpu t line 3625. LaTeX Warning: Hyper reference `astTest' on page 64 undefined on input line 363 8. LaTeX Warning: Hyper reference `astClear' on page 64 undefined on input line 36 38. LaTeX Warning: Hyper reference `Frame' on page 64 undefined on input line 3644. [64] LaTeX Warning: Hyper reference `Naxes' on page 65 undefined on input line 3663. LaTeX Warning: Hyper reference `Frame' on page 65 undefined on input line 3694. LaTeX Warning: Hyper reference `Mapping' on page 65 undefined on input line 369 5. LaTeX Warning: Reference `ss:attributedescriptions' on page 65 undefined on inp ut line 3697. LaTeX Warning: Hyper reference `Naxes' on page 65 undefined on input line 3702. LaTeX Warning: Hyper reference `Title' on page 65 undefined on input line 3705. LaTeX Warning: Hyper reference `Label(axis)' on page 65 undefined on input line 3708. LaTeX Warning: Hyper reference `Unit(axis)' on page 65 undefined on input line 3711. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 65 undefined on input line 3714. LaTeX Warning: Reference `ss:frameunits' on page 65 undefined on input line 371 8. [65] LaTeX Warning: Hyper reference `Symbol(axis)' on page 66 undefined on input lin e 3720. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 66 undefined on in put line 3724. LaTeX Warning: Hyper reference `Format(axis)' on page 66 undefined on input lin e 3728. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 66 undefined on inpu t line 3731. LaTeX Warning: Hyper reference `Direction(axis)' on page 66 undefined on input line 3735. LaTeX Warning: Hyper reference `Domain' on page 66 undefined on input line 3744 . LaTeX Warning: Reference `ss:framedomains' on page 66 undefined on input line 3 749. LaTeX Warning: Hyper reference `System' on page 66 undefined on input line 3751 . LaTeX Warning: Hyper reference `SkyFrame' on page 66 undefined on input line 37 57. LaTeX Warning: Hyper reference `TimeFrame' on page 66 undefined on input line 3 757. LaTeX Warning: Hyper reference `SpecFrame' on page 66 undefined on input line 3 757. LaTeX Warning: Hyper reference `Epoch' on page 66 undefined on input line 3762. LaTeX Warning: Hyper reference `ObsLon' on page 66 undefined on input line 3769 . [66] LaTeX Warning: Hyper reference `ObsLat' on page 67 undefined on input line 3776 . LaTeX Warning: Hyper reference `Frame' on page 67 undefined on input line 3789. LaTeX Warning: Hyper reference `astFormat' on page 67 undefined on input line 3 791. LaTeX Warning: Hyper reference `astSet' on page 67 undefined on input line 3833 . LaTeX Warning: Hyper reference `astNorm' on page 67 undefined on input line 384 4. LaTeX Warning: Reference `ss:normalising' on page 67 undefined on input line 38 45. [67] LaTeX Warning: Hyper reference `astNorm' on page 68 undefined on input line 385 0. LaTeX Warning: Hyper reference `Frame' on page 68 undefined on input line 3855. LaTeX Warning: Reference `ss:skyframes' on page 68 undefined on input line 3857 . LaTeX Warning: Hyper reference `astFormat' on page 68 undefined on input line 3 885. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 68 undefined on inpu t line 3885. LaTeX Warning: Hyper reference `Frame' on page 68 undefined on input line 3893. LaTeX Warning: Hyper reference `astFormat' on page 68 undefined on input line 3 894. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 68 undefined on inpu t line 3895. LaTeX Warning: Hyper reference `astUnformat' on page 68 undefined on input line 3896. [68] LaTeX Warning: Hyper reference `Format(axis)' on page 69 undefined on input lin e 3988. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 69 undefined on inpu t line 3989. [69] [70] LaTeX Warning: Hyper reference `Frame' on page 71 undefined on input line 4113. [71] LaTeX Warning: Hyper reference `astPermAxes' on page 72 undefined on input line 4126. LaTeX Warning: Hyper reference `Frame' on page 72 undefined on input line 4141. LaTeX Warning: Hyper reference `astPermAxes' on page 72 undefined on input line 4143. LaTeX Warning: Reference `ss:permutingaxes' on page 72 undefined on input line 4144. LaTeX Warning: Hyper reference `astCopy' on page 72 undefined on input line 416 9. LaTeX Warning: Reference `ss:copyingobjects' on page 72 undefined on input line 4170. LaTeX Warning: Hyper reference `astPickAxes' on page 72 undefined on input line 4172. LaTeX Warning: Hyper reference `Mapping' on page 72 undefined on input line 417 3. LaTeX Warning: Hyper reference `PermMap' on page 72 undefined on input line 418 0. LaTeX Warning: Reference `ss:permmapexample' on page 72 undefined on input line 4180. [72] LaTeX Warning: Hyper reference `Frame' on page 73 undefined on input line 4220. LaTeX Warning: Hyper reference `astDistance' on page 73 undefined on input line 4228. LaTeX Warning: Hyper reference `SkyFrame' on page 73 undefined on input line 42 49. LaTeX Warning: Hyper reference `astOffset' on page 73 undefined on input line 4 252. [73] LaTeX Warning: Hyper reference `astAxDistance' on page 74 undefined on input li ne 4276. LaTeX Warning: Hyper reference `astAxOffset' on page 74 undefined on input line 4276. LaTeX Warning: Hyper reference `astOffset2' on page 74 undefined on input line 4283. LaTeX Warning: Hyper reference `astAngle' on page 74 undefined on input line 43 16. [74] LaTeX Warning: Hyper reference `astAxAngle' on page 75 undefined on input line 4324. LaTeX Warning: Hyper reference `astResolve' on page 75 undefined on input line 4328. LaTeX Warning: Hyper reference `Domain' on page 75 undefined on input line 4341 . LaTeX Warning: Hyper reference `Frame' on page 75 undefined on input line 4342. LaTeX Warning: Reference `ss:framesetconverting' on page 75 undefined on input line 4344. [75] LaTeX Warning: Reference `ss:framesets' on page 76 undefined on input line 4413 . LaTeX Warning: Reference `ss:domainconventions' on page 76 undefined on input l ine 4451. LaTeX Warning: Hyper reference `Domain' on page 76 undefined on input line 4455 . LaTeX Warning: Hyper reference `Frame' on page 76 undefined on input line 4455. [76] LaTeX Warning: Reference `ss:skyframes' on page 77 undefined on input line 4519 . LaTeX Warning: Hyper reference `SkyFrame' on page 77 undefined on input line 45 20. LaTeX Warning: Hyper reference `SpecFrame' on page 77 undefined on input line 4 525. LaTeX Warning: Reference `ss:specframes' on page 77 undefined on input line 452 5. [77] LaTeX Warning: Hyper reference `TimeFrame' on page 78 undefined on input line 4 531. LaTeX Warning: Hyper reference `Frame' on page 78 undefined on input line 4548. LaTeX Warning: Hyper reference `Plot' on page 78 undefined on input line 4557. LaTeX Warning: Hyper reference `Mapping' on page 78 undefined on input line 455 8. LaTeX Warning: Hyper reference `astConvert' on page 78 undefined on input line 4561. LaTeX Warning: Hyper reference `UnitMap' on page 78 undefined on input line 456 2. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 78 undefined on input line 4573. LaTeX Warning: Hyper reference `astGetActiveUnit' on page 78 undefined on input line 4573. LaTeX Warning: Hyper reference `SpecFrame' on page 78 undefined on input line 4 574. LaTeX Warning: Hyper reference `TimeFrame' on page 78 undefined on input line 4 574. [78] LaTeX Warning: Hyper reference `FrameSet' on page 79 undefined on input line 46 11. LaTeX Warning: Hyper reference `ZoomMap' on page 79 undefined on input line 461 3. LaTeX Warning: Hyper reference `Mapping' on page 79 undefined on input line 462 5. LaTeX Warning: Hyper reference `Full' on page 79 undefined on input line 4664. LaTeX Warning: Float too large for page by 241.1866pt on input line 4738. LaTeX Warning: Hyper reference `Axis' on page 79 undefined on input line 4788. LaTeX Warning: Hyper reference `Mapping' on page 79 undefined on input line 479 5. [79] [80] [81] [82] LaTeX Warning: Hyper reference `Frame' on page 83 undefined on input line 4802. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 04. LaTeX Warning: Reference `ss:frames' on page 83 undefined on input line 4806. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 10. LaTeX Warning: Hyper reference `Frame' on page 83 undefined on input line 4810. LaTeX Warning: Reference `ss:frames' on page 83 undefined on input line 4810. LaTeX Warning: Hyper reference `Mapping' on page 83 undefined on input line 481 1. LaTeX Warning: Reference `ss:mappings' on page 83 undefined on input line 4811. LaTeX Warning: Reference `ss:frameasmapping' on page 83 undefined on input line 4814. LaTeX Warning: Hyper reference `UnitMap' on page 83 undefined on input line 481 4. LaTeX Warning: Hyper reference `astPermAxes' on page 83 undefined on input line 4832. LaTeX Warning: Reference `ss:permutingaxes' on page 83 undefined on input line 4832. LaTeX Warning: Hyper reference `LatAxis' on page 83 undefined on input line 483 3. LaTeX Warning: Hyper reference `LonAxis' on page 83 undefined on input line 483 3. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 43. [83] LaTeX Warning: Hyper reference `SkyFrame' on page 84 undefined on input line 48 69. LaTeX Warning: Hyper reference `System' on page 84 undefined on input line 4869 . LaTeX Warning: Hyper reference `Equinox' on page 84 undefined on input line 488 2. LaTeX Warning: Reference `ss:equinoxitem' on page 84 undefined on input line 48 82. LaTeX Warning: Reference `ss:attributedescriptions' on page 84 undefined on inp ut line 4887. LaTeX Warning: Hyper reference `Mapping' on page 84 undefined on input line 489 2. LaTeX Warning: Reference `ss:introducingconversion' on page 84 undefined on inp ut line 4894. LaTeX Warning: Hyper reference `SkyFrame' on page 84 undefined on input line 49 06. LaTeX Warning: Hyper reference `System' on page 84 undefined on input line 4908 . LaTeX Warning: Hyper reference `Frame' on page 84 undefined on input line 4916. LaTeX Warning: Hyper reference `Epoch' on page 84 undefined on input line 4926. LaTeX Warning: Hyper reference `Equinox' on page 84 undefined on input line 493 1. [84] LaTeX Warning: Reference `ss:attributedescriptions' on page 85 undefined on inp ut line 4958. LaTeX Warning: Reference `ss:attributedescriptions' on page 85 undefined on inp ut line 4960. LaTeX Warning: Hyper reference `SkyFrame' on page 85 undefined on input line 49 85. LaTeX Warning: Hyper reference `System' on page 85 undefined on input line 4986 . LaTeX Warning: Hyper reference `astShow' on page 85 undefined on input line 498 9. [85] LaTeX Warning: Hyper reference `Title' on page 86 undefined on input line 5026. LaTeX Warning: Hyper reference `astFormat' on page 86 undefined on input line 5 032. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 86 undefined on inpu t line 5033. LaTeX Warning: Hyper reference `Frame' on page 86 undefined on input line 5036. LaTeX Warning: Hyper reference `astFormat' on page 86 undefined on input line 5 051. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 86 undefined on inpu t line 5052. LaTeX Warning: Hyper reference `SkyFrame' on page 86 undefined on input line 50 56. LaTeX Warning: Hyper reference `Frame' on page 86 undefined on input line 5057. LaTeX Warning: Reference `ss:formattingwithdigits' on page 86 undefined on inpu t line 5057. LaTeX Warning: Hyper reference `Format(axis)' on page 86 undefined on input lin e 5060. LaTeX Warning: Reference `ss:attributedescriptions' on page 86 undefined on inp ut line 5065. [86] [87] LaTeX Warning: Hyper reference `AsTime(axis)' on page 88 undefined on input lin e 5130. LaTeX Warning: Hyper reference `System' on page 88 undefined on input line 5136 . LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 88 undefined on in put line 5144. LaTeX Warning: Hyper reference `astFormat' on page 88 undefined on input line 5 155. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 88 undefined on i nput line 5156. LaTeX Warning: Hyper reference `astUnformat' on page 88 undefined on input line 5157. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 88 undefined on in put line 5158. LaTeX Warning: Hyper reference `SkyFrame' on page 88 undefined on input line 51 59. [88] LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 89 undefined on i nput line 5228. [89] LaTeX Warning: Hyper reference `Format(axis)' on page 90 undefined on input lin e 5274. [90] LaTeX Warning: Hyper reference `SkyFrame' on page 91 undefined on input line 53 29. LaTeX Warning: Hyper reference `System' on page 91 undefined on input line 5331 . [91] LaTeX Warning: Hyper reference `SkyRefIs' on page 92 undefined on input line 53 47. [92] LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 358. LaTeX Warning: Hyper reference `Frame' on page 93 undefined on input line 5358. LaTeX Warning: Reference `ss:frames' on page 93 undefined on input line 5361. LaTeX Warning: Hyper reference `SkyFrame' on page 93 undefined on input line 53 65. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 365. LaTeX Warning: Hyper reference `Frame' on page 93 undefined on input line 5365. LaTeX Warning: Reference `ss:frames' on page 93 undefined on input line 5365. LaTeX Warning: Hyper reference `Mapping' on page 93 undefined on input line 536 6. LaTeX Warning: Reference `ss:mappings' on page 93 undefined on input line 5366. LaTeX Warning: Reference `ss:frameasmapping' on page 93 undefined on input line 5369. LaTeX Warning: Hyper reference `UnitMap' on page 93 undefined on input line 536 9. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 380. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 402. LaTeX Warning: Hyper reference `System' on page 93 undefined on input line 5402 . LaTeX Warning: Reference `ss:attributedescriptions' on page 93 undefined on inp ut line 5418. [93] LaTeX Warning: Hyper reference `SpecFrame' on page 94 undefined on input line 5 432. LaTeX Warning: Hyper reference `System' on page 94 undefined on input line 5434 . LaTeX Warning: Hyper reference `Frame' on page 94 undefined on input line 5442. LaTeX Warning: Hyper reference `Epoch' on page 94 undefined on input line 5452. LaTeX Warning: Hyper reference `StdOfRest' on page 94 undefined on input line 5 459. LaTeX Warning: Hyper reference `RestFreq' on page 94 undefined on input line 54 65. LaTeX Warning: Hyper reference `RefRA' on page 94 undefined on input line 5471. LaTeX Warning: Hyper reference `RefDec' on page 94 undefined on input line 5476 . LaTeX Warning: Hyper reference `SourceVel' on page 94 undefined on input line 5 480. LaTeX Warning: Reference `ss:attributedescriptions' on page 94 undefined on inp ut line 5490. LaTeX Warning: Reference `ss:attributedescriptions' on page 94 undefined on inp ut line 5492. [94] LaTeX Warning: Hyper reference `SpecFrame' on page 95 undefined on input line 5 501. LaTeX Warning: Hyper reference `System' on page 95 undefined on input line 5502 . LaTeX Warning: Hyper reference `astShow' on page 95 undefined on input line 550 5. LaTeX Warning: Hyper reference `Title' on page 95 undefined on input line 5535. [95] LaTeX Warning: Hyper reference `astConvert' on page 96 undefined on input line 5571. LaTeX Warning: Hyper reference `RefRA' on page 96 undefined on input line 5578. LaTeX Warning: Hyper reference `RefDec' on page 96 undefined on input line 5578 . LaTeX Warning: Hyper reference `RestFreq' on page 96 undefined on input line 55 81. LaTeX Warning: Hyper reference `SpecFrame' on page 96 undefined on input line 5 591. LaTeX Warning: Hyper reference `Frame' on page 96 undefined on input line 5593. LaTeX Warning: Hyper reference `SkyFrame' on page 96 undefined on input line 55 94. LaTeX Warning: Hyper reference `CmpFrame' on page 96 undefined on input line 55 95. LaTeX Warning: Hyper reference `astPermAxes' on page 96 undefined on input line 5612. LaTeX Warning: Hyper reference `RefRA' on page 96 undefined on input line 5619. LaTeX Warning: Hyper reference `RefDec' on page 96 undefined on input line 5619 . [96] LaTeX Warning: Hyper reference `SpecFrame' on page 97 undefined on input line 5 665. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 97 undefined on input lin e 5668. LaTeX Warning: Hyper reference `SideBand' on page 97 undefined on input line 56 70. LaTeX Warning: Hyper reference `astConvert' on page 97 undefined on input line 5674. LaTeX Warning: Hyper reference `Mapping' on page 97 undefined on input line 567 5. LaTeX Warning: Reference `eqn:dsb' on page 97 undefined on input line 5680. LaTeX Warning: Hyper reference `StdOfRest' on page 97 undefined on input line 5 681. LaTeX Warning: Hyper reference `UnitMap' on page 97 undefined on input line 568 9. [97] LaTeX Warning: Hyper reference `DSBCentre' on page 98 undefined on input line 5 724. LaTeX Warning: Hyper reference `IF' on page 98 undefined on input line 5725. [98] LaTeX Warning: Hyper reference `TimeFrame' on page 99 undefined on input line 5 741. LaTeX Warning: Hyper reference `Frame' on page 99 undefined on input line 5741. LaTeX Warning: Reference `ss:frames' on page 99 undefined on input line 5743. LaTeX Warning: Hyper reference `SkyFrame' on page 99 undefined on input line 57 47. LaTeX Warning: Hyper reference `TimeFrame' on page 99 undefined on input line 5 747. LaTeX Warning: Hyper reference `Frame' on page 99 undefined on input line 5747. LaTeX Warning: Reference `ss:frames' on page 99 undefined on input line 5747. LaTeX Warning: Hyper reference `Mapping' on page 99 undefined on input line 574 8. LaTeX Warning: Reference `ss:mappings' on page 99 undefined on input line 5748. LaTeX Warning: Reference `ss:frameasmapping' on page 99 undefined on input line 5751. LaTeX Warning: Hyper reference `UnitMap' on page 99 undefined on input line 575 1. LaTeX Warning: Hyper reference `TimeOrigin' on page 99 undefined on input line 5757. LaTeX Warning: Hyper reference `TimeScale' on page 99 undefined on input line 5 758. LaTeX Warning: Hyper reference `Epoch' on page 99 undefined on input line 5759. LaTeX Warning: Hyper reference `System' on page 99 undefined on input line 5760 . LaTeX Warning: Hyper reference `TimeFrame' on page 99 undefined on input line 5 767. LaTeX Warning: Hyper reference `System' on page 99 undefined on input line 5786 . LaTeX Warning: Hyper reference `TimeFrame' on page 99 undefined on input line 5 786. LaTeX Warning: Hyper reference `Epoch' on page 99 undefined on input line 5787. LaTeX Warning: Hyper reference `TimeScale' on page 99 undefined on input line 5 788. [99] LaTeX Warning: Reference `ss:attributedescriptions' on page 100 undefined on in put line 5808. LaTeX Warning: Hyper reference `TimeFrame' on page 100 undefined on input line 5818. LaTeX Warning: Hyper reference `System' on page 100 undefined on input line 582 0. LaTeX Warning: Hyper reference `Frame' on page 100 undefined on input line 5827 . LaTeX Warning: Hyper reference `TimeScale' on page 100 undefined on input line 5836. LaTeX Warning: Hyper reference `LTOffset' on page 100 undefined on input line 5 839. LaTeX Warning: Hyper reference `TimeOrigin' on page 100 undefined on input line 5844. LaTeX Warning: Reference `ss:attributedescriptions' on page 100 undefined on in put line 5855. LaTeX Warning: Reference `ss:attributedescriptions' on page 100 undefined on in put line 5857. [100] LaTeX Warning: Hyper reference `Mapping' on page 101 undefined on input line 58 67. LaTeX Warning: Hyper reference `CmpFrame' on page 101 undefined on input line 5 867. LaTeX Warning: Hyper reference `Frame' on page 101 undefined on input line 5870 . LaTeX Warning: Hyper reference `Object' on page 101 undefined on input line 587 3. LaTeX Warning: Hyper reference `CmpFrame' on page 101 undefined on input line 5 880. LaTeX Warning: Hyper reference `Frame' on page 101 undefined on input line 5881 . LaTeX Warning: Hyper reference `SkyFrame' on page 101 undefined on input line 5 887. LaTeX Warning: Hyper reference `SpecFrame' on page 101 undefined on input line 5887. LaTeX Warning: Hyper reference `CmpFrame' on page 101 undefined on input line 5 919. LaTeX Warning: Hyper reference `Frame' on page 101 undefined on input line 5919 . LaTeX Warning: Hyper reference `Domain' on page 101 undefined on input line 592 0. LaTeX Warning: Hyper reference `System' on page 101 undefined on input line 592 4. [101] LaTeX Warning: Hyper reference `Epoch' on page 102 undefined on input line 5938 . LaTeX Warning: Hyper reference `Title' on page 102 undefined on input line 5938 . LaTeX Warning: Hyper reference `SpecFrame' on page 102 undefined on input line 5941. LaTeX Warning: Hyper reference `SkyFrame' on page 102 undefined on input line 5 941. LaTeX Warning: Hyper reference `Equinox' on page 102 undefined on input line 59 49. [102] LaTeX Warning: Reference `ss:frames' on page 103 undefined on input line 5978. LaTeX Warning: Reference `ss:skyframes' on page 103 undefined on input line 597 8. LaTeX Warning: Reference `ss:specframes' on page 103 undefined on input line 59 79. LaTeX Warning: Reference `ss:timeframes' on page 103 undefined on input line 59 79. LaTeX Warning: Reference `ss:mappings' on page 103 undefined on input line 5980 . LaTeX Warning: Reference `ss:framesetconverting' on page 103 undefined on input line 5982. LaTeX Warning: Hyper reference `SkyFrame' on page 103 undefined on input line 6 019. LaTeX Warning: Hyper reference `astConvert' on page 103 undefined on input line 6021. LaTeX Warning: Hyper reference `Object' on page 103 undefined on input line 604 4. [103] LaTeX Warning: Hyper reference `FrameSet' on page 104 undefined on input line 6 046. LaTeX Warning: Reference `ss:framesets' on page 104 undefined on input line 604 7. LaTeX Warning: Hyper reference `Mapping' on page 104 undefined on input line 60 49. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 104 undefined on inp ut line 6052. LaTeX Warning: Hyper reference `astTran2' on page 104 undefined on input line 6 075. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 104 undefined on inp ut line 6085. LaTeX Warning: Hyper reference `Frame' on page 104 undefined on input line 6086 . LaTeX Warning: Hyper reference `astDistance' on page 104 undefined on input lin e 6090. LaTeX Warning: Hyper reference `Report' on page 104 undefined on input line 610 6. LaTeX Warning: Reference `ss:transforming' on page 104 undefined on input line 6108. [104] LaTeX Warning: Hyper reference `SpecFrame' on page 105 undefined on input line 6156. [105] LaTeX Warning: Hyper reference `Epoch' on page 106 undefined on input line 6194 . LaTeX Warning: Hyper reference `ObsLat' on page 106 undefined on input line 619 5. LaTeX Warning: Hyper reference `ObsLon' on page 106 undefined on input line 619 5. LaTeX Warning: Hyper reference `RefRA' on page 106 undefined on input line 6196 . LaTeX Warning: Hyper reference `RefDec' on page 106 undefined on input line 619 6. LaTeX Warning: Hyper reference `RestFreq' on page 106 undefined on input line 6 196. LaTeX Warning: Hyper reference `StdOfRest' on page 106 undefined on input line 6197. LaTeX Warning: Hyper reference `FrameSet' on page 106 undefined on input line 6 218. LaTeX Warning: Hyper reference `astTran1' on page 106 undefined on input line 6 221. LaTeX Warning: Hyper reference `astTran2' on page 106 undefined on input line 6 221. LaTeX Warning: Hyper reference `SkyFrame' on page 106 undefined on input line 6 222. LaTeX Warning: Hyper reference `SkyFrame' on page 106 undefined on input line 6 252. LaTeX Warning: Reference `ss:convertingskyframes' on page 106 undefined on inpu t line 6252. LaTeX Warning: Hyper reference `astPermAxes' on page 106 undefined on input lin e 6253. LaTeX Warning: Reference `ss:permutingaxes' on page 106 undefined on input line 6254. LaTeX Warning: Hyper reference `astConvert' on page 106 undefined on input line 6255. [106] LaTeX Warning: Hyper reference `FrameSet' on page 107 undefined on input line 6 281. LaTeX Warning: Reference `ss:convertingskyframes' on page 107 undefined on inpu t line 6298. LaTeX Warning: Hyper reference `LatAxis' on page 107 undefined on input line 63 11. LaTeX Warning: Hyper reference `LonAxis' on page 107 undefined on input line 63 11. LaTeX Warning: Reference `ss:convertingskyframes' on page 107 undefined on inpu t line 6317. LaTeX Warning: Reference `ss:convertingpermutedaxes' on page 107 undefined on i nput line 6318. LaTeX Warning: Hyper reference `Frame' on page 107 undefined on input line 6319 . LaTeX Warning: Hyper reference `astConvert' on page 107 undefined on input line 6320. [107] LaTeX Warning: Hyper reference `FrameSet' on page 108 undefined on input line 6 335. LaTeX Warning: Hyper reference `UnitMap' on page 108 undefined on input line 63 46. LaTeX Warning: Reference `ss:unitmapexample' on page 108 undefined on input lin e 6347. LaTeX Warning: Reference `ss:convertingpermutedaxes' on page 108 undefined on i nput line 6348. LaTeX Warning: Hyper reference `SkyFrame' on page 108 undefined on input line 6 352. LaTeX Warning: Hyper reference `Mapping' on page 108 undefined on input line 64 24. LaTeX Warning: Hyper reference `Domain' on page 108 undefined on input line 643 1. LaTeX Warning: Hyper reference `Frame' on page 108 undefined on input line 6443 . LaTeX Warning: Hyper reference `AlignSystem' on page 108 undefined on input lin e 6443. LaTeX Warning: Hyper reference `SpecFrame' on page 108 undefined on input line 6448. [108] LaTeX Warning: Hyper reference `AlignStdOfRest' on page 109 undefined on input line 6468. LaTeX Warning: Hyper reference `TimeFrame' on page 109 undefined on input line 6470. LaTeX Warning: Hyper reference `AlignTimeScale' on page 109 undefined on input line 6470. LaTeX Warning: Hyper reference `SkyFrame' on page 109 undefined on input line 6 472. [109] [110] LaTeX Warning: Reference `ss:introducingconversion' on page 111 undefined on in put line 6478. LaTeX Warning: Hyper reference `astConvert' on page 111 undefined on input line 6478. LaTeX Warning: Hyper reference `Mapping' on page 111 undefined on input line 64 79. LaTeX Warning: Reference `ss:framedomains' on page 111 undefined on input line 6503. LaTeX Warning: Hyper reference `Domain' on page 111 undefined on input line 650 4. LaTeX Warning: Hyper reference `FrameSet' on page 111 undefined on input line 6 512. LaTeX Warning: Hyper reference `Frame' on page 111 undefined on input line 6517 . LaTeX Warning: Hyper reference `Mapping' on page 111 undefined on input line 65 17. LaTeX Warning: Hyper reference `FrameSet' on page 111 undefined on input line 6 542. LaTeX Warning: Reference `fig:frameset' on page 111 undefined on input line 654 2. [111] LaTeX Warning: Hyper reference `FrameSet' on page 112 undefined on input line 6 551. LaTeX Warning: Hyper reference `Frame' on page 112 undefined on input line 6551 . LaTeX Warning: Hyper reference `Domain' on page 112 undefined on input line 656 5. LaTeX Warning: Reference `ss:framedomains' on page 112 undefined on input line 6565. LaTeX Warning: Hyper reference `FrameSet' on page 112 undefined on input line 6 583. LaTeX Warning: Reference `ss:creatingaframeset' on page 112 undefined on input line 6584. LaTeX Warning: Hyper reference `Frame' on page 112 undefined on input line 6584 . LaTeX Warning: Hyper reference `Mapping' on page 112 undefined on input line 65 85. LaTeX Warning: Hyper reference `ZoomMap' on page 112 undefined on input line 65 87. LaTeX Warning: Hyper reference `astAddFrame' on page 112 undefined on input lin e 6602. LaTeX Warning: Reference `ss:creatingaframeset' on page 112 undefined on input line 6613. LaTeX Warning: Hyper reference `astCopy' on page 112 undefined on input line 66 25. LaTeX Warning: Reference `ss:copyingobjects' on page 112 undefined on input lin e 6626. LaTeX Warning: Hyper reference `Object' on page 112 undefined on input line 662 6. [112] LaTeX Warning: Hyper reference `astBegin' on page 113 undefined on input line 6 641. LaTeX Warning: Hyper reference `astEnd' on page 113 undefined on input line 664 1. LaTeX Warning: Reference `ss:contexts' on page 113 undefined on input line 6641 . LaTeX Warning: Reference `fig:fsexample' on page 113 undefined on input line 66 45. LaTeX Warning: Hyper reference `Base' on page 113 undefined on input line 6654. LaTeX Warning: Hyper reference `Current' on page 113 undefined on input line 66 54. LaTeX Warning: Hyper reference `Base' on page 113 undefined on input line 6654. LaTeX Warning: Hyper reference `Current' on page 113 undefined on input line 66 54. LaTeX Warning: Hyper reference `Nframe' on page 113 undefined on input line 665 8. LaTeX Warning: Hyper reference `FrameSet' on page 113 undefined on input line 6 662. LaTeX Warning: Hyper reference `Frame' on page 113 undefined on input line 6663 . LaTeX Warning: Reference `fig:fsexample' on page 113 undefined on input line 66 64. LaTeX Warning: Hyper reference `Base' on page 113 undefined on input line 6665. LaTeX Warning: Hyper reference `Current' on page 113 undefined on input line 66 65. [113 <./sun211_figures/fsexample.pdf>] LaTeX Warning: Hyper reference `Invert' on page 114 undefined on input line 670 1. LaTeX Warning: Reference `fig:fsexample' on page 114 undefined on input line 67 05. LaTeX Warning: Reference `ss:baseandcurrent' on page 114 undefined on input lin e 6710. LaTeX Warning: Hyper reference `FrameSet' on page 114 undefined on input line 6 710. LaTeX Warning: Hyper reference `Base' on page 114 undefined on input line 6711. LaTeX Warning: Hyper reference `Current' on page 114 undefined on input line 67 11. LaTeX Warning: Hyper reference `Frame' on page 114 undefined on input line 6715 . LaTeX Warning: Reference `ss:addingframes' on page 114 undefined on input line 6719. LaTeX Warning: Hyper reference `FrameSet' on page 114 undefined on input line 6 739. LaTeX Warning: Hyper reference `Frame' on page 114 undefined on input line 6739 . LaTeX Warning: Reference `ss:frames' on page 114 undefined on input line 6740. LaTeX Warning: Hyper reference `Mapping' on page 114 undefined on input line 67 40. LaTeX Warning: Reference `ss:mappings' on page 114 undefined on input line 6741 . [114] LaTeX Warning: Hyper reference `astTran2' on page 115 undefined on input line 6 745. LaTeX Warning: Reference `fig:fsexample' on page 115 undefined on input line 67 60. LaTeX Warning: Hyper reference `Nin' on page 115 undefined on input line 6768. LaTeX Warning: Hyper reference `Nout' on page 115 undefined on input line 6768. LaTeX Warning: Hyper reference `Invert' on page 115 undefined on input line 677 4. LaTeX Warning: Hyper reference `astInvert' on page 115 undefined on input line 6774. LaTeX Warning: Reference `ss:invertingmappings' on page 115 undefined on input line 6775. LaTeX Warning: Hyper reference `Base' on page 115 undefined on input line 6776. LaTeX Warning: Hyper reference `Current' on page 115 undefined on input line 67 76. LaTeX Warning: Hyper reference `FrameSet' on page 115 undefined on input line 6 787. LaTeX Warning: Hyper reference `Mapping' on page 115 undefined on input line 67 87. LaTeX Warning: Reference `ss:framesetasmapping' on page 115 undefined on input line 6788. LaTeX Warning: Hyper reference `astGetMapping' on page 115 undefined on input l ine 6795. LaTeX Warning: Hyper reference `astCopy' on page 115 undefined on input line 68 11. LaTeX Warning: Reference `ss:copyingobjects' on page 115 undefined on input lin e 6812. [115] LaTeX Warning: Hyper reference `CmpMap' on page 116 undefined on input line 681 5. LaTeX Warning: Reference `ss:cmpmaps' on page 116 undefined on input line 6815. LaTeX Warning: Hyper reference `astSimplify' on page 116 undefined on input lin e 6819. LaTeX Warning: Reference `ss:simplifyingcmpmaps' on page 116 undefined on input line 6819. LaTeX Warning: Hyper reference `FrameSet' on page 116 undefined on input line 6 825. LaTeX Warning: Hyper reference `Frame' on page 116 undefined on input line 6825 . LaTeX Warning: Hyper reference `Title' on page 116 undefined on input line 6827 . LaTeX Warning: Hyper reference `Naxes' on page 116 undefined on input line 6843 . LaTeX Warning: Hyper reference `Label(axis)' on page 116 undefined on input lin e 6843. LaTeX Warning: Hyper reference `Format(axis)' on page 116 undefined on input li ne 6844. LaTeX Warning: Hyper reference `Class' on page 116 undefined on input line 6848 . LaTeX Warning: Hyper reference `ID' on page 116 undefined on input line 6851. LaTeX Warning: Hyper reference `Nin' on page 116 undefined on input line 6854. LaTeX Warning: Hyper reference `Invert' on page 116 undefined on input line 685 7. LaTeX Warning: Hyper reference `Nobject' on page 116 undefined on input line 68 60. LaTeX Warning: Hyper reference `RefCount' on page 116 undefined on input line 6 863. LaTeX Warning: Hyper reference `SkyFrame' on page 116 undefined on input line 6 871. LaTeX Warning: Reference `ss:skyframes' on page 116 undefined on input line 687 1. LaTeX Warning: Hyper reference `Equinox' on page 116 undefined on input line 68 72. LaTeX Warning: Hyper reference `FrameSet' on page 116 undefined on input line 6 880. LaTeX Warning: Hyper reference `Frame' on page 116 undefined on input line 6880 . LaTeX Warning: Hyper reference `astGetFrame' on page 116 undefined on input lin e 6882. [116] LaTeX Warning: Reference `ss:astbaseandastcurrent' on page 117 undefined on inp ut line 6893. LaTeX Warning: Hyper reference `Base' on page 117 undefined on input line 6894. LaTeX Warning: Hyper reference `Frame' on page 117 undefined on input line 6898 . LaTeX Warning: Hyper reference `FrameSet' on page 117 undefined on input line 6 898. LaTeX Warning: Hyper reference `astRemoveFrame' on page 117 undefined on input line 6899. LaTeX Warning: Hyper reference `Nframe' on page 117 undefined on input line 691 3. LaTeX Warning: Hyper reference `Base' on page 117 undefined on input line 6916. LaTeX Warning: Hyper reference `Current' on page 117 undefined on input line 69 17. LaTeX Warning: Reference `ss:baseandcurrentdefault' on page 117 undefined on in put line 6920. LaTeX Warning: Reference `fig:fsexample' on page 117 undefined on input line 69 25. [117] [118] LaTeX Warning: Reference `ss:framesetconverting' on page 119 undefined on input line 6935. LaTeX Warning: Hyper reference `astConvert' on page 119 undefined on input line 6936. LaTeX Warning: Reference `ss:introducingconversion' on page 119 undefined on in put line 6937. LaTeX Warning: Hyper reference `Frame' on page 119 undefined on input line 6939 . LaTeX Warning: Hyper reference `FrameSet' on page 119 undefined on input line 6 939. LaTeX Warning: Reference `ss:convertingskyframes' on page 119 undefined on inpu t line 6943. LaTeX Warning: Reference `fig:fsconvert' on page 119 undefined on input line 69 63. LaTeX Warning: Hyper reference `SkyFrame' on page 119 undefined on input line 6 971. LaTeX Warning: Hyper reference `Mapping' on page 119 undefined on input line 69 71. LaTeX Warning: Hyper reference `SkyFrame' on page 119 undefined on input line 6 971. LaTeX Warning: Hyper reference `Mapping' on page 119 undefined on input line 69 71. LaTeX Warning: Reference `ss:convertingskyframes' on page 119 undefined on inpu t line 6983. LaTeX Warning: Hyper reference `astGetMapping' on page 119 undefined on input l ine 6987. LaTeX Warning: Reference `ss:extractingamapping' on page 119 undefined on input line 6987. [119 <./sun211_figures/fsconvert.pdf>] LaTeX Warning: Reference `ss:registeringimages' on page 120 undefined on input line 7003. LaTeX Warning: Reference `fig:fsalign' on page 120 undefined on input line 7004 . LaTeX Warning: Hyper reference `FrameSet' on page 120 undefined on input line 7 015. LaTeX Warning: Hyper reference `Domain' on page 120 undefined on input line 701 5. LaTeX Warning: Hyper reference `FrameSet' on page 120 undefined on input line 7 015. LaTeX Warning: Hyper reference `Domain' on page 120 undefined on input line 701 5. LaTeX Warning: Reference `ss:framesetasframe' on page 120 undefined on input li ne 7020. LaTeX Warning: Hyper reference `Frame' on page 120 undefined on input line 7021 . LaTeX Warning: Hyper reference `astConvert' on page 120 undefined on input line 7022. LaTeX Warning: Reference `ss:convertingskyframes' on page 120 undefined on inpu t line 7023. LaTeX Warning: Reference `fig:fsalign' on page 120 undefined on input line 7042 . LaTeX Warning: Reference `ss:framedomains' on page 120 undefined on input line 7048. LaTeX Warning: Hyper reference `SkyFrame' on page 120 undefined on input line 7 067. LaTeX Warning: Reference `ss:framedomains' on page 120 undefined on input line 7071. [120] [121 <./sun211_figures/fsalign.pdf>] LaTeX Warning: Reference `ss:functiondescriptions' on page 122 undefined on inp ut line 7084. LaTeX Warning: Hyper reference `Mapping' on page 122 undefined on input line 70 90. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 122 undefined on inp ut line 7123. LaTeX Warning: Hyper reference `Base' on page 122 undefined on input line 7131. LaTeX Warning: Reference `ss:baseandcurrent' on page 122 undefined on input lin e 7133. LaTeX Warning: Hyper reference `Frame' on page 122 undefined on input line 7143 . LaTeX Warning: Hyper reference `FrameSet' on page 122 undefined on input line 7 143. LaTeX Warning: Reference `ss:domainconventions' on page 122 undefined on input line 7145. [122] LaTeX Warning: Hyper reference `astCopy' on page 123 undefined on input line 71 54. LaTeX Warning: Reference `ss:copyingobjects' on page 123 undefined on input lin e 7154. LaTeX Warning: Hyper reference `astInvert' on page 123 undefined on input line 7160. LaTeX Warning: Hyper reference `astConvert' on page 123 undefined on input line 7169. LaTeX Warning: Reference `ss:framedomains' on page 123 undefined on input line 7195. LaTeX Warning: Reference `ss:convertingskyframes' on page 123 undefined on inpu t line 7211. LaTeX Warning: Hyper reference `Base' on page 123 undefined on input line 7216. LaTeX Warning: Hyper reference `Domain' on page 123 undefined on input line 721 9. [123] LaTeX Warning: Reference `ss:baseandcurrent' on page 124 undefined on input lin e 7237. LaTeX Warning: Hyper reference `FrameSet' on page 124 undefined on input line 7 238. LaTeX Warning: Hyper reference `Frame' on page 124 undefined on input line 7245 . LaTeX Warning: Hyper reference `Mapping' on page 124 undefined on input line 72 68. LaTeX Warning: Hyper reference `astGetFrame' on page 124 undefined on input lin e 7272. [124] LaTeX Warning: Reference `fig:fsremap' on page 125 undefined on input line 7293 . LaTeX Warning: Hyper reference `astRemapFrame' on page 125 undefined on input l ine 7304. LaTeX Warning: Hyper reference `astRemapFrame' on page 125 undefined on input l ine 7304. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 125 undefined on inp ut line 7312. LaTeX Warning: Hyper reference `astRemapFrame' on page 125 undefined on input l ine 7316. LaTeX Warning: Hyper reference `FrameSet' on page 125 undefined on input line 7 319. LaTeX Warning: Hyper reference `Mapping' on page 125 undefined on input line 73 23. LaTeX Warning: Hyper reference `WinMap' on page 125 undefined on input line 732 3. [125 <./sun211_figures/fsremap.pdf>] LaTeX Warning: Hyper reference `astWinMap' on page 126 undefined on input line 7344. LaTeX Warning: Hyper reference `Frame' on page 126 undefined on input line 7348 . LaTeX Warning: Hyper reference `FrameSet' on page 126 undefined on input line 7 368. LaTeX Warning: Hyper reference `Mapping' on page 126 undefined on input line 73 74. LaTeX Warning: Hyper reference `Frame' on page 126 undefined on input line 7390 . LaTeX Warning: Hyper reference `SkyFrame' on page 126 undefined on input line 7 391. LaTeX Warning: Hyper reference `Equinox' on page 126 undefined on input line 73 91. LaTeX Warning: Hyper reference `astSet' on page 126 undefined on input line 739 2. [126] LaTeX Warning: Hyper reference `astRemapFrame' on page 127 undefined on input l ine 7413. LaTeX Warning: Reference `ss:remapframe' on page 127 undefined on input line 74 13. LaTeX Warning: Hyper reference `UnitMap' on page 127 undefined on input line 74 29. LaTeX Warning: Hyper reference `astClear' on page 127 undefined on input line 7 457. LaTeX Warning: Hyper reference `astPermAxes' on page 127 undefined on input lin e 7457. LaTeX Warning: Reference `ss:permutingaxes' on page 127 undefined on input line 7458. LaTeX Warning: Hyper reference `FrameSet' on page 127 undefined on input line 7 481. LaTeX Warning: Reference `ss:addingframes' on page 127 undefined on input line 7482. LaTeX Warning: Reference `fig:fsmerge' on page 127 undefined on input line 7485 . LaTeX Warning: Hyper reference `astAddFrame' on page 127 undefined on input lin e 7496. LaTeX Warning: Hyper reference `Mapping' on page 127 undefined on input line 74 96. LaTeX Warning: Hyper reference `Frame' on page 127 undefined on input line 7496 . LaTeX Warning: Hyper reference `astAddFrame' on page 127 undefined on input lin e 7496. LaTeX Warning: Hyper reference `Mapping' on page 127 undefined on input line 74 96. LaTeX Warning: Hyper reference `Frame' on page 127 undefined on input line 7496 . [127] LaTeX Warning: Reference `ss:addingframes' on page 128 undefined on input line 7505. LaTeX Warning: Reference `fig:fsmerge' on page 128 undefined on input line 7511 . [128 <./sun211_figures/fsmerge.pdf>] [129] [130] LaTeX Warning: Hyper reference `Object' on page 131 undefined on input line 754 3. LaTeX Warning: Hyper reference `Channel' on page 131 undefined on input line 75 58. LaTeX Warning: Hyper reference `XmlChan' on page 131 undefined on input line 75 60. LaTeX Warning: Reference `ss:xmlchan' on page 131 undefined on input line 7561. LaTeX Warning: Hyper reference `FitsChan' on page 131 undefined on input line 7 561. LaTeX Warning: Reference `ss:nativefits' on page 131 undefined on input line 75 61. LaTeX Warning: Hyper reference `Channel' on page 131 undefined on input line 75 65. LaTeX Warning: Reference `ss:creatingachannel' on page 131 undefined on input l ine 7576. LaTeX Warning: Hyper reference `Channel' on page 131 undefined on input line 75 80. LaTeX Warning: Hyper reference `astChannel' on page 131 undefined on input line 7581. LaTeX Warning: Reference `ss:channelsource' on page 131 undefined on input line 7597. LaTeX Warning: Reference `ss:channelsink' on page 131 undefined on input line 7 597. LaTeX Warning: Hyper reference `SinkFile' on page 131 undefined on input line 7 606. LaTeX Warning: Hyper reference `SourceFile' on page 131 undefined on input line 7606. [131] LaTeX Warning: Hyper reference `Object' on page 132 undefined on input line 761 3. LaTeX Warning: Hyper reference `Channel' on page 132 undefined on input line 76 13. LaTeX Warning: Hyper reference `astWrite' on page 132 undefined on input line 7 613. LaTeX Warning: Reference `ss:foreignfitslimitations' on page 132 undefined on i nput line 7638. LaTeX Warning: Reference `ss:writingtoachannel' on page 132 undefined on input line 7644. LaTeX Warning: Hyper reference `Object' on page 132 undefined on input line 764 5. LaTeX Warning: Hyper reference `SinkFile' on page 132 undefined on input line 7 647. LaTeX Warning: Hyper reference `astRead' on page 132 undefined on input line 76 57. LaTeX Warning: Hyper reference `Channel' on page 132 undefined on input line 76 58. LaTeX Warning: Hyper reference `Channel' on page 132 undefined on input line 76 84. LaTeX Warning: Hyper reference `Object' on page 132 undefined on input line 768 5. [132] LaTeX Warning: Hyper reference `astRead' on page 133 undefined on input line 76 96. LaTeX Warning: Hyper reference `astRead' on page 133 undefined on input line 77 01. LaTeX Warning: Reference `ss:readingfromachannel' on page 133 undefined on inpu t line 7701. LaTeX Warning: Hyper reference `Object' on page 133 undefined on input line 770 2. LaTeX Warning: Hyper reference `Frame' on page 133 undefined on input line 7704 . LaTeX Warning: Hyper reference `astIsA$<$Class$>$' on page 133 undefined on inp ut line 7705. LaTeX Warning: Hyper reference `SkyFrame' on page 133 undefined on input line 7 718. LaTeX Warning: Hyper reference `Class' on page 133 undefined on input line 7719 . LaTeX Warning: Hyper reference `Class' on page 133 undefined on input line 7738 . LaTeX Warning: Reference `ss:validatinginput' on page 133 undefined on input li ne 7740. LaTeX Warning: Hyper reference `Object' on page 133 undefined on input line 774 6. LaTeX Warning: Hyper reference `ID' on page 133 undefined on input line 7746. LaTeX Warning: Hyper reference `Ident' on page 133 undefined on input line 7746 . [133] LaTeX Warning: Hyper reference `Object' on page 134 undefined on input line 778 1. LaTeX Warning: Hyper reference `Channel' on page 134 undefined on input line 77 81. LaTeX Warning: Reference `ss:writingtoachannel' on page 134 undefined on input line 7782. LaTeX Warning: Hyper reference `SkyFrame' on page 134 undefined on input line 7 783. LaTeX Warning: Hyper reference `astShow' on page 134 undefined on input line 78 25. LaTeX Warning: Reference `ss:displayingobjects' on page 134 undefined on input line 7825. [134] LaTeX Warning: Hyper reference `astRead' on page 135 undefined on input line 78 38. LaTeX Warning: Reference `ss:classhierarchy' on page 135 undefined on input lin e 7860. LaTeX Warning: Hyper reference `Frame' on page 135 undefined on input line 7860 . LaTeX Warning: Hyper reference `astWrite' on page 135 undefined on input line 7 880. LaTeX Warning: Reference `ss:writingtoachannel' on page 135 undefined on input line 7881. LaTeX Warning: Hyper reference `Channel' on page 135 undefined on input line 78 81. LaTeX Warning: Hyper reference `Full' on page 135 undefined on input line 7885. LaTeX Warning: Reference `ss:textualoutputformat' on page 135 undefined on inpu t line 7888. [135] LaTeX Warning: Hyper reference `Object' on page 136 undefined on input line 792 2. LaTeX Warning: Hyper reference `SkyFrame' on page 136 undefined on input line 7 925. [136] LaTeX Warning: Hyper reference `Channel' on page 137 undefined on input line 80 05. LaTeX Warning: Hyper reference `Comment' on page 137 undefined on input line 80 06. [137] LaTeX Warning: Hyper reference `astWrite' on page 138 undefined on input line 8 040. LaTeX Warning: Hyper reference `astShow' on page 138 undefined on input line 80 41. LaTeX Warning: Hyper reference `Object' on page 138 undefined on input line 804 4. LaTeX Warning: Hyper reference `astRead' on page 138 undefined on input line 80 52. LaTeX Warning: Hyper reference `Frame' on page 138 undefined on input line 8071 . LaTeX Warning: Hyper reference `astRead' on page 138 undefined on input line 80 83. LaTeX Warning: Hyper reference `Channel' on page 138 undefined on input line 80 83. LaTeX Warning: Reference `ss:readingfromachannel' on page 138 undefined on inpu t line 8084. LaTeX Warning: Hyper reference `Object' on page 138 undefined on input line 808 7. [138] LaTeX Warning: Hyper reference `Skip' on page 139 undefined on input line 8094. LaTeX Warning: Hyper reference `astShow' on page 139 undefined on input line 81 02. LaTeX Warning: Hyper reference `Channel' on page 139 undefined on input line 81 24. LaTeX Warning: Hyper reference `SinkFile' on page 139 undefined on input line 8 129. LaTeX Warning: Hyper reference `SourceFile' on page 139 undefined on input line 8129. [139] LaTeX Warning: Hyper reference `astChannel' on page 140 undefined on input line 8160. LaTeX Warning: Reference `ss:creatingachannel' on page 140 undefined on input l ine 8161. LaTeX Warning: Hyper reference `Object' on page 140 undefined on input line 820 5. LaTeX Warning: Hyper reference `astRead' on page 140 undefined on input line 82 05. LaTeX Warning: Hyper reference `SinkFile' on page 140 undefined on input line 8 216. LaTeX Warning: Hyper reference `Channel' on page 140 undefined on input line 82 16. [140] LaTeX Warning: Reference `ss:channelsource' on page 141 undefined on input line 8238. LaTeX Warning: Hyper reference `astChannel' on page 141 undefined on input line 8253. LaTeX Warning: Hyper reference `astSetStatus' on page 141 undefined on input li ne 8283. LaTeX Warning: Reference `ss:errordetection' on page 141 undefined on input lin e 8283. LaTeX Warning: Hyper reference `astWrite' on page 141 undefined on input line 8 287. LaTeX Warning: Reference `ss:channelsource' on page 141 undefined on input line 8292. LaTeX Warning: Reference `ss:channelsink' on page 141 undefined on input line 8 293. LaTeX Warning: Hyper reference `Channel' on page 141 undefined on input line 82 93. [141] [142] LaTeX Warning: Hyper reference `System' on page 143 undefined on input line 831 3. LaTeX Warning: Hyper reference `Channel' on page 143 undefined on input line 83 30. LaTeX Warning: Hyper reference `FitsChan' on page 143 undefined on input line 8 330. LaTeX Warning: Reference `ss:channels' on page 143 undefined on input line 8333 . LaTeX Warning: Reference `ss:foreignfits' on page 143 undefined on input line 8 334. LaTeX Warning: Reference `ss:foreignfits' on page 143 undefined on input line 8 351. LaTeX Warning: Hyper reference `Channel' on page 143 undefined on input line 83 60. LaTeX Warning: Reference `ss:channels' on page 143 undefined on input line 8361 . LaTeX Warning: Hyper reference `Channel' on page 143 undefined on input line 83 68. LaTeX Warning: Hyper reference `FitsChan' on page 143 undefined on input line 8 368. LaTeX Warning: Hyper reference `astPutFits' on page 143 undefined on input line 8377. LaTeX Warning: Reference `ss:addingfitscards' on page 143 undefined on input li ne 8378. [143] LaTeX Warning: Hyper reference `astPutCards' on page 144 undefined on input lin e 8381. LaTeX Warning: Reference `ss:addingmulticards' on page 144 undefined on input l ine 8382. LaTeX Warning: Hyper reference `Object' on page 144 undefined on input line 838 4. LaTeX Warning: Hyper reference `astWrite' on page 144 undefined on input line 8 384. LaTeX Warning: Reference `ss:writingnativefits' on page 144 undefined on input line 8386. LaTeX Warning: Hyper reference `SourceFile' on page 144 undefined on input line 8388. LaTeX Warning: Hyper reference `astSet' on page 144 undefined on input line 839 1. LaTeX Warning: Reference `ss:channelsource' on page 144 undefined on input line 8397. LaTeX Warning: Reference `ss:fitssourceandsink' on page 144 undefined on input line 8399. LaTeX Warning: Hyper reference `astDelFits' on page 144 undefined on input line 8405. LaTeX Warning: Reference `ss:findingandchangingfits' on page 144 undefined on i nput line 8406. LaTeX Warning: Hyper reference `astRead' on page 144 undefined on input line 84 08. LaTeX Warning: Reference `ss:readingnativefits' on page 144 undefined on input line 8410. LaTeX Warning: Hyper reference `SinkFile' on page 144 undefined on input line 8 412. LaTeX Warning: Reference `ss:channelsink' on page 144 undefined on input line 8 418. LaTeX Warning: Reference `ss:fitssourceandsink' on page 144 undefined on input line 8420. LaTeX Warning: Reference `ss:destructiveread' on page 144 undefined on input li ne 8427. LaTeX Warning: Hyper reference `astFindFits' on page 144 undefined on input lin e 8430. LaTeX Warning: Reference `ss:findingandchangingfits' on page 144 undefined on i nput line 8435. LaTeX Warning: Hyper reference `FitsChan' on page 144 undefined on input line 8 439. LaTeX Warning: Hyper reference `astFitsChan' on page 144 undefined on input lin e 8439. [144] LaTeX Warning: Hyper reference `Encoding' on page 145 undefined on input line 8 455. LaTeX Warning: Reference `ss:nativeencoding' on page 145 undefined on input lin e 8457. LaTeX Warning: Hyper reference `FitsChan' on page 145 undefined on input line 8 465. LaTeX Warning: Hyper reference `Card' on page 145 undefined on input line 8470. LaTeX Warning: Hyper reference `Ncard' on page 145 undefined on input line 8500 . LaTeX Warning: Hyper reference `astFindFits' on page 145 undefined on input lin e 8520. LaTeX Warning: Reference `ss:extractingfitscards' on page 145 undefined on inpu t line 8521. LaTeX Warning: Reference `ss:findingandchangingfits' on page 145 undefined on i nput line 8522. [145] LaTeX Warning: Hyper reference `FitsChan' on page 146 undefined on input line 8 532. LaTeX Warning: Reference `ss:creatingafitschan' on page 146 undefined on input line 8532. LaTeX Warning: Hyper reference `Object' on page 146 undefined on input line 853 3. LaTeX Warning: Hyper reference `astWrite' on page 146 undefined on input line 8 534. LaTeX Warning: Hyper reference `SkyFrame' on page 146 undefined on input line 8 535. LaTeX Warning: Hyper reference `FrameSet' on page 146 undefined on input line 8 537. LaTeX Warning: Reference `ss:nativeencoding' on page 146 undefined on input lin e 8551. LaTeX Warning: Hyper reference `Channel' on page 146 undefined on input line 85 53. LaTeX Warning: Reference `ss:writingtoachannel' on page 146 undefined on input line 8554. LaTeX Warning: Hyper reference `Ncard' on page 146 undefined on input line 8558 . LaTeX Warning: Hyper reference `Card' on page 146 undefined on input line 8559. LaTeX Warning: Reference `ss:addressingfitscards' on page 146 undefined on inpu t line 8563. LaTeX Warning: Hyper reference `Frame' on page 146 undefined on input line 8568 . LaTeX Warning: Hyper reference `astPutFits' on page 146 undefined on input line 8579. LaTeX Warning: Hyper reference `astPutCards' on page 146 undefined on input lin e 8579. LaTeX Warning: Hyper reference `FitsChan' on page 146 undefined on input line 8 584. LaTeX Warning: Hyper reference `SkyFrame' on page 146 undefined on input line 8 584. LaTeX Warning: Reference `ss:writingnativefits' on page 146 undefined on input line 8585. LaTeX Warning: Hyper reference `astClear' on page 146 undefined on input line 8 587. [146] LaTeX Warning: Hyper reference `astFindFits' on page 147 undefined on input lin e 8602. LaTeX Warning: Hyper reference `Card' on page 147 undefined on input line 8605. LaTeX Warning: Reference `ss:fitssourceandsink' on page 147 undefined on input line 8614. LaTeX Warning: Hyper reference `SkyFrame' on page 147 undefined on input line 8 618. LaTeX Warning: Reference `ss:writingnativefits' on page 147 undefined on input line 8619. LaTeX Warning: Hyper reference `Channel' on page 147 undefined on input line 86 46. LaTeX Warning: Reference `ss:textualoutputformat' on page 147 undefined on inpu t line 8647. LaTeX Warning: Hyper reference `Full' on page 147 undefined on input line 8654. LaTeX Warning: Hyper reference `FitsChan' on page 147 undefined on input line 8 655. LaTeX Warning: Reference `ss:controllingchanneloutput' on page 147 undefined on input line 8656. [147] LaTeX Warning: Hyper reference `astWrite' on page 148 undefined on input line 8 674. LaTeX Warning: Hyper reference `Comment' on page 148 undefined on input line 86 87. LaTeX Warning: Reference `ss:channelcommenting' on page 148 undefined on input line 8688. LaTeX Warning: Hyper reference `FitsChan' on page 148 undefined on input line 8 693. LaTeX Warning: Hyper reference `astPutFits' on page 148 undefined on input line 8694. LaTeX Warning: Hyper reference `Card' on page 148 undefined on input line 8707. LaTeX Warning: Hyper reference `FitsChan' on page 148 undefined on input line 8 738. LaTeX Warning: Hyper reference `astPutCards' on page 148 undefined on input lin e 8739. LaTeX Warning: Hyper reference `astRead' on page 148 undefined on input line 87 43. LaTeX Warning: Hyper reference `astPutFits' on page 148 undefined on input line 8745. LaTeX Warning: Reference `ss:addingfitscards' on page 148 undefined on input li ne 8747. [148] LaTeX Warning: Hyper reference `Object' on page 149 undefined on input line 877 2. LaTeX Warning: Hyper reference `FitsChan' on page 149 undefined on input line 8 773. LaTeX Warning: Reference `ss:writingnativefits' on page 149 undefined on input line 8773. LaTeX Warning: Hyper reference `astRead' on page 149 undefined on input line 87 74. LaTeX Warning: Hyper reference `Channel' on page 149 undefined on input line 87 75. LaTeX Warning: Reference `ss:readingfromachannel' on page 149 undefined on inpu t line 8775. LaTeX Warning: Reference `ss:validatinginput' on page 149 undefined on input li ne 8777. LaTeX Warning: Hyper reference `astCopy' on page 149 undefined on input line 87 98. LaTeX Warning: Reference `ss:copyingobjects' on page 149 undefined on input lin e 8799. LaTeX Warning: Hyper reference `Card' on page 149 undefined on input line 8802. LaTeX Warning: Hyper reference `astWrite' on page 149 undefined on input line 8 809. LaTeX Warning: Hyper reference `FitsChan' on page 149 undefined on input line 8 817. LaTeX Warning: Hyper reference `Card' on page 149 undefined on input line 8818. LaTeX Warning: Hyper reference `Object' on page 149 undefined on input line 881 9. [149] LaTeX Warning: Reference `ss:readingnativefits' on page 150 undefined on input line 8823. LaTeX Warning: Hyper reference `Object' on page 150 undefined on input line 883 8. LaTeX Warning: Hyper reference `Skip' on page 150 undefined on input line 8842. LaTeX Warning: Hyper reference `FitsChan' on page 150 undefined on input line 8 842. LaTeX Warning: Hyper reference `Channel' on page 150 undefined on input line 88 50. LaTeX Warning: Reference `ss:mixingchanneltext' on page 150 undefined on input line 8850. LaTeX Warning: Hyper reference `FitsChan' on page 150 undefined on input line 8 855. LaTeX Warning: Hyper reference `astFindFits' on page 150 undefined on input lin e 8856. LaTeX Warning: Hyper reference `Card' on page 150 undefined on input line 8861. LaTeX Warning: Hyper reference `astPutFits' on page 150 undefined on input line 8886. [150] LaTeX Warning: Hyper reference `astDelFits' on page 151 undefined on input line 8892. LaTeX Warning: Reference `ss:functiondescriptions' on page 151 undefined on inp ut line 8917. LaTeX Warning: Hyper reference `FitsChan' on page 151 undefined on input line 8 921. LaTeX Warning: Reference `ss:addingfitscards' on page 151 undefined on input li ne 8923. LaTeX Warning: Reference `ss:addingmulticards' on page 151 undefined on input l ine 8923. LaTeX Warning: Reference `ss:extractingfitscards' on page 151 undefined on inpu t line 8926. LaTeX Warning: Hyper reference `Channel' on page 151 undefined on input line 89 29. LaTeX Warning: Reference `ss:channelsource' on page 151 undefined on input line 8929. LaTeX Warning: Reference `ss:channelsink' on page 151 undefined on input line 8 930. LaTeX Warning: Hyper reference `astFitsChan' on page 151 undefined on input lin e 8931. LaTeX Warning: Reference `ss:creatingafitschan' on page 151 undefined on input line 8932. LaTeX Warning: Reference `ss:channelsource' on page 151 undefined on input line 8942. LaTeX Warning: Reference `ss:channelsink' on page 151 undefined on input line 8 943. [151] [152] LaTeX Warning: Reference `ss:nativefits' on page 153 undefined on input line 89 54. LaTeX Warning: Hyper reference `Object' on page 153 undefined on input line 895 5. LaTeX Warning: Hyper reference `FitsChan' on page 153 undefined on input line 8 956. LaTeX Warning: Hyper reference `Encoding' on page 153 undefined on input line 8 956. LaTeX Warning: Reference `ss:nativeencoding' on page 153 undefined on input lin e 8969. LaTeX Warning: Hyper reference `Encoding' on page 153 undefined on input line 8 976. LaTeX Warning: Hyper reference `FitsChan' on page 153 undefined on input line 8 976. LaTeX Warning: Reference `ss:fitswcscoverage' on page 153 undefined on input li ne 9009. [153] LaTeX Warning: Reference `ss:attributedescriptions' on page 154 undefined on in put line 9050. LaTeX Warning: Reference `ss:nativefits' on page 154 undefined on input line 90 56. LaTeX Warning: Hyper reference `Object' on page 154 undefined on input line 905 9. LaTeX Warning: Hyper reference `FrameSet' on page 154 undefined on input line 9 059. LaTeX Warning: Reference `ss:baseandcurrent' on page 154 undefined on input lin e 9064. LaTeX Warning: Hyper reference `Frame' on page 154 undefined on input line 9068 . LaTeX Warning: Hyper reference `FitsChan' on page 154 undefined on input line 9 076. [154] LaTeX Warning: Hyper reference `Encoding' on page 155 undefined on input line 9 088. LaTeX Warning: Reference `ss:attributedescriptions' on page 155 undefined on in put line 9089. [155] LaTeX Warning: Hyper reference `FitsChan' on page 156 undefined on input line 9 152. LaTeX Warning: Hyper reference `Encoding' on page 156 undefined on input line 9 172. LaTeX Warning: Reference `ss:creatingafitschan' on page 156 undefined on input line 9173. LaTeX Warning: Reference `ss:attributedescriptions' on page 156 undefined on in put line 9180. LaTeX Warning: Reference `ss:readingforeignfits' on page 156 undefined on input line 9214. LaTeX Warning: Hyper reference `FitsChan' on page 156 undefined on input line 9 222. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 156 undefined on input line 9224. LaTeX Warning: Hyper reference `Object' on page 156 undefined on input line 922 5. LaTeX Warning: Hyper reference `astRead' on page 156 undefined on input line 92 25. LaTeX Warning: Hyper reference `Card' on page 156 undefined on input line 9226. [156] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 157 undefined on input line 9243. LaTeX Warning: Reference `ss:validatinginput' on page 157 undefined on input li ne 9246. LaTeX Warning: Hyper reference `FrameSet' on page 157 undefined on input line 9 259. LaTeX Warning: Reference `ss:foreignfitslimitations' on page 157 undefined on i nput line 9259. LaTeX Warning: Reference `ss:nativeencoding' on page 157 undefined on input lin e 9261. LaTeX Warning: Hyper reference `Encoding' on page 157 undefined on input line 9 262. LaTeX Warning: Hyper reference `astShow' on page 157 undefined on input line 92 66. LaTeX Warning: Reference `ss:displayingobjects' on page 157 undefined on input line 9266. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 157 undefined on input line 9268. LaTeX Warning: Hyper reference `Frame' on page 157 undefined on input line 9269 . LaTeX Warning: Hyper reference `SkyFrame' on page 157 undefined on input line 9 270. LaTeX Warning: Hyper reference `Mapping' on page 157 undefined on input line 92 71. LaTeX Warning: Hyper reference `CmpMap' on page 157 undefined on input line 927 1. LaTeX Warning: Reference `ss:framesetasmapping' on page 157 undefined on input line 9278. LaTeX Warning: Reference `ss:framesetasframe' on page 157 undefined on input li ne 9279. LaTeX Warning: Reference `ss:framesetasmapping' on page 157 undefined on input line 9285. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 157 undefined on inp ut line 9289. LaTeX Warning: Reference `ss:normalising' on page 157 undefined on input line 9 289. LaTeX Warning: Reference `ss:frameattributes' on page 157 undefined on input li ne 9292. LaTeX Warning: Reference `ss:frameaxisattributes' on page 157 undefined on inpu t line 9294. LaTeX Warning: Reference `ss:registeringimages' on page 157 undefined on input line 9297. LaTeX Warning: Hyper reference `Plot' on page 157 undefined on input line 9299. LaTeX Warning: Reference `ss:plots' on page 157 undefined on input line 9299. LaTeX Warning: Reference `fig:gridplot' on page 157 undefined on input line 930 1. [157] LaTeX Warning: Reference `ss:wcsprocessingexample' on page 158 undefined on inp ut line 9305. LaTeX Warning: Reference `ss:writingforeignfits' on page 158 undefined on input line 9307. LaTeX Warning: Hyper reference `FitsChan' on page 158 undefined on input line 9 316. LaTeX Warning: Hyper reference `FrameSet' on page 158 undefined on input line 9 317. LaTeX Warning: Reference `ss:readingforeignfits' on page 158 undefined on input line 9318. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 158 undefined on input line 9334. LaTeX Warning: Hyper reference `astRead' on page 158 undefined on input line 93 60. LaTeX Warning: Reference `ss:writingforeignfits' on page 158 undefined on input line 9363. [158] LaTeX Warning: Reference `ss:writingforeignfits' on page 159 undefined on input line 9376. LaTeX Warning: Hyper reference `FitsChan' on page 159 undefined on input line 9 408. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 159 undefined on input line 9409. LaTeX Warning: Hyper reference `Object' on page 159 undefined on input line 941 1. LaTeX Warning: Hyper reference `FrameSet' on page 159 undefined on input line 9 411. LaTeX Warning: Reference `ss:readingforeignfits' on page 159 undefined on input line 9412. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 159 undefined on inp ut line 9415. LaTeX Warning: Reference `ss:writingforeignfits' on page 159 undefined on input line 9418. LaTeX Warning: Reference `ss:writingforeignfits' on page 159 undefined on input line 9430. LaTeX Warning: Hyper reference `FrameSet' on page 159 undefined on input line 9 434. LaTeX Warning: Hyper reference `FitsChan' on page 159 undefined on input line 9 435. LaTeX Warning: Hyper reference `Encoding' on page 159 undefined on input line 9 437. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 159 undefined on input line 9438. LaTeX Warning: Reference `ss:destructiveread' on page 159 undefined on input li ne 9440. [159] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 160 undefined on input line 9448. LaTeX Warning: Hyper reference `Card' on page 160 undefined on input line 9449. LaTeX Warning: Hyper reference `astWrite' on page 160 undefined on input line 9 451. [160] [161] [162] LaTeX Warning: Hyper reference `XmlChan' on page 163 undefined on input line 95 48. LaTeX Warning: Hyper reference `Channel' on page 163 undefined on input line 95 48. LaTeX Warning: Hyper reference `Frame' on page 163 undefined on input line 9556 . LaTeX Warning: Hyper reference `Full' on page 163 undefined on input line 9556. LaTeX Warning: Hyper reference `Title' on page 163 undefined on input line 9609 . [163] Overfull \hbox (135.34566pt too wide) in paragraph at lines 9623--9626 []\T1/ppl/m/n/10.95 (-20) The outer-most XML el-e-ment of an AST ob-ject will s et the de-fault names-pace to [][]\T1/cmtt/m/n/10.95 http://www.starlink.ac.uk/ ast/xml/ LaTeX Warning: Hyper reference `Comment' on page 164 undefined on input line 96 30. LaTeX Warning: Hyper reference `Skip' on page 164 undefined on input line 9648. LaTeX Warning: Hyper reference `Object' on page 164 undefined on input line 965 0. LaTeX Warning: Hyper reference `XmlChan' on page 164 undefined on input line 96 56. LaTeX Warning: Reference `ss:stcschans' on page 164 undefined on input line 966 2. LaTeX Warning: Hyper reference `Object' on page 164 undefined on input line 967 0. LaTeX Warning: Hyper reference `Stc' on page 164 undefined on input line 9670. LaTeX Warning: Hyper reference `Region' on page 164 undefined on input line 967 1. LaTeX Warning: Hyper reference `StcSearchLocation' on page 164 undefined on inp ut line 9672. LaTeX Warning: Hyper reference `StcResourceProfile' on page 164 undefined on in put line 9672. LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 164 undefined on input line 9672. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 164 undefined on in put line 9673. LaTeX Warning: Hyper reference `XmlFormat' on page 164 undefined on input line 9674. [164] [165] [166] LaTeX Warning: Hyper reference `StcsChan' on page 167 undefined on input line 9 679. LaTeX Warning: Hyper reference `Region' on page 167 undefined on input line 968 6. LaTeX Warning: Reference `ss:classdescriptions' on page 167 undefined on input line 9688. [167] [168] LaTeX Warning: Hyper reference `Mapping' on page 169 undefined on input line 96 96. LaTeX Warning: Hyper reference `IntraMap' on page 169 undefined on input line 9 719. LaTeX Warning: Hyper reference `Mapping' on page 169 undefined on input line 97 24. LaTeX Warning: Hyper reference `IntraMap' on page 169 undefined on input line 9 724. LaTeX Warning: Hyper reference `CmpMap' on page 169 undefined on input line 973 3. LaTeX Warning: Reference `ss:cmpmaps' on page 169 undefined on input line 9733. LaTeX Warning: Reference `ss:invertingmappings' on page 169 undefined on input line 9734. LaTeX Warning: Reference `ss:gettingattributes' on page 169 undefined on input line 9735. LaTeX Warning: Reference `ss:framesets' on page 169 undefined on input line 973 6. LaTeX Warning: Hyper reference `Mapping' on page 169 undefined on input line 97 42. LaTeX Warning: Hyper reference `IntraMap' on page 169 undefined on input line 9 753. [169] LaTeX Warning: Hyper reference `IntraMap' on page 170 undefined on input line 9 778. LaTeX Warning: Hyper reference `astTranP' on page 170 undefined on input line 9 780. [170] LaTeX Warning: Reference `ss:badcoordinates' on page 171 undefined on input lin e 9833. LaTeX Warning: Hyper reference `Mapping' on page 171 undefined on input line 98 51. LaTeX Warning: Hyper reference `astSetStatus' on page 171 undefined on input li ne 9854. LaTeX Warning: Reference `ss:errordetection' on page 171 undefined on input lin e 9854. LaTeX Warning: Hyper reference `astIntraReg' on page 171 undefined on input lin e 9865. LaTeX Warning: Hyper reference `IntraMap' on page 171 undefined on input line 9 889. [171] LaTeX Warning: Hyper reference `Nin' on page 172 undefined on input line 9896. LaTeX Warning: Hyper reference `Nout' on page 172 undefined on input line 9896. LaTeX Warning: Reference `ss:variableintramapcoordinates' on page 172 undefined on input line 9901. LaTeX Warning: Reference `ss:restrictedintramaps' on page 172 undefined on inpu t line 9906. LaTeX Warning: Reference `ss:simplifyingintramaps' on page 172 undefined on inp ut line 9907. LaTeX Warning: Reference `ss:intramaplimitations' on page 172 undefined on inpu t line 9913. LaTeX Warning: Hyper reference `IntraMap' on page 172 undefined on input line 9 933. LaTeX Warning: Hyper reference `astIntraMap' on page 172 undefined on input lin e 9945. LaTeX Warning: Hyper reference `astIntraReg' on page 172 undefined on input lin e 9948. LaTeX Warning: Reference `ss:registeringintramaps' on page 172 undefined on inp ut line 9948. LaTeX Warning: Hyper reference `Nin' on page 172 undefined on input line 9960. LaTeX Warning: Hyper reference `Nout' on page 172 undefined on input line 9960. LaTeX Warning: Hyper reference `Mapping' on page 172 undefined on input line 99 66. LaTeX Warning: Reference `ss:settingattributes' on page 172 undefined on input line 9966. LaTeX Warning: Reference `ss:intraflag' on page 172 undefined on input line 996 7. [172] LaTeX Warning: Hyper reference `IntraMap' on page 173 undefined on input line 9 972. LaTeX Warning: Hyper reference `astIntraReg' on page 173 undefined on input lin e 9997. LaTeX Warning: Reference `ss:transformationfunctions' on page 173 undefined on input line 10022. [173] LaTeX Warning: Hyper reference `IntraMap' on page 174 undefined on input line 1 0034. LaTeX Warning: Hyper reference `astIntraReg' on page 174 undefined on input lin e 10049. LaTeX Warning: Hyper reference `Nin' on page 174 undefined on input line 10050. LaTeX Warning: Hyper reference `Nout' on page 174 undefined on input line 10051 . LaTeX Warning: Hyper reference `IntraMap' on page 174 undefined on input line 1 0069. LaTeX Warning: Hyper reference `IntraFlag' on page 174 undefined on input line 10076. LaTeX Warning: Hyper reference `Mapping' on page 174 undefined on input line 10 104. [174] LaTeX Warning: Hyper reference `astSimplify' on page 175 undefined on input lin e 10112. LaTeX Warning: Reference `ss:simplifyingcmpmaps' on page 175 undefined on input line 10112. LaTeX Warning: Hyper reference `Mapping' on page 175 undefined on input line 10 118. LaTeX Warning: Hyper reference `UnitMap' on page 175 undefined on input line 10 119. [175] LaTeX Warning: Hyper reference `astIntraReg' on page 176 undefined on input lin e 10181. LaTeX Warning: Reference `ss:transformationfunctions' on page 176 undefined on input line 10201. LaTeX Warning: Reference `ss:transformationfunctions' on page 176 undefined on input line 10206. LaTeX Warning: Hyper reference `IntraMap' on page 176 undefined on input line 1 0218. LaTeX Warning: Hyper reference `IntraMap' on page 176 undefined on input line 1 0222. LaTeX Warning: Hyper reference `Channel' on page 176 undefined on input line 10 223. LaTeX Warning: Reference `ss:writingtoachannel' on page 176 undefined on input line 10223. LaTeX Warning: Reference `ss:readingfromachannel' on page 176 undefined on inpu t line 10232. [176] LaTeX Warning: Reference `ss:intramaplibrary' on page 177 undefined on input li ne 10248. LaTeX Warning: Reference `ss:intramaplimitations' on page 177 undefined on inpu t line 10251. LaTeX Warning: Hyper reference `astIntraReg' on page 177 undefined on input lin e 10266. LaTeX Warning: Hyper reference `Object' on page 177 undefined on input line 102 99. LaTeX Warning: Hyper reference `IntraMap' on page 177 undefined on input line 1 0300. LaTeX Warning: Reference `ss:readingandwritingintramaps' on page 177 undefined on input line 10301. [177] [178] LaTeX Warning: Hyper reference `Object' on page 179 undefined on input line 103 08. LaTeX Warning: Hyper reference `Plot' on page 179 undefined on input line 10308 . LaTeX Warning: Hyper reference `FrameSet' on page 179 undefined on input line 1 0309. LaTeX Warning: Hyper reference `Plot' on page 179 undefined on input line 10316 . LaTeX Warning: Hyper reference `FrameSet' on page 179 undefined on input line 1 0316. LaTeX Warning: Hyper reference `Frame' on page 179 undefined on input line 1031 7. LaTeX Warning: Hyper reference `Base' on page 179 undefined on input line 10317 . LaTeX Warning: Hyper reference `Mapping' on page 179 undefined on input line 10 329. LaTeX Warning: Hyper reference `astMark' on page 179 undefined on input line 10 360. [179] LaTeX Warning: Hyper reference `Plot' on page 180 undefined on input line 10387 . LaTeX Warning: Hyper reference `Frame' on page 180 undefined on input line 1039 5. LaTeX Warning: Hyper reference `astDistance' on page 180 undefined on input lin e 10397. LaTeX Warning: Hyper reference `astCurve' on page 180 undefined on input line 1 0400. LaTeX Warning: Hyper reference `astOffset' on page 180 undefined on input line 10413. LaTeX Warning: Reference `ss:distanceandoffset' on page 180 undefined on input line 10415. LaTeX Warning: Hyper reference `astPolyCurve' on page 180 undefined on input li ne 10419. LaTeX Warning: Hyper reference `Plot' on page 180 undefined on input line 10442 . LaTeX Warning: Hyper reference `astCurve' on page 180 undefined on input line 1 0445. LaTeX Warning: Hyper reference `astPolyCurve' on page 180 undefined on input li ne 10445. LaTeX Warning: Reference `ss:plottinggeodesics' on page 180 undefined on input line 10446. [180] LaTeX Warning: Hyper reference `astGridLine' on page 181 undefined on input lin e 10451. LaTeX Warning: Hyper reference `Plot' on page 181 undefined on input line 10470 . LaTeX Warning: Hyper reference `astGenCurve' on page 181 undefined on input lin e 10472. LaTeX Warning: Hyper reference `Mapping' on page 181 undefined on input line 10 474. LaTeX Warning: Hyper reference `Frame' on page 181 undefined on input line 1047 7. LaTeX Warning: Hyper reference `IntraMap' on page 181 undefined on input line 1 0486. LaTeX Warning: Hyper reference `Plot' on page 181 undefined on input line 10492 . LaTeX Warning: Hyper reference `Frame' on page 181 undefined on input line 1050 6. [181] LaTeX Warning: Hyper reference `astClip' on page 182 undefined on input line 10 514. LaTeX Warning: Hyper reference `Plot' on page 182 undefined on input line 10539 . LaTeX Warning: Hyper reference `FrameSet' on page 182 undefined on input line 1 0554. LaTeX Warning: Hyper reference `astClip' on page 182 undefined on input line 10 557. LaTeX Warning: Reference `ss:clipping' on page 182 undefined on input line 1055 7. LaTeX Warning: Hyper reference `Mapping' on page 182 undefined on input line 10 560. LaTeX Warning: Hyper reference `astGetMapping' on page 182 undefined on input l ine 10561. LaTeX Warning: Hyper reference `Plot' on page 182 undefined on input line 10566 . LaTeX Warning: Hyper reference `Frame' on page 182 undefined on input line 1056 6. LaTeX Warning: Hyper reference `Title' on page 182 undefined on input line 1056 7. LaTeX Warning: Hyper reference `FrameSet' on page 182 undefined on input line 1 0569. LaTeX Warning: Reference `ss:framesetasframe' on page 182 undefined on input li ne 10570. LaTeX Warning: Reference `ss:plottingagrid' on page 182 undefined on input line 10573. LaTeX Warning: Hyper reference `astDistance' on page 182 undefined on input lin e 10577. LaTeX Warning: Hyper reference `astOffset' on page 182 undefined on input line 10577. LaTeX Warning: Hyper reference `astFormat' on page 182 undefined on input line 10579. LaTeX Warning: Hyper reference `astNorm' on page 182 undefined on input line 10 579. [182] LaTeX Warning: Hyper reference `Plot' on page 183 undefined on input line 10584 . LaTeX Warning: Reference `ss:clipping' on page 183 undefined on input line 1058 7. LaTeX Warning: Reference `ss:badcoordinates' on page 183 undefined on input lin e 10589. LaTeX Warning: Hyper reference `astBorder' on page 183 undefined on input line 10608. LaTeX Warning: Hyper reference `Plot' on page 183 undefined on input line 10610 . LaTeX Warning: Reference `ss:validphysicalcoordinates' on page 183 undefined on input line 10612. LaTeX Warning: Hyper reference `Plot' on page 183 undefined on input line 10639 . [183] LaTeX Warning: Hyper reference `astText' on page 184 undefined on input line 10 647. LaTeX Warning: Reference `ss:escapes' on page 184 undefined on input line 10671 . LaTeX Warning: Hyper reference `astGrid' on page 184 undefined on input line 10 675. LaTeX Warning: Reference `fig:gridplot' on page 184 undefined on input line 106 78. LaTeX Warning: Hyper reference `Plot' on page 184 undefined on input line 10679 . LaTeX Warning: Hyper reference `Frame' on page 184 undefined on input line 1069 0. LaTeX Warning: Hyper reference `Title' on page 184 undefined on input line 1069 1. LaTeX Warning: Reference `ss:escapes' on page 184 undefined on input line 10694 . LaTeX Warning: Hyper reference `Plot' on page 184 undefined on input line 10697 . LaTeX Warning: Hyper reference `Escape' on page 184 undefined on input line 107 01. LaTeX Warning: Reference `ss:attributedescriptions' on page 184 undefined on in put line 10705. LaTeX Warning: Hyper reference `astText' on page 184 undefined on input line 10 716. [184] LaTeX Warning: Hyper reference `SkyAxis' on page 185 undefined on input line 10 718. LaTeX Warning: Hyper reference `Plot' on page 185 undefined on input line 10734 . LaTeX Warning: Hyper reference `Mapping' on page 185 undefined on input line 10 741. LaTeX Warning: Hyper reference `Frame' on page 185 undefined on input line 1074 1. LaTeX Warning: Hyper reference `FrameSet' on page 185 undefined on input line 1 0743. LaTeX Warning: Hyper reference `Plot' on page 185 undefined on input line 10781 . [185] LaTeX Warning: Hyper reference `ast_link' on page 186 undefined on input line 1 0800. LaTeX Warning: Reference `ss:howtobuild' on page 186 undefined on input line 10 801. LaTeX Warning: Reference `ss:commanddescriptions' on page 186 undefined on inpu t line 10801. LaTeX Warning: Hyper reference `astGrfSet' on page 186 undefined on input line 10807. [186] LaTeX Warning: Reference `ss:commanddescriptions' on page 187 undefined on inpu t line 10825. LaTeX Warning: Hyper reference `ast_link' on page 187 undefined on input line 1 0850. LaTeX Warning: Reference `ss:commanddescriptions' on page 187 undefined on inpu t line 10888. LaTeX Warning: Hyper reference `ast_link_adam' on page 187 undefined on input l ine 10897. [187] LaTeX Warning: Hyper reference `ast_link' on page 188 undefined on input line 1 0915. LaTeX Warning: Reference `ss:linking' on page 188 undefined on input line 10915 . LaTeX Warning: Reference `ss:commanddescriptions' on page 188 undefined on inpu t line 10918. [188] LaTeX Warning: Reference `ss:classdescriptions' on page 189 undefined on input line 10925. [189] [190] [191] LaTeX Warning: Hyper reference `Object' on page 192 undefined on input line 111 02. Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " LaTeX Warning: Hyper reference `Report' on page 192 undefined on input line 111 02. LaTeX Warning: Hyper reference `Zoom' on page 192 undefined on input line 11102 . Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the Report attribute for Object " map" to the value 1 a nd the Zoom LaTeX Warning: Hyper reference `Label(axis)' on page 192 undefined on input lin e 11102. Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the Label(axis) attribute for Object " frame" to a suit able string, where LaTeX Warning: Hyper reference `Title' on page 192 undefined on input line 1110 2. Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the Title attribute for Object " frame" to the contents of the string " LaTeX Font Warning: Font shape `OMS/cmtt/m/n' undefined (Font) using `OMS/cmsy/m/n' instead (Font) for symbol `textbullet' on input line 11102. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 White space may also surround attribute values, where it wi ll generally be ignored Overfull \hbox (5.09616pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [192] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 To include a literal comma in the value assigned to an attr ibute, the whole attribute Overfull \hbox (10.60732pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 value should be enclosed in quotation markes. Alternatively, yo u can use " %s" Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 format and supply the value as a separate additional argument t o astSet (or use Overfull \hbox (5.62103pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 The same procedure may be adopted if " %" signs are to be i ncluded and are not Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 to be interpreted as format specifiers (alternatively, the " pr intf" convention Overfull \hbox (33.43924pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [193] LaTeX Warning: Hyper reference `KeyMap' on page 194 undefined on input line 111 83. LaTeX Warning: Hyper reference `Object' on page 194 undefined on input line 111 83. LaTeX Warning: Hyper reference `FrameSet' on page 194 undefined on input line 1 1183. LaTeX Warning: Hyper reference `SkyFrame' on page 194 undefined on input line 1 1183. LaTeX Warning: Hyper reference `ZoomMap' on page 194 undefined on input line 11 183. Overfull \hbox (28.19052pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 If NULL, then the returned KeyMap will contain pointers ofr Obj ects of all classes. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 If not NULL, then " class" should be a pointer to a null-termin ated string holding Overfull \hbox (0.10988pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 the name of an AST class. The returned KeyMap will contain poin ters only for Overfull \hbox (5.3586pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A Boolean flag indicating if all subclasses of the class specif ied by " class" Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 should be included in the returned KeyMap. If zero, then subcla ss objects are Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 not returned. Otherwise they are returned. The supplied " subcl ass" value is LaTeX Warning: Hyper reference `astBegin' on page 194 undefined on input line 1 1183. LaTeX Warning: Hyper reference `astEnd' on page 194 undefined on input line 111 83. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A Boolean flag indicating if the returned list of pointers shou ld be restricted Overfull \hbox (28.19052pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 to pointers issued within the current AST object context (see a stBegin and astEnd). Underfull \hbox (badness 10000) in paragraph at lines 11183--11183 Overfull \hbox (12.49844pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A pointer to a new KeyMap holding the required object pointers. They KeyMap pointer Overfull \hbox (2.52588pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 should be annulled when it is no longer needed, but the object pointers within the Overfull \hbox (7.7746pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 KeyMap should not be annulled. A NULL pointer is returned if an error has occurred Overfull \hbox (2.26344pt too wide) in paragraph at lines 11183--11183 []\T1/cmtt/m/n/10 The values stored in the KeyMap should be accessed as generic C pointers using the Overfull \hbox (12.44437pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 This function will only return objects locked by the curren tly executing thread. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 The KeyMap pointer returned by this function is not include d in the list of active Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 Objects that were created using the Fortran interface will have a null " file" Overfull \hbox (10.60732pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 value and will have a routine name equal to the upper case Fort ran routine that [194] LaTeX Warning: Hyper reference `KeyMap' on page 195 undefined on input line 112 77. Overfull \hbox (5.52135pt too wide) in paragraph at lines 11277--11277 []\T1/cmtt/m/n/10 void astAddColumn( AstTable $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int type, int ndim, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 dims, LaTeX Warning: Hyper reference `Table' on page 195 undefined on input line 1127 7. Overfull \hbox (17.43065pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). Overfull \hbox (0.10988pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 The number of dimensions spanned by the values stored in a sing le cell of the Overfull \hbox (21.10475pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 An array holding the the lengths of each of the axes spanned by the values stored Overfull \hbox (21.10475pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 A string specifying the units of the column. Supply a blank str ing if the column LaTeX Warning: Hyper reference `Object' on page 195 undefined on input line 112 77. LaTeX Warning: Hyper reference `astMapPutU' on page 195 undefined on input line 11277. Overfull \hbox (41.62883pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 Tables can hold columns with any of the following data types - AST__INTTYPE (for integer), Overfull \hbox (36.38011pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 AST__SINTTYPE (for short int), AST__BYTETYPE (for unsigned byte s - i.e. unsigned chars), Overfull \hbox (49.5019pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 AST__DOUBLETYPE (for double precision floating point), AST__FLO ATTYPE (for single precision Overfull \hbox (34.01819pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 floating point), AST__STRINGTYPE (for character string), AST__O BJECTTYPE (for AST Object Overfull \hbox (18.27203pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 pointer), AST__POINTERTYPE (for arbitrary C pointer) or AST__UN DEFTYPE (for undefined LaTeX Warning: Hyper reference `FitsTable' on page 195 undefined on input line 11277. Overfull \hbox (12.76088pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 FitsTables can hold columns with any of the following data type s - AST__INTTYPE (for Overfull \hbox (49.76434pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 integer), AST__SINTTYPE (for short int), AST__BYTETYPE (for uns igned bytes - i.e. unsigned Overfull \hbox (2.26344pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 chars), AST__DOUBLETYPE (for double precision floating point), AST__FLOATTYPE (for Overfull \hbox (21.36719pt too wide) in paragraph at lines 11277--11277 [][]\T1/cmtt/m/n/10 This function returns without action if a column already ex ists in the Table with Overfull \hbox (0.37231pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 the supplied name and properties. However an error is reported if any of the [195] LaTeX Warning: Hyper reference `Frame' on page 196 undefined on input line 1139 5. LaTeX Warning: Hyper reference `Mapping' on page 196 undefined on input line 11 395. LaTeX Warning: Hyper reference `FrameSet' on page 196 undefined on input line 1 1395. Overfull \hbox (7.09596pt too wide) in paragraph at lines 11395--11395 []\T1/cmtt/m/n/10 void astAddFrame( AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, int iframe, AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame ) LaTeX Warning: Hyper reference `Nframe' on page 196 undefined on input line 113 95. Overfull \hbox (15.85603pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 The index of the Frame within the FrameSet which describes the coordinate system Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 upon which the new one is to be based. This value should lie in the range from Overfull \hbox (38.42552pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 1 to the number of Frames already in the FrameSet (as given by its Nframe attribute). Overfull \hbox (21.10475pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 As a special case, AST__ALLFRAMES may be supplied, in which cas e the axes defined Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by the supplied Frame are appended to every Frame in the FrameS et (see the Notes Overfull \hbox (52.8595pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Pointer to a Mapping which describes how to convert coordinates from the old coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 system (described by the Frame with index " iframe" ) into coor dinates in the Overfull \hbox (23.99155pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 new system. The Mapping' s forward transformation should perfor m this conversion, Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 and its inverse transformation should convert in the opposite d irection. The Overfull \hbox (1.94693pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 supplied Mapping is ignored if parameter " iframe" is equal to AST__ALLFRAMES. Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Pointer to a Frame that describes the new coordinate system. An y class of Frame Overfull \hbox (10.60732pt too wide) in paragraph at lines 11395--11395 []\T1/cmtt/m/n/10 This function may also be used to merge two FrameSets by supp lying a pointer to Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 Deep copies of the supplied " mapping" and " frame" objects are stored within Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 the modified FrameSet. So any changes made to the FrameSet afte r calling this Overfull \hbox (0.10988pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter LaTeX Warning: Hyper reference `Current' on page 196 undefined on input line 11 395. Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 This function sets the value of the Current attribute for t he FrameSet so that LaTeX Warning: Hyper reference `Nin' on page 196 undefined on input line 11395. LaTeX Warning: Hyper reference `Nout' on page 196 undefined on input line 11395 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 The number of input coordinate values accepted by the suppl ied Mapping (its Nin Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 attribute) must match the number of axes in the Frame identifie d by the " iframe" Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 parameter. Similarly, the number of output coordinate values ge nerated by this Overfull \hbox (23.99155pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 As a special case, if a pointer to a FrameSet is given for the " frame" parameter, Overfull \hbox (42.36206pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 this is treated as a request to merge a pair of FrameSets. This is done by appending Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 all the new Frames (in the " frame" FrameSet) to the original F rameSet, while Overfull \hbox (20.31744pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 preserving their order and retaining all the inter-relationship s (i.e. Mappings) Overfull \hbox (26.6159pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 between them. The two sets of Frames are inter-related within t he merged FrameSet Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by using the Mapping supplied. This should convert between the Frame identified Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by the " iframe" parameter (in the original FrameSet) and the c urrent Frame of Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 the " frame" FrameSet. This latter Frame becomes the current Fr ame in the merged [196] LaTeX Warning: Hyper reference `CmpFrame' on page 197 undefined on input line 1 1395. LaTeX Warning: Hyper reference `CmpMap' on page 197 undefined on input line 113 95. LaTeX Warning: Hyper reference `UnitMap' on page 197 undefined on input line 11 395. LaTeX Warning: Hyper reference `astSimplify' on page 197 undefined on input lin e 11395. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 As another special case, if a value of AST__ALLFRAMES is su pplied for parameter Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 " iframe" , then the supplied Mapping is ignored, and the axes defined by the Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 supplied Frame are appended to each Frame in the FrameSet. In d etail, each Frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 in the FrameSet is replaced by a CmpFrame containing the origin al Frame and the Overfull \hbox (26.6159pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Frame specified by parameter " frame" . In addition, each Mappi ng in the FrameSet Overfull \hbox (22.9418pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 is replaced by a CmpMap containing the original Mapping and a U nitMap in parallel. Overfull \hbox (5.3586pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 The Nin and Nout attributes of the UnitMap are set equal to the number of axes Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 in the supplied Frame. Each new CmpMap is simplified using astS implify before [197] LaTeX Warning: Hyper reference `KeyMap' on page 198 undefined on input line 114 31. LaTeX Warning: Hyper reference `Table' on page 198 undefined on input line 1143 1. Overfull \hbox (33.1768pt too wide) in paragraph at lines 11431--11431 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11431--11431 [][]\T1/cmtt/m/n/10 Unlike columns, the definition of a parameter does not spec ify its type, size [198] LaTeX Warning: Hyper reference `Mapping' on page 199 undefined on input line 11 491. LaTeX Warning: Hyper reference `Frame' on page 199 undefined on input line 1149 1. LaTeX Warning: Hyper reference `FrameSet' on page 199 undefined on input line 1 1491. LaTeX Warning: Hyper reference `Variant' on page 199 undefined on input line 11 491. Overfull \hbox (16.11847pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 Pointer to a Mapping which describes how to convert coordinates from the current Overfull \hbox (0.37231pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 Frame to the new variant of the current Frame. If NULL is suppl ied, then the Overfull \hbox (10.86975pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 name associated with the currently selected variant of the curr ent Frame is set Overfull \hbox (0.10988pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 The name to associate with the new variant Mapping (or the curr ently selected Overfull \hbox (10.86975pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 The newly added Variant becomes the current variant on exit (this is equivalent Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 An error is reported if a variant with the supplied name al ready exists in the LaTeX Warning: Hyper reference `astMirrorVariants' on page 199 undefined on inp ut line 11491. Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 An error is reported if the current Frame is a mirror for t he variant Mappings Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 in another Frame. This is only the case if the astMirrorVariant s function has [199] LaTeX Warning: Hyper reference `Frame' on page 200 undefined on input line 1155 8. LaTeX Warning: Hyper reference `SkyFrame' on page 200 undefined on input line 1 1558. Overfull \hbox (18.48322pt too wide) in paragraph at lines 11558--11558 []\T1/cmtt/m/n/10 double astAngle( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const double a[], const double b[], const double c[] LaTeX Warning: Hyper reference `Naxes' on page 200 undefined on input line 1155 8. Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (15.38524pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 The angle in radians, from the line AB to the line CB. If the F rame is 2-dimensional, Overfull \hbox (39.68927pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 it will be in the range $$\OMS/zplm/m/n/10 n$\T1/cmtt/m/n/10 pm $\OMS/zplm/m/n/10 n$\T1/cmtt/m/n/10 pi$, and positive rotation is in the same sense as rotation Overfull \hbox (2.52588pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 from the positive direction of axis 2 to the positive direction of axis 1. If the Overfull \hbox (23.52075pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 Frame has more than 2 axes, a positive value will always be ret urned in the range zero Overfull \hbox (10.60732pt too wide) in paragraph at lines 11558--11558 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if points A and B are co-incident, or Overfull \hbox (5.62103pt too wide) in paragraph at lines 11558--11558 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if this function is invoked with the [200] LaTeX Warning: Hyper reference `Object' on page 201 undefined on input line 116 15. LaTeX Warning: Hyper reference `RefCount' on page 201 undefined on input line 1 1615. LaTeX Warning: Hyper reference `astLock' on page 201 undefined on input line 11 615. Overfull \hbox (31.60219pt too wide) in paragraph at lines 11615--11615 [][]\T1/cmtt/m/n/10 This function will attempt to annul the pointer even if the Object is not currently Overfull \hbox (8.24539pt too wide) in paragraph at lines 11615--11615 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 11615--11615 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Overfull \hbox (13.49411pt too wide) in paragraph at lines 11615--11615 \T1/cmtt/m/n/10 circumstances. In particular, it will fail if the pointer suppl ed is not valid, [201] LaTeX Warning: Hyper reference `Frame' on page 202 undefined on input line 1168 2. LaTeX Warning: Hyper reference `Naxes' on page 202 undefined on input line 1168 2. Overfull \hbox (42.36206pt too wide) in paragraph at lines 11682--11682 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11682--11682 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (31.60219pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 The number of the Frame axis from which the angle is to be meas ured (axis numbering Overfull \hbox (12.76088pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 The angle in radians, from the positive direction of the specif ied axis, to the line Overfull \hbox (26.35948pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 AB. If the Frame is 2-dimensional, it will be in the range [-PI /2,$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 PI/2], and positive Overfull \hbox (2.52588pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 rotation is in the same sense as rotation from the positive dir ection of axis 2 to Overfull \hbox (23.52075pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 the positive direction of axis 1. If the Frame has more than 2 axes, a positive value LaTeX Warning: Hyper reference `astDistance' on page 202 undefined on input lin e 11682. Overfull \hbox (21.36719pt too wide) in paragraph at lines 11682--11682 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 11682--11682 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [202] LaTeX Warning: Hyper reference `Frame' on page 203 undefined on input line 1174 2. LaTeX Warning: Hyper reference `SkyFrame' on page 203 undefined on input line 1 1742. Overfull \hbox (0.10988pt too wide) in paragraph at lines 11742--11742 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has Overfull \hbox (5.62103pt too wide) in paragraph at lines 11742--11742 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 11742--11742 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [203] LaTeX Warning: Hyper reference `Frame' on page 204 undefined on input line 1181 6. LaTeX Warning: Hyper reference `SkyFrame' on page 204 undefined on input line 1 1816. Overfull \hbox (39.63802pt too wide) in paragraph at lines 11816--11816 []\T1/cmtt/m/n/10 void astAxNorm( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, int axis, int oper, int nval, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 values, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 status Overfull \hbox (0.10988pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has LaTeX Warning: Hyper reference `astNorm' on page 204 undefined on input line 11 816. Overfull \hbox (68.60565pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 Indicates the type of normalisation to be applied. If zero is s upplied, the normalisation Overfull \hbox (5.3586pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 will be the same as that performed by function astNorm. If 1 is supplied, the Overfull \hbox (0.37231pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 normalisation will be chosen automatically so that the resultin g list has the Overfull \hbox (37.11334pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 On entry, the axis values to be normalised. Modified on exit to hold the normalised Overfull \hbox (7.98578pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 If " oper" is 0, longitude values are returned in the range [0, 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 PI]. If " oper" is Overfull \hbox (18.22078pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 1, longitude values are returned in either the range [0,2$\OMS/ zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 PI] or [-PI,PI]. The choice Overfull \hbox (13.02332pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 is made so that that the resulting list has the smallest range. Latitude values are [204] LaTeX Warning: Hyper reference `Frame' on page 205 undefined on input line 1187 6. LaTeX Warning: Hyper reference `SkyFrame' on page 205 undefined on input line 1 1876. Overfull \hbox (0.10988pt too wide) in paragraph at lines 11876--11876 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has Overfull \hbox (5.62103pt too wide) in paragraph at lines 11876--11876 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 11876--11876 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [205] LaTeX Warning: Hyper reference `astEBuf' on page 206 undefined on input line 11 909. LaTeX Warning: Hyper reference `Plot' on page 206 undefined on input line 11909 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 11909--11909 [][]\T1/cmtt/m/n/10 The nature of the buffering is determined by the underlying graphics system (as Overfull \hbox (16.11847pt too wide) in paragraph at lines 11909--11909 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function to this function [206] LaTeX Warning: Hyper reference `Object' on page 207 undefined on input line 119 48. LaTeX Warning: Hyper reference `astEnd' on page 207 undefined on input line 119 48. LaTeX Warning: Hyper reference `astAnnul' on page 207 undefined on input line 1 1948. LaTeX Warning: Hyper reference `astExport' on page 207 undefined on input line 11948. LaTeX Warning: Hyper reference `astExempt' on page 207 undefined on input line 11948. LaTeX Warning: Hyper reference `RefCount' on page 207 undefined on input line 1 1948. [207] LaTeX Warning: Hyper reference `Plot' on page 208 undefined on input line 12012 . LaTeX Warning: Hyper reference `Plot3D' on page 208 undefined on input line 120 12. LaTeX Warning: Hyper reference `Frame' on page 208 undefined on input line 1201 2. Overfull \hbox (34.01819pt too wide) in paragraph at lines 12012--12012 \T1/cmtt/m/n/10 Zero is returned if the plotting space is completely filled by valid, unclipped physical Overfull \hbox (5.15024pt too wide) in paragraph at lines 12012--12012 \T1/cmtt/m/n/10 coordinates (so that only a rectangular box was drawn around th e edge). Otherwise, Overfull \hbox (10.60732pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (0.37231pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 An error results if either the current Frame or the base Fr ame of the Plot is LaTeX Warning: Hyper reference `TranForward' on page 208 undefined on input lin e 12012. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames [208] LaTeX Warning: Hyper reference `Plot' on page 209 undefined on input line 12057 . LaTeX Warning: Hyper reference `Frame' on page 209 undefined on input line 1205 7. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 A two element array in which is returned the lower limits of th e bounding box on Overfull \hbox (0.37231pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e Frame of the Overfull \hbox (15.85603pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 A two element array in which is returned the upper limits of th e bounding box on Overfull \hbox (0.37231pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e Frame of the [209] LaTeX Warning: Hyper reference `Box' on page 210 undefined on input line 12195. LaTeX Warning: Hyper reference `Region' on page 210 undefined on input line 121 95. LaTeX Warning: Hyper reference `Frame' on page 210 undefined on input line 1219 5. LaTeX Warning: Hyper reference `Interval' on page 210 undefined on input line 1 2195. LaTeX Warning: Hyper reference `SkyFrame' on page 210 undefined on input line 1 2195. LaTeX Warning: Hyper reference `Polygon' on page 210 undefined on input line 12 195. Overfull \hbox (31.55376pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 AstBox $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astBox( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double point1[], const double point2[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (16.11847pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 Indicates how the box is described by the remaining parameters. A value of zero Overfull \hbox (7.19565pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 indicates that the box is specified by a centre position and a corner position. Overfull \hbox (43.67424pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 A value of one indicates that the box is specified by a two opp osite corner positions. LaTeX Warning: Hyper reference `Naxes' on page 210 undefined on input line 1219 5. Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). If Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 " form" is zero, this array should contain the coordinates at t he centre of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 box. If " form" is one, it should contain the coordinates at th e corner of the Overfull \hbox (42.09962pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (47.34834pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 with the boundary of the Box being created. The uncertainty in any point on the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 boundary of the Box is found by shifting the supplied " uncerta inty" Region so Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 that it is centred at the boundary point being considered. The area covered by Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the shifted uncertainty Region then represents the uncertainty in the boundary LaTeX Warning: Hyper reference `Circle' on page 210 undefined on input line 121 95. LaTeX Warning: Hyper reference `Ellipse' on page 210 undefined on input line 12 195. LaTeX Warning: Hyper reference `Prism' on page 210 undefined on input line 1219 5. LaTeX Warning: Hyper reference `Object' on page 210 undefined on input line 121 95. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 will have no effect on the created Box. Alternatively, a NULL O bject pointer may Overfull \hbox (31.86462pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 be supplied, in which case a default uncertainty is used equiva lent to a box 1.0E-6 LaTeX Warning: Hyper reference `astOverlap' on page 210 undefined on input line 12195. LaTeX Warning: Hyper reference `astSimplify' on page 210 undefined on input lin e 12195. Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [210] LaTeX Warning: Hyper reference `astSet' on page 211 undefined on input line 121 95. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (0.10988pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Bo x. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [211] LaTeX Warning: Hyper reference `Channel' on page 212 undefined on input line 12 294. LaTeX Warning: Hyper reference `Object' on page 212 undefined on input line 122 94. LaTeX Warning: Hyper reference `astWrite' on page 212 undefined on input line 1 2294. LaTeX Warning: Hyper reference `astRead' on page 212 undefined on input line 12 294. LaTeX Warning: Hyper reference `SinkFile' on page 212 undefined on input line 1 2294. LaTeX Warning: Hyper reference `SourceFile' on page 212 undefined on input line 12294. Overfull \hbox (8.56807pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 AstChannel $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChannel( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/cm tt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink)( const char $\OMS/zplm/m/n/10 ^^C$ Overfull \hbox (0.37231pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (21.36719pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 this function will be used by the Channel to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 invocation, it should return a pointer to the next input line r ead from some external Overfull \hbox (16.11847pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 this function will be used by the Channel to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the LaTeX Warning: Hyper reference `astSet' on page 212 undefined on input line 122 94. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ch annel. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 12294--12294 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `astPutChannelData' on page 212 undefined on inp ut line 12294. LaTeX Warning: Hyper reference `astChannelData' on page 212 undefined on input line 12294. Overfull \hbox (26.6159pt too wide) in paragraph at lines 12294--12294 [][]\T1/cmtt/m/n/10 Application code can pass arbitrary data (such as file desc riptors, etc) to source Overfull \hbox (42.36206pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 and sink functions using the astPutChannelData function. The so urce or sink function [212] Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [213] LaTeX Warning: Hyper reference `Channel' on page 214 undefined on input line 12 336. LaTeX Warning: Hyper reference `astPutChannelData' on page 214 undefined on inp ut line 12336. Overfull \hbox (28.2446pt too wide) in paragraph at lines 12336--12336 \T1/cmtt/m/n/10 The pointer previously stored with the Channel using astPutChan nelData. A NULL pointer [214] LaTeX Warning: Hyper reference `ChebyMap' on page 215 undefined on input line 1 2402. Overfull \hbox (36.8509pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 A non-zero value indicates that the domain of the ChebyMap' s f orward transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 is to be returned, while a zero value indicates that the domain of the inverse Overfull \hbox (33.43924pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 Pointer to an array in which to return the lower axis bounds of the ChebyMap domain. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 The number of elements should be at least equal to the number o f ChebyMap inputs Overfull \hbox (33.43924pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 Pointer to an array in which to return the upper axis bounds of the ChebyMap domain. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 The number of elements should be at least equal to the number o f ChebyMap inputs LaTeX Warning: Hyper reference `astMapBox' on page 215 undefined on input line 12402. Overfull \hbox (26.6159pt too wide) in paragraph at lines 12402--12402 [][]\T1/cmtt/m/n/10 If the requested transformation is undefined (i.e. no trans formation coefficients Overfull \hbox (31.60219pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 were specified when the ChebyMap was created), this method retu rns a box determined Overfull \hbox (63.35693pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 using the astMapBox method on the opposite transformation, if t he opposite transformation Overfull \hbox (0.37231pt too wide) in paragraph at lines 12402--12402 [][]\T1/cmtt/m/n/10 If the above procedure fails to determine a bounding box, t he supplied arrays [215] LaTeX Warning: Hyper reference `ChebyMap' on page 216 undefined on input line 1 2615. LaTeX Warning: Hyper reference `Mapping' on page 216 undefined on input line 12 615. LaTeX Warning: Hyper reference `astPolyTran' on page 216 undefined on input lin e 12615. LaTeX Warning: Hyper reference `PolyMap' on page 216 undefined on input line 12 615. Overfull \hbox (23.4695pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 AstChebyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChebyMap ( int nin, int nout, int ncoeff_f, const double coeff_f[], int Overfull \hbox (18.27203pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ncoeff_i, const double coeff_i[], const double lbnd_f[], const double ubnd_f[], const Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the for ward transformation Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the ChebyMap. If zero is supplied, the forward transformatio n will be undefined. Overfull \hbox (17.02083pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing " ncoeff_f$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" Overfull \hbox (1.94693pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the forward transformation. Overfull \hbox (36.8509pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 Within each such group, the first element is the coefficient va lue; the next element Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 is the integer index of the ChebyMap output which uses the coef ficient within Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 its defining expression (the first output has index 1); the rem aining elements Overfull \hbox (37.11334pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the group give the integer powers to use with each input coo rdinate value (powers Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). [216] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 For instance, if the ChebyMap has 3 inputs and 2 outputs, eac h group consisting Overfull \hbox (37.11334pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of 5 elements, A groups such as " (1.2, 2.0, 1.0, 3.0, 0.0)" de scribes a coefficient Overfull \hbox (21.10475pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 with value 1.2 which is used within the definition of output 2. The output value Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 is incremented by the product of the coefficient value, the val ue of the Chebyshev Overfull \hbox (42.09962pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 polynomial of power 1 evaluated at input coordinate 1, and the value of the Chebyshev Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 polynomial of power 3 evaluated at input coordinate 2. Input co ordinate 3 is Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 not used since its power is specified as zero. As another examp le, the group Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 " (-1.0, 1.0, 0.0, 0.0, 0.0 )" adds a constant value -1.0 onto output 1 (it is Overfull \hbox (16.11847pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 Each final output coordinate value is the sum of the " ncoeff _f" terms described Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the inv erse transformation Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the ChebyMap. If zero is supplied, the inverse transformatio n will be undefined. Overfull \hbox (27.51826pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing " ncoeff_i$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" Overfull \hbox (2.99667pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the inverse transformation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 using the same schame as " coeff_f" , except that " inputs" and " outputs" are Overfull \hbox (26.6159pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the lower bounds of the input bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_f is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the upper bounds of the input bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_f is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (15.85603pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the lower bounds of the output bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_i is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (15.85603pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the upper bounds of the output bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_i is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain LaTeX Warning: Hyper reference `astSet' on page 217 undefined on input line 126 15. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ch ebyMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format [217] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 218 undefined on input line 126 15. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [218] LaTeX Warning: Hyper reference `Circle' on page 219 undefined on input line 127 38. LaTeX Warning: Hyper reference `Region' on page 219 undefined on input line 127 38. LaTeX Warning: Hyper reference `Frame' on page 219 undefined on input line 1273 8. Overfull \hbox (13.18324pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 AstCircle $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCircle( As tFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double cent re[], const double Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 Indicates how the circle is described by the remaining paramete rs. A value of Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 zero indicates that the circle is specified by a centre positio n and a position Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 on the circumference. A value of one indicates that the circle is specified by LaTeX Warning: Hyper reference `Naxes' on page 219 undefined on input line 1273 8. Overfull \hbox (42.09962pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 If " form" is zero, then this array should have one element for each Frame axis Overfull \hbox (10.34488pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 (Naxes attribute), and should be supplied holding the coordinat es at a point on Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the circumference of the circle or sphere. If " form" is one, t hen this array Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 should have one element only which should be supplied holding t he scalar radius Overfull \hbox (47.34834pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 with the boundary of the Circle being created. The uncertainty in any point on Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the boundary of the Circle is found by shifting the supplied " uncertainty" Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 so that it is centred at the boundary point being considered. T he area covered Overfull \hbox (21.10475pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 by the shifted uncertainty Region then represents the uncertain ty in the boundary LaTeX Warning: Hyper reference `Box' on page 219 undefined on input line 12738. LaTeX Warning: Hyper reference `Ellipse' on page 219 undefined on input line 12 738. LaTeX Warning: Hyper reference `Prism' on page 219 undefined on input line 1273 8. LaTeX Warning: Hyper reference `Object' on page 219 undefined on input line 127 38. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (15.5936pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 will have no effect on the created Circle. Alternatively, a NUL L Object pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box LaTeX Warning: Hyper reference `astOverlap' on page 219 undefined on input line 12738. LaTeX Warning: Hyper reference `astSimplify' on page 219 undefined on input lin e 12738. Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 219 undefined on input line 127 38. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ci rcle. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format [219] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [220] LaTeX Warning: Hyper reference `Circle' on page 221 undefined on input line 127 96. LaTeX Warning: Hyper reference `Region' on page 221 undefined on input line 127 96. Overfull \hbox (21.36719pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 Pointer to an array in which to return the coordinates of the C ircle centre. The Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 length of this array should be no less than the number of axes in the associated Overfull \hbox (37.11334pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 Returned holding the radius of the Circle, as an geodesic dista nce in the associated Overfull \hbox (47.61078pt too wide) in paragraph at lines 12796--12796 [] \T1/cmtt/m/n/10 Pointer to an array in which to return the coordinates of a point on the circumference Overfull \hbox (0.37231pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 of the Circle. The length of this array should be no less than the number of Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 axes in the associated coordinate system. A NULL pointer can be supplied if the Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Circle has been changed since it was Overfull \hbox (34.48898pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 first created, the returned parameters refer to the new (change d) coordinate system, Overfull \hbox (37.11334pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 rather than the original coordinate system. Note however that i f the transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 from original to new coordinate system is non-linear, the shape represented by [221] LaTeX Warning: Hyper reference `Object' on page 222 undefined on input line 128 49. LaTeX Warning: Hyper reference `astTest' on page 222 undefined on input line 12 849. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12849--12849 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (49.1854pt too wide) in paragraph at lines 12849--12849 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to clear the val ue of a read-only attribute. [222] Overfull \hbox (42.36206pt too wide) in paragraph at lines 12872--12872 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (0.10988pt too wide) in paragraph at lines 12872--12872 \T1/cmtt/m/n/10 will not execute and will simply return without action. Using a stClearStatus [223] LaTeX Warning: Hyper reference `Plot' on page 224 undefined on input line 12984 . LaTeX Warning: Hyper reference `Clip' on page 224 undefined on input line 12984 . Overfull \hbox (6.6736pt too wide) in paragraph at lines 12984--12984 []\T1/cmtt/m/n/10 void astClip( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, int iframe, const double lbnd[], const double ubnd[] ) LaTeX Warning: Hyper reference `Frame' on page 224 undefined on input line 1298 4. LaTeX Warning: Hyper reference `Nframe' on page 224 undefined on input line 129 84. Overfull \hbox (10.60732pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 The index of the Frame within the Plot to which the clipping li mits supplied in Overfull \hbox (37.11334pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 " lbnd" and " ubnd" (below) refer. Clipping may be applied to a ny of the coordinate Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 systems associated with a Plot (as defined by the Frames it con tains), so this Overfull \hbox (49.1854pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index may take any value from 1 to the number of Frames in the Plot (Nframe attribute). Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 In addition, the values AST__BASE and AST__CURRENT may be used to specify the Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 []\T1/cmtt/m/n/10 For example, a value of AST__CURRENT causes clipping to be pe rformed in physical Overfull \hbox (47.61078pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 coordinates, while a value of AST__BASE would clip in graphical coordinates. Clipping Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 may also be removed completely by giving a value of AST__NOFRAM E. In this case Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 An array with one element for each axis of the clipping Frame ( identified by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index " iframe" ). This should contain the lower bound, on each axis, of the Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 An array with one element for each axis of the clipping Frame ( identified by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index " iframe" ). This should contain the upper bound, on each axis, of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 Only one clipping Frame may be active at a time. This funct ion will deactivate Overfull \hbox (12.44437pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 any previously-established clipping Frame before setting up new clipping limits. LaTeX Warning: Hyper reference `astPlot' on page 224 undefined on input line 12 984. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 The clipping produced by this function is in addition to th at specified by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 Clip attribute which occurs at the edges of the plotting area e stablished when Overfull \hbox (26.6159pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the Plot is created (see astPlot). The underlying graphics syst em may also impose LaTeX Warning: Hyper reference `ClipOp' on page 224 undefined on input line 129 84. Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 When testing a graphical position for clipping, it is first transformed into the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 clipping Frame. The resulting coordinate on each axis is then c hecked against Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the clipping limits (given by " lbnd" and " ubnd" ). By default , a position is Overfull \hbox (26.6159pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 clipped if any coordinate lies outside these limits. However, i f a non-zero value Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 is assigned to the Plot' s ClipOp attribute, then a position is only clipped if Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 If the lower clipping limit exceeds the upper limit for any axis, then the sense Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 of clipping for that axis is reversed (so that coordinate value s lying between Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the limits are clipped instead of those lying outside the limit s). To produce Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 a " hole" in a coordinate space (that is, an internal region wh ere nothing is Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 plotted), you should supply all the bounds in reversed order, a nd set the ClipOp [224] Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 Either clipping limit may be set to the value AST__BAD, whi ch is equivalent to Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 setting it to infinity (or minus infinity for a lower bound) so that it is not Overfull \hbox (58.10822pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 If a graphical position results in any bad coordinate value s (AST__BAD) when transformed Overfull \hbox (37.11334pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 into the clipping Frame, then it is treated (for the purposes o f producing graphical LaTeX Warning: Hyper reference `Mapping' on page 225 undefined on input line 12 984. LaTeX Warning: Hyper reference `astTran2' on page 225 undefined on input line 1 2984. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 When a Plot is used as a Mapping to transform points (e.g. using astTran2), any [225] LaTeX Warning: Hyper reference `Object' on page 226 undefined on input line 130 32. LaTeX Warning: Hyper reference `RefCount' on page 226 undefined on input line 1 3032. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13032--13032 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [226] LaTeX Warning: Hyper reference `CmpFrame' on page 227 undefined on input line 1 3120. LaTeX Warning: Hyper reference `Frame' on page 227 undefined on input line 1312 0. LaTeX Warning: Hyper reference `Mapping' on page 227 undefined on input line 13 120. LaTeX Warning: Hyper reference `UnitMap' on page 227 undefined on input line 13 120. LaTeX Warning: Hyper reference `Region' on page 227 undefined on input line 131 20. Overfull \hbox (0.48381pt too wide) in paragraph at lines 13120--13120 []\T1/cmtt/m/n/10 AstCmpFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpFrame ( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame1, AstFrame $\OMS/zplm/m/ n/10 ^^C$\T1/cmtt/m/n/10 frame2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 options, LaTeX Warning: Hyper reference `astSet' on page 227 undefined on input line 131 20. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13120--13120 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 227 undefined on input line 131 20. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13120--13120 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 13120--13120 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [227] LaTeX Warning: Hyper reference `CmpMap' on page 228 undefined on input line 132 39. LaTeX Warning: Hyper reference `Mapping' on page 228 undefined on input line 13 239. Overfull \hbox (42.47356pt too wide) in paragraph at lines 13239--13239 []\T1/cmtt/m/n/10 AstCmpMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpMap( As tMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map1, AstMapping $\OMS/zplm/m/n/ 10 ^^C$\T1/cmtt/m/n/10 map2, int series, const char $\OMS/zplm/m/n/10 ^^C$\T1/c mtt/m/n/10 options, Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 If a non-zero value is given for this parameter, the two compon ent Mappings will Overfull \hbox (28.19052pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 be connected in series. A zero value requests that they are con nected in parallel. LaTeX Warning: Hyper reference `astSet' on page 228 undefined on input line 132 39. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 If the component Mappings are connected in series, then usi ng the resulting CmpMap Overfull \hbox (0.37231pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 to transform coordinates will cause the first Mapping to be app lied, followed Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 by the second Mapping. If the inverse CmpMap transformation is requested, the Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 two component Mappings will be applied in both the reverse orde r and the reverse LaTeX Warning: Hyper reference `Nout' on page 228 undefined on input line 13239 . LaTeX Warning: Hyper reference `Nin' on page 228 undefined on input line 13239. Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 When connecting two component Mappings in series, the numbe r of output coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 generated by the first Mapping (its Nout attribute) must equal the number of input Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 If the component Mappings of a CmpMap are connected in para llel, then the first Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 Mapping will be used to transform the earlier input coordinates for each point Overfull \hbox (5.09616pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 (and to produce the earlier output coordinates) and the second Mapping will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 used simultaneously to transform the remaining input coordinate s (to produce the Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 remaining output coordinates for each point). If the inverse tr ansformation is Overfull \hbox (0.37231pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 requested, each Mapping will still be applied to the same coord inates, but in [228] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 When connecting two component Mappings in parallel, there i s no restriction on LaTeX Warning: Hyper reference `astCopy' on page 229 undefined on input line 13 239. Overfull \hbox (5.3586pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astCmpMap (the new Overfull \hbox (0.10988pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 CmpMap simply retains a reference to them). They may continue t o be used for Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a CmpMap containi ng a copy of its Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 component Mappings is required, then a copy of the CmpMap shoul d be made using LaTeX Warning: Hyper reference `Object' on page 229 undefined on input line 132 39. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [229] LaTeX Warning: Hyper reference `CmpRegion' on page 230 undefined on input line 13353. LaTeX Warning: Hyper reference `Region' on page 230 undefined on input line 133 53. LaTeX Warning: Hyper reference `Frame' on page 230 undefined on input line 1335 3. LaTeX Warning: Hyper reference `astConvert' on page 230 undefined on input line 13353. LaTeX Warning: Hyper reference `Mapping' on page 230 undefined on input line 13 353. LaTeX Warning: Hyper reference `SkyFrame' on page 230 undefined on input line 1 3353. Overfull \hbox (8.1457pt too wide) in paragraph at lines 13353--13353 []\T1/cmtt/m/n/10 AstCmpRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpRegi on( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region1, AstRegion $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 region2, int oper, const Overfull \hbox (0.37231pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 Pointer to the second component Region. This Region will be tra nsformed into Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 the coordinate Frame of the first region before use. An error w ill be reported Overfull \hbox (0.10988pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 The boolean operator with which to combine the two Regions. Thi s must be one LaTeX Warning: Hyper reference `astSet' on page 230 undefined on input line 133 53. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pRegion. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [230] Overfull \hbox (5.3586pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 If one of the supplied Regions has an associated uncertaint y, that uncertainty Overfull \hbox (52.59706pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 will also be used for the returned CmpRegion. If both supplied Regions have associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 uncertainties, the uncertainty associated with the first Region will be used for Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no LaTeX Warning: Hyper reference `Object' on page 231 undefined on input line 133 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [231] LaTeX Warning: Hyper reference `Table' on page 232 undefined on input line 1341 4. LaTeX Warning: Hyper reference `Ncolumn' on page 232 undefined on input line 13 414. Overfull \hbox (21.10475pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 The index into the list of columns. The first column has index one, and the last Overfull \hbox (0.37231pt too wide) in paragraph at lines 13414--13414 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 13414--13414 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [232] LaTeX Warning: Hyper reference `FitsTable' on page 233 undefined on input line 13532. Overfull \hbox (8.19696pt too wide) in paragraph at lines 13532--13532 []\T1/cmtt/m/n/10 int astColumnNull( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int set , int newval, int LaTeX Warning: Hyper reference `Table' on page 233 undefined on input line 1353 2. Overfull \hbox (22.67937pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 [] \T1/cmtt/m/n/10 If non-zero, the value supplied for parameter " newval" w ill be stored as the Overfull \hbox (12.44437pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 current null value, replacing any value set by a previous call to this function. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 If zero, the value supplied for parameter " newval" is ignored and the current Overfull \hbox (21.10475pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The new null value to use. Ignored if " set" is zero. An error will be reported Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 if the supplied value is outside the range of values that can b e stored in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 Pointer to an int that will be returned non-zero if the returne d null value was Overfull \hbox (49.1854pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 set previously via an earlier invocation of this function. Zero is returned otherwise. Overfull \hbox (33.43924pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 If the named column does not exist, or an error occurs, a value of zero is returned. Overfull \hbox (16.11847pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 Pointer to an int that will be returned non-zero if and only if the named column Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 currently contains any values equal to the null value on exit ( i.e. " newval" Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 if " set" is non-zero, or the returned function value otherwise ), or contains Overfull \hbox (21.36719pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 any empty cells. If the named column does not exist, or an erro r occurs, a value Overfull \hbox (0.10988pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 of zero is returned. If a NULL pointer is supplied for " hasnul l" , no check Overfull \hbox (7.51216pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The null value that was in use on entry to this function. If a null value has been Overfull \hbox (2.52588pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 set by a previous invocation of this function, it will be retur ned. Otherwise, if Overfull \hbox (7.7746pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 " set" is non-zero, the supplied " newval" value is returned. O therwise, a default Overfull \hbox (12.76088pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 value is chosen (if possible) that does not currently occur in the named column. If Overfull \hbox (2.52588pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 all available values are in use in the column, an error is repo rted if and only if Overfull \hbox (23.52075pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 the column contains any empty cells. Otherwise, a value of zero is returned. A value [233] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 [][]\T1/cmtt/m/n/10 The FITS binary table definition allows only integer-valued columns to have an Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 associated null value. This routine will return without action if the column [234] LaTeX Warning: Hyper reference `Table' on page 235 undefined on input line 1359 7. LaTeX Warning: Hyper reference `astAddColumn' on page 235 undefined on input li ne 13597. Overfull \hbox (2.89699pt too wide) in paragraph at lines 13597--13597 []\T1/cmtt/m/n/10 void astColumnShape( AstTable $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int mxdim , int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ndim, int Overfull \hbox (15.85603pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces Overfull \hbox (10.86975pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 Pointer to an int in which to return the number of dimensions s panned by values Overfull \hbox (16.11847pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 Pointer to an array in which to return the length of each dimen sion. Any excess Overfull \hbox (12.44437pt too wide) in paragraph at lines 13597--13597 [][]\T1/cmtt/m/n/10 No error is reported if the requested column cannot be foun d in the given Table. Overfull \hbox (5.3586pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 A value of zero is returned for " ndim" and the supplied values in " dims" are [235] LaTeX Warning: Hyper reference `astGetColumnData' on page 236 undefined on inpu t line 13643. LaTeX Warning: Hyper reference `Table' on page 236 undefined on input line 1364 3. Overfull \hbox (22.67937pt too wide) in paragraph at lines 13643--13643 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Underfull \hbox (badness 10000) in paragraph at lines 13643--13643 LaTeX Warning: Hyper reference `astColumnNull' on page 236 undefined on input l ine 13643. LaTeX Warning: Hyper reference `FitsTable' on page 236 undefined on input line 13643. Overfull \hbox (1.94693pt too wide) in paragraph at lines 13643--13643 [][]\T1/cmtt/m/n/10 An error will be reported if the named column does not exis t in the FitsTable. [236] LaTeX Warning: Hyper reference `FrameSet' on page 237 undefined on input line 1 3940. LaTeX Warning: Hyper reference `Mapping' on page 237 undefined on input line 13 940. LaTeX Warning: Hyper reference `Frame' on page 237 undefined on input line 1394 0. LaTeX Warning: Hyper reference `Domain' on page 237 undefined on input line 139 40. Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Pointer to a Frame which represents the " source" coordinate sy stem. This is LaTeX Warning: Hyper reference `Current' on page 237 undefined on input line 13 940. LaTeX Warning: Hyper reference `Base' on page 237 undefined on input line 13940 . Overfull \hbox (25.56616pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is given, its current Frame (as determined by i ts Current attribute) Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is taken to describe the source coordinate system. Note that th e Base attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of this FrameSet may be modified by this function to indicate w hich intermediate Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system was used (see under " FrameSets" in the " App licability" section Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Pointer to a Frame which represents the " destination" co ordinate system. This Overfull \hbox (25.56616pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is given, its current Frame (as determined by i ts Current attribute) Overfull \hbox (42.36206pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is taken to describe the destination coordinate system. Note th at the Base attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of this FrameSet may be modified by this function to indicate w hich intermediate Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system was used (see under " FrameSets" in the " App licability" section Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of Frame domains. This may be used to define a priority order f or the different Overfull \hbox (57.84578pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The function will first try to obtain a conversion by making use only of an intermediate Overfull \hbox (7.19565pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system whose Domain attribute matches the first doma in in this list. Overfull \hbox (47.61078pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If this fails, the second domain in the list will be used, and so on, until conversion Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is achieved. A blank domain (e.g. two consecutive commas) indic ates that all Overfull \hbox (21.10475pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 This list is case-insensitive and all white space is ignored. If you do not wish Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to restrict the domain in this way, you should supply an empty string. This is Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 normally appropriate if either of the source or destination coo rdinate systems Overfull \hbox (21.10475pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are described by Frames (rather than FrameSets), since there is then usually only [237] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 238 undefined on input li ne 13940. LaTeX Warning: Hyper reference `AlignSideBand' on page 238 undefined on input l ine 13940. LaTeX Warning: Hyper reference `AlignSystem' on page 238 undefined on input lin e 13940. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 238 undefined on input line 13940. LaTeX Warning: Hyper reference `SideBand' on page 238 undefined on input line 1 3940. Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If the AlignSideBand attribute is non-zero, alignment occurs in the upper sideband Overfull \hbox (39.2669pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 expressed within the spectral system and standard of rest given by attributes AlignSystem Overfull \hbox (7.7746pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 and AlignStdOfRest. If AlignSideBand is zero, the two DSBSpecFr ames are aligned as Overfull \hbox (7.51216pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 This function applies to all Frames. Alignment occurs within th e coordinate system Overfull \hbox (34.01819pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If either of the " from" or " to" parameters is a pointer to a FrameSet, then astConvert Overfull \hbox (12.76088pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 will attempt to convert from the coordinate system described by the current Frame of Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 To achieve this, it will consider all of the Frames within ea ch FrameSet as a possible Overfull \hbox (19.58421pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 way of reaching an intermediate coordinate system that can be u sed for the conversion. Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 There is then the possibility that more than one conversion pat h may exist and, unless Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the choice is sufficiently restricted by the " domainlist" stri ng, the sequence in Overfull \hbox (54.75063pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 which the Frames are considered can be important. In this case, the search for a conversion LaTeX Warning: Hyper reference `Invert' on page 238 undefined on input line 139 40. Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 The Frames within each FrameSet are considered in a specifi c order: (1) the base Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame is always considered first, (2) after this come all the o ther Frames in Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame-index order (but omitting the base and current Frames), ( 3) the current Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame is always considered last. However, if either FrameSet' s Invert attribute Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is set to a non-zero value (so that the FrameSet is inverted), then its Frames Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are considered in reverse order. (Note that this still means th at the base Frame Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is considered first and the current Frame last, because the Inv ert value will Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 All source Frames are first considered (in the appropriate order) for conversion Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to the first destination Frame. If no suitable intermediate coo rdinate system Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 emerges, they are then considered again for conversion to the s econd destination LaTeX Warning: Hyper reference `TranForward' on page 238 undefined on input lin e 13940. LaTeX Warning: Hyper reference `TranInverse' on page 238 undefined on input lin e 13940. Overfull \hbox (39.7377pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 Generally, the first suitable intermediate coordinate syste m found is used. However, Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the overall Mapping between the source and destination coordina te systems is also Overfull \hbox (68.60565pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 examined. Preference is given to cases where both the forward a nd inverse transformations Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are defined (as indicated by the TranForward and TranInverse at tributes). If Overfull \hbox (42.36206pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 If the domain of the intermediate coordinate system matches the current " domainlist" Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 field, the conversion path is accepted. Otherwise, the next " d omainlist" field Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If conversion is possible, the Base attributes of the two Frame Sets will be modified Overfull \hbox (23.52075pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 on exit to identify the Frames used to access the intermediate coordinate system which Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that it is possible to force a particular Frame within a FrameSet to be used as Overfull \hbox (18.27203pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the basis for the intermediate coordinate system, if it is suit able, by (a) focussing Overfull \hbox (7.7746pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 attention on it by specifying its domain in the " domainlist" s tring, or (b) making [238] LaTeX Warning: Hyper reference `SpecFrame' on page 239 undefined on input line 13940. Overfull \hbox (12.76088pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Alignment occurs within the spectral system and standard of res t given by attributes LaTeX Warning: Hyper reference `TimeFrame' on page 239 undefined on input line 13940. LaTeX Warning: Hyper reference `AlignTimeScale' on page 239 undefined on input line 13940. Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Alignment occurs within the time system and time scale given by attributes AlignSystem LaTeX Warning: Hyper reference `Object' on page 239 undefined on input line 139 40. Overfull \hbox (2.26344pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If the requested coordinate conversion is possible, the functio n returns a pointer Overfull \hbox (48.7146pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to a FrameSet which describes the conversion. Otherwise, a null Object pointer (AST__NULL) Overfull \hbox (27.71973pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is returned, it will contain two Frames. Frame number 1 (its base Frame) Overfull \hbox (3.83806pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 will describe the source coordinate system, corresponding to th e " from" parameter. Overfull \hbox (5.15024pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame number 2 (its current Frame) will describe the destinatio n coordinate system, Overfull \hbox (28.76947pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 corresponding to the " to" parameter. The Mapping which inter-r elates these two Frames LaTeX Warning: Hyper reference `astTran2' on page 239 undefined on input line 1 3940. Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that a FrameSet may be used both as a Mapping and as a F rame. If the result is Overfull \hbox (49.76434pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 used as a Mapping (e.g. with astTran2), then it provides a mean s of converting coordinates Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 from the source to the destination coordinate system (or vice v ersa if its inverse Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 transformation is selected). If it is used as a Frame, its attr ibutes will describe Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Attempts to convert between the coordinate systems represent ed by " a" and " Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 b" (assumed to be Frames). If successful, a FrameSet is returne d via the " cvt" Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 pointer which may be used to apply the conversion to sets of co ordinates (e.g. LaTeX Warning: Hyper reference `astSkyFrame' on page 239 undefined on input lin e 13940. LaTeX Warning: Hyper reference `Equinox' on page 239 undefined on input line 13 940. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Creates a FrameSet which describes precession in the default FK5 celestial Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system between equinoxes J2000 (also the default) an d J2005. The Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 returned " cvt" pointer may then be passed to astTran2 to apply this precession LaTeX Warning: Hyper reference `Report' on page 239 undefined on input line 139 40. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that the returned FrameSet also contains information abo ut how to format Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate values. This means that setting its Report attribute to 1 is a simple Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 way to obtain printed output (formatted in sexagesimal notation ) to show the LaTeX Warning: Hyper reference `SkyFrame' on page 239 undefined on input line 1 3940. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Attempts to convert between the coordinate systems represent ed by the current Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frames of " a" and " b" (now assumed to be FrameSets), via the intermediate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 " SKY" coordinate system. This, by default, is the Domain assoc iated with a Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If this fails (for example, because either FrameSet lacks cel estial coordinate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 information), then the user-defined " DETECTOR" coordinate syst em is used instead. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If this also fails, then all other possible ways of achieving c onversion are Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The returned pointer " cvt" indicates whether conversion was possible and will Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 have the value AST__NULL if it was not. If conversion was possi ble, " cvt" will [239] Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The Base attributes of the two FrameSets will be set by astCo nvert to indicate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 which of their Frames was used for the intermediate coordinate system. This Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 means that you can subsequently determine which coordinate syst em was used by Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 The Mapping represented by the returned FrameSet results in alignment taking place Overfull \hbox (28.19052pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 in the coordinate system specified by the AlignSystem attribute of the " to" Frame. LaTeX Warning: Hyper reference `astInvert' on page 240 undefined on input line 13940. Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 When aligning (say) two images, which have been calibrated by attaching FrameSets Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to them, it is usually necessary to convert between the base Fr ames (representing Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 " native" pixel coordinates) of both FrameSets. This may be ach ieved by inverting Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the FrameSets (e.g. using astInvert) so as to interchange their base and current Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [240] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. LaTeX Warning: Hyper reference `Polygon' on page 241 undefined on input line 14 127. LaTeX Warning: Hyper reference `Frame' on page 241 undefined on input line 1412 7. LaTeX Warning: Hyper reference `Domain' on page 241 undefined on input line 141 27. LaTeX Warning: Hyper reference `Title' on page 241 undefined on input line 1412 7. Overfull \hbox (5.33546pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astConvex$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( $\OML /zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 valu e, int oper, const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 array[], const Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the requ ired pixels. It Overfull \hbox (37.11334pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to a 2-dimensional array containing the data to be proc essed. The numerical Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 type of this array should match the 1- or 2-character type code appended to the Overfull \hbox (16.11847pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 function name (e.g. if you are using astConvexF, the type of ea ch array element Overfull \hbox (15.85603pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the second dimension least Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the coordinates of the centre of Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the coordinates of the centre of Overfull \hbox (0.37231pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (37.11334pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 coordinate values at its centre or upper corner, as selected by parameter " starpix" [241] Overfull \hbox (15.85603pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 A flag indicating the nature of the pixel coordinate system use d to describe the Overfull \hbox (57.84578pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 vertex positions in the returned Polygon. If non-zero, the stan dard Starlink definition Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 of pixel coordinate is used in which a pixel with integer index I spans a range Overfull \hbox (64.93155pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 of pixel coordinate from (I-1) to I (i.e. pixel corners have in tegral pixel coordinates). Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 If zero, the definition of pixel coordinate used by other AST f unctions such as Overfull \hbox (5.3586pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 astResample, astMask, etc., is used. In this definition, a pixe l with integer Overfull \hbox (8.7222pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 index I spans a range of pixel coordinate from (I-0.5) to (I$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 0.5) (i.e. pixel Overfull \hbox (33.75575pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 A pointer to the required Polygon. NULL is returned without err or if the array contains Overfull \hbox (5.62103pt too wide) in paragraph at lines 14127--14127 [][]\T1/cmtt/m/n/10 NULL will be returned if this function is invoked with the global error status Overfull \hbox (3.21706pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (8.72821pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 function name astConvex$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (28.76947pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 For example, astConvexD would be used to process " double" data , while astConvexS would [242] LaTeX Warning: Hyper reference `Object' on page 243 undefined on input line 141 75. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14175--14175 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [243] LaTeX Warning: Hyper reference `Object' on page 244 undefined on input line 142 43. LaTeX Warning: Hyper reference `astGetFrame' on page 244 undefined on input lin e 14243. LaTeX Warning: Hyper reference `Frame' on page 244 undefined on input line 1424 3. LaTeX Warning: Hyper reference `FrameSet' on page 244 undefined on input line 1 4243. LaTeX Warning: Hyper reference `astClone' on page 244 undefined on input line 1 4243. Overfull \hbox (24.5254pt too wide) in paragraph at lines 14243--14243 []\T1/cmtt/m/n/10 void astCreatedAt( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, const char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 routine, cons t char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 file, int $\OMS/zplm/m/n/10 ^ ^C$\T1/cmtt/m/n/10 line Overfull \hbox (21.10475pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of a pointer to a null terminated C string in which to return the routine Overfull \hbox (15.85603pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 name (the string will reside in static memory). The pointer wil l be set to NULL Overfull \hbox (5.3586pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of a pointer to a null terminated C string in which to return the file Overfull \hbox (15.85603pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 name (the string will reside in static memory). The pointer wil l be set to NULL Overfull \hbox (10.34488pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of an int in which to store the line number in the file . A line number Overfull \hbox (42.36206pt too wide) in paragraph at lines 14243--14243 [][]\T1/cmtt/m/n/10 NULL pointers and a line number of zero are returned if an error has already occurred [244] LaTeX Warning: Hyper reference `TimeFrame' on page 245 undefined on input line 14299. LaTeX Warning: Hyper reference `System' on page 245 undefined on input line 142 99. LaTeX Warning: Hyper reference `TimeOrigin' on page 245 undefined on input line 14299. LaTeX Warning: Hyper reference `LTOffset' on page 245 undefined on input line 1 4299. LaTeX Warning: Hyper reference `TimeScale' on page 245 undefined on input line 14299. Overfull \hbox (26.35347pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 It is assumes that the system time (returned by the C time( ) function) follows Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 the POSIX standard, representing a continuous monotonic increas ing count of SI Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 seconds since the epoch 00:00:00 UTC 1 January 1970 AD (equival ent to TAI with Overfull \hbox (0.37231pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 An error will be reported if the TimeFrame has a TimeScale value which cannot Overfull \hbox (12.44437pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 be converted to TAI (e.g. " angular" systems such as UT1, GMST, LMST and LAST). Overfull \hbox (0.10988pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 Any inaccuracy in the system clock will be reflected in the value returned by [245] LaTeX Warning: Hyper reference `Plot' on page 246 undefined on input line 14372 . LaTeX Warning: Hyper reference `astDistance' on page 246 undefined on input lin e 14372. LaTeX Warning: Hyper reference `Frame' on page 246 undefined on input line 1437 2. LaTeX Warning: Hyper reference `Mapping' on page 246 undefined on input line 14 372. LaTeX Warning: Hyper reference `astClip' on page 246 undefined on input line 14 372. LaTeX Warning: Hyper reference `astPolyCurve' on page 246 undefined on input li ne 14372. LaTeX Warning: Hyper reference `astGenCurve' on page 246 undefined on input lin e 14372. LaTeX Warning: Hyper reference `astGridLine' on page 246 undefined on input lin e 14372. Overfull \hbox (42.09962pt too wide) in paragraph at lines 14372--14372 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (42.09962pt too wide) in paragraph at lines 14372--14372 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (58.10822pt too wide) in paragraph at lines 14372--14372 [][]\T1/cmtt/m/n/10 No curve is drawn if either of the " start" or " finish" ar rays contains any coordinates LaTeX Warning: Hyper reference `TranInverse' on page 246 undefined on input lin e 14372. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14372--14372 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [246] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 247 undefined on input li ne 14446. LaTeX Warning: Hyper reference `SpecFrame' on page 247 undefined on input line 14446. LaTeX Warning: Hyper reference `SideBand' on page 247 undefined on input line 1 4446. LaTeX Warning: Hyper reference `IF' on page 247 undefined on input line 14446. LaTeX Warning: Hyper reference `astSet' on page 247 undefined on input line 144 46. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new DS BSpecFrame. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 syntax used is identical to that for the astSet function and ma y include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 247 undefined on input line 144 46. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14446--14446 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [247] LaTeX Warning: Hyper reference `Mapping' on page 248 undefined on input line 14 572. LaTeX Warning: Hyper reference `Frame' on page 248 undefined on input line 1457 2. Overfull \hbox (27.14977pt too wide) in paragraph at lines 14572--14572 []\T1/cmtt/m/n/10 void astDecompose( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map1, AstMap ping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map2, int $\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 series, Overfull \hbox (0.10988pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 Address of a location to receive a value indicating if the comp onent Mappings Overfull \hbox (37.11334pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 are applied in series or parallel. A non-zero value means that the supplied Mapping Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 is equivalent to applying map1 followed by map2 in series. A ze ro value means Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 that the supplied Mapping is equivalent to applying map1 to the lower numbered LaTeX Warning: Hyper reference `Invert' on page 248 undefined on input line 145 72. LaTeX Warning: Hyper reference `CmpMap' on page 248 undefined on input line 145 72. Overfull \hbox (39.2669pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpMap, then map1 and map2 will be returned holding pointers Overfull \hbox (36.64255pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 to the component Mappings used to create the CmpMap, either in series or parallel. Note, Overfull \hbox (13.02332pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 changing the Invert attribute of either of the component Mappin gs using the returned Overfull \hbox (44.51563pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 pointers will have no effect on the supplied CmpMap. This is be cause the CmpMap remembers Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 and uses the original settings of the Invert attributes (that i s, the values of the Overfull \hbox (2.52588pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 Invert attributes when the CmpMap was first created). These are the Invert values LaTeX Warning: Hyper reference `TranMap' on page 248 undefined on input line 14 572. Overfull \hbox (44.51563pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a TranMap, then map1 and map2 will b e returned holding pointers Overfull \hbox (18.27203pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 to the forward and inverse Mappings represented by the TranMap (zero will be returned Overfull \hbox (18.27203pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 for series). Note, changing the Invert attribute of either of t he component Mappings Overfull \hbox (39.2669pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 using the returned pointers will have no effect on the supplied TranMap. This is because Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 the TranMap remembers and uses the original settings of the Inv ert attributes (that Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 is, the values of the Invert attributes when the TranMap was fi rst created). These Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 For any class of Mapping other than a CmpMap, map1 will be retu rned holding a clone Overfull \hbox (49.5019pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 of the supplied Mapping pointer, and map2 will be returned hold ing a NULL pointer. Invert1 Overfull \hbox (7.51216pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 will be returned holding the current value of the Invert attrib ute for the supplied [248] LaTeX Warning: Hyper reference `CmpFrame' on page 249 undefined on input line 1 4572. Overfull \hbox (2.52588pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpFrame, then map1 and map2 will be returned holding Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 pointers to the component Frames used to create the CmpFrame. T he component Frames Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 For any class of Frame other than a CmpFrame, map1 will be retu rned holding a clone Overfull \hbox (0.37231pt too wide) in paragraph at lines 14572--14572 [][]\T1/cmtt/m/n/10 The returned Invert values should be used in preference to the current values Overfull \hbox (0.10988pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 of the Invert attribute in map1 and map2. This is because the a ttributes may Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 [][]\T1/cmtt/m/n/10 Any changes made to the component Mappings using the return ed pointers will be [249] LaTeX Warning: Hyper reference `FitsChan' on page 250 undefined on input line 1 4611. LaTeX Warning: Hyper reference `Card' on page 250 undefined on input line 14611 . LaTeX Warning: Hyper reference `astFindFits' on page 250 undefined on input lin e 14611. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14611--14611 [][]\T1/cmtt/m/n/10 This function returns without action if the FitsChan is ini tially positioned at Overfull \hbox (5.62103pt too wide) in paragraph at lines 14611--14611 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the Card attribute exceeds the numb er of cards in Overfull \hbox (21.36719pt too wide) in paragraph at lines 14611--14611 [][]\T1/cmtt/m/n/10 If there are no subsequent cards in the FitsChan, then the Card attribute is left Overfull \hbox (16.11847pt too wide) in paragraph at lines 14611--14611 \T1/cmtt/m/n/10 pointing at the " end-of-file" after deletion (i.e. is set to o ne more than the [250] LaTeX Warning: Hyper reference `Object' on page 251 undefined on input line 146 62. LaTeX Warning: Hyper reference `astBegin' on page 251 undefined on input line 1 4662. LaTeX Warning: Hyper reference `astEnd' on page 251 undefined on input line 146 62. LaTeX Warning: Hyper reference `astClone' on page 251 undefined on input line 1 4662. LaTeX Warning: Hyper reference `astAnnul' on page 251 undefined on input line 1 4662. Overfull \hbox (8.24539pt too wide) in paragraph at lines 14662--14662 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 14662--14662 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these [251] LaTeX Warning: Hyper reference `Frame' on page 252 undefined on input line 1472 2. Overfull \hbox (1.68732pt too wide) in paragraph at lines 14722--14722 []\T1/cmtt/m/n/10 double astDistance( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, const double point1[], const double point2[] ) LaTeX Warning: Hyper reference `Naxes' on page 252 undefined on input line 1472 2. Overfull \hbox (42.09962pt too wide) in paragraph at lines 14722--14722 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (31.60219pt too wide) in paragraph at lines 14722--14722 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis contai ning the coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 14722--14722 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 14722--14722 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [252] LaTeX Warning: Hyper reference `Polygon' on page 253 undefined on input line 14 781. Overfull \hbox (42.09962pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 The maximum allowed discrepancy between the supplied and return ed Polygons, expressed Overfull \hbox (10.86975pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 as a geodesic distance within the Polygon' s coordinate frame. If this is zero Overfull \hbox (33.43924pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 or less, the returned Polygon will have the number of vertices specified by maxvert. Overfull \hbox (15.85603pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 The maximum allowed number of vertices in the returned Polygon. If this is less Overfull \hbox (21.36719pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 than 3, the number of vertices in the returned Polygon will be the minimum needed LaTeX Warning: Hyper reference `Object' on page 253 undefined on input line 147 81. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14781--14781 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [253] LaTeX Warning: Hyper reference `astBBuf' on page 254 undefined on input line 14 813. LaTeX Warning: Hyper reference `Plot' on page 254 undefined on input line 14813 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 14813--14813 [][]\T1/cmtt/m/n/10 The nature of the buffering is determined by the underlying graphics system (as Overfull \hbox (5.62103pt too wide) in paragraph at lines 14813--14813 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function simply invokes [254] LaTeX Warning: Hyper reference `Ellipse' on page 255 undefined on input line 14 953. LaTeX Warning: Hyper reference `Region' on page 255 undefined on input line 149 53. LaTeX Warning: Hyper reference `Frame' on page 255 undefined on input line 1495 3. Overfull \hbox (28.9294pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 AstEllipse $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astEllipse( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double ce ntre[2], const double Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. It must have exactly 2 Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 axes. A deep copy is taken of the supplied Frame. This means th at any subsequent Overfull \hbox (33.43924pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 changes made to the Frame using the supplied pointer will have no effect the Region. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Indicates how the ellipse is described by the remaining paramet ers. A value of Overfull \hbox (31.86462pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 zero indicates that the ellipse is specified by a centre positi on and two positions Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the circumference. A value of one indicates that the ellipse is specified Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 by its centre position, the half-lengths of its two axes, and t he orientation Overfull \hbox (6.93321pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles, containing the coordinates at the centre of the ellipse. Overfull \hbox (42.09962pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles. If " form" is zero, this array should co ntain the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of one of the four points where an axis of the ellipse crosses the circumference Overfull \hbox (10.60732pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of the ellipse. If " form" is one, it should contain the length s of semi-major Overfull \hbox (17.69308pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 and semi-minor axes of the ellipse, given as geodesic distances within the Frame. Overfull \hbox (57.84578pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles. If " form" is zero, this array should co ntaining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 at some other point on the circumference of the ellipse, distin ct from " point1" Overfull \hbox (31.86462pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 . If " form" is one, the first element of this array should hol d the angle between Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 the second axis of the Frame and the first ellipse axis (i.e. t he ellipse axis Overfull \hbox (0.10988pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 which is specified first in the " point1" array), and the secon d element will Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 be ignored. The angle should be given in radians, measured posi tive in the same Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 sense as rotation from the positive direction of the second Fra me axis to the Overfull \hbox (47.34834pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 with the boundary of the Ellipse being created. The uncertainty in any point Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the boundary of the Ellipse is found by shifting the supplie d " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the LaTeX Warning: Hyper reference `Box' on page 255 undefined on input line 14953. LaTeX Warning: Hyper reference `Circle' on page 255 undefined on input line 149 53. LaTeX Warning: Hyper reference `Prism' on page 255 undefined on input line 1495 3. LaTeX Warning: Hyper reference `Object' on page 255 undefined on input line 149 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 will have no effect on the created Ellipse. Alternatively, a NU LL Object pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [255] LaTeX Warning: Hyper reference `astOverlap' on page 256 undefined on input line 14953. LaTeX Warning: Hyper reference `astSimplify' on page 256 undefined on input lin e 14953. Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 256 undefined on input line 149 53. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new El lipse. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [256] Overfull \hbox (18.64314pt too wide) in paragraph at lines 15033--15033 []\T1/cmtt/m/n/10 void astEllipsePars( AstEllipse $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, double centre[2], double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a , double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 b, double LaTeX Warning: Hyper reference `Region' on page 257 undefined on input line 150 33. LaTeX Warning: Hyper reference `Ellipse' on page 257 undefined on input line 15 033. Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 If the coordinate system in which the Ellipse is defined has ax es (X,Y), then Overfull \hbox (21.57837pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 angle" is returned hold ing the angle from the positive direction of the Y axis Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 to the first axis of the ellipse, in radians. Positive rotation is in the same Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 sense as rotation from the positive direction of Y to the posit ive direction of Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 [] \T1/cmtt/m/n/10 An array in which to return the coordinates at one of the two ends of the first Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (16.11847pt too wide) in paragraph at lines 15033--15033 [] \T1/cmtt/m/n/10 An array in which to return the coordinates at one of the two ends of the second Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Ellipse has bee n changed since it Overfull \hbox (15.85603pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 was first created, the returned parameters refer to the new (ch anged) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 [][]\T1/cmtt/m/n/10 Values of AST__BAD are returned for the parameters without error if the ellipse [257] LaTeX Warning: Hyper reference `FitsChan' on page 258 undefined on input line 1 5069. LaTeX Warning: Hyper reference `astWriteFits' on page 258 undefined on input li ne 15069. Overfull \hbox (39.7377pt too wide) in paragraph at lines 15069--15069 [][]\T1/cmtt/m/n/10 This method simply deletes the cards currently in the FitsC han. Unlike astWriteFits, [258] LaTeX Warning: Hyper reference `astBegin' on page 259 undefined on input line 1 5107. LaTeX Warning: Hyper reference `Object' on page 259 undefined on input line 151 07. LaTeX Warning: Hyper reference `astAnnul' on page 259 undefined on input line 1 5107. LaTeX Warning: Hyper reference `astExport' on page 259 undefined on input line 15107. LaTeX Warning: Hyper reference `astExempt' on page 259 undefined on input line 15107. LaTeX Warning: Hyper reference `RefCount' on page 259 undefined on input line 1 5107. [259] LaTeX Warning: Hyper reference `Plot' on page 260 undefined on input line 15171 . LaTeX Warning: Hyper reference `Escape' on page 260 undefined on input line 151 71. LaTeX Warning: Hyper reference `Title' on page 260 undefined on input line 1517 1. LaTeX Warning: Hyper reference `Frame' on page 260 undefined on input line 1517 1. Overfull \hbox (27.92809pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 A flag which indicates if escapes sequences should be included in returned strings. Overfull \hbox (26.6159pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 If zero is supplied, escape sequences will be stripped out of a ll strings returned Overfull \hbox (16.11847pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 by any AST function. If a positive value is supplied, then any escape sequences Overfull \hbox (0.10988pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 will be retained in the value returned to the caller. If a nega tive value is LaTeX Warning: Hyper reference `Object' on page 260 undefined on input line 151 71. LaTeX Warning: Hyper reference `astStripEscapes' on page 260 undefined on input line 15171. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15171--15171 [][]\T1/cmtt/m/n/10 This function also controls whether the astStripEscapes fun ction removes escape Overfull \hbox (22.9418pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 sequences from the supplied string, or returns the supplied str ing without change. [260] LaTeX Warning: Hyper reference `Object' on page 261 undefined on input line 152 07. LaTeX Warning: Hyper reference `astBegin' on page 261 undefined on input line 1 5207. LaTeX Warning: Hyper reference `astEnd' on page 261 undefined on input line 152 07. LaTeX Warning: Hyper reference `astAnnul' on page 261 undefined on input line 1 5207. [261] LaTeX Warning: Hyper reference `Object' on page 262 undefined on input line 152 47. LaTeX Warning: Hyper reference `astEnd' on page 262 undefined on input line 152 47. LaTeX Warning: Hyper reference `astExempt' on page 262 undefined on input line 15247. Overfull \hbox (0.37231pt too wide) in paragraph at lines 15247--15247 [][]\T1/cmtt/m/n/10 It is only sensible to apply this function to pointers that have been created Overfull \hbox (0.10988pt too wide) in paragraph at lines 15247--15247 \T1/cmtt/m/n/10 within (or exported to) the current context and have not been r endered exempt [262] LaTeX Warning: Hyper reference `FitsChan' on page 263 undefined on input line 1 5439. LaTeX Warning: Hyper reference `Card' on page 263 undefined on input line 15439 . Overfull \hbox (31.86462pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a temp late for the keyword Overfull \hbox (10.86975pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 to be found. In the simplest case, this should simply be the ke yword name (the Overfull \hbox (37.11334pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 search is case insensitive and trailing spaces are ignored). Ho wever, this template Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 may also contain " field specifiers" which are capable of match ing a range of Overfull \hbox (21.36719pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 characters (see the " Keyword Templates" section for details). In this case, the Overfull \hbox (16.11847pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 first card with a keyword which matches the template will be fo und. To find the Overfull \hbox (26.35347pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 An array of at least 81 characters (to allow room for a termina ting null) in which Overfull \hbox (10.86975pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the FITS card which is found will be returned. If the search is not successful Overfull \hbox (37.11334pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 If this value is zero (and the search is successful), the FitsC han' s Card attribute Overfull \hbox (18.4804pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 will be set to the index of the card that was found. If it is n on-zero, however, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the Card attribute will be incremented to identify the card whi ch follows the Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Returns the current card in a FitsChan and advances the Card attribute to Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Searches a FitsChan for a FITS card with the " BITPIX" keywo rd and returns that Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 card. The Card attribute is then incremented to identify the ca rd that follows Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Sets the Card attribute of a FitsChan to identify the next C OMMENT card (if [263] Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Searches a FitsChan for the next card with a keyword of the form " CRVALi" (for Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 example, any of the keywords " CRVAL1" , " CRVAL2" or " CRVAL3" would be matched). Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 The card found (if any) is returned, and the Card attribute is then incremented Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 to identify the following card (ready to search for another key word with the same LaTeX Warning: Hyper reference `astClear' on page 264 undefined on input line 1 5439. Overfull \hbox (33.43924pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The search always starts with the current card, as identifi ed by the Card attribute. Overfull \hbox (5.09616pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 To ensure you search the entire contents of a FitsChan, you sho uld first clear Overfull \hbox (7.19565pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the Card attribute (using astClear). This effectively " rewinds " the FitsChan. Overfull \hbox (22.9418pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 If a search is unsuccessful, the Card attribute is set to t he " end-of-file" (i.e. Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (20.63396pt too wide) in paragraph at lines 15439--15439 []\T1/cmtt/m/n/10 The templates used to match FITS keywords are normally compos ed of literal characters, Overfull \hbox (18.0096pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 which must match the keyword exactly (apart from case). However , a template may also Overfull \hbox (34.01819pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 contain " field specifiers" which can match a range of possible characters. This allows Overfull \hbox (44.51563pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 you to search for keywords that contain (for example) numbers, where the digits comprising Overfull \hbox (28.50703pt too wide) in paragraph at lines 15439--15439 []\T1/cmtt/m/n/10 A field specifier starts with a " %" character. This is follo wed by an optional single Overfull \hbox (13.02332pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 digit (0 to 9) specifying a field width. Finally, there is a si ngle character which Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 " f" : matches all characters which are permitted within a FITS keyword (upper Overfull \hbox (23.52075pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 If the field width is omitted, the field specifier matches one or more characters. If Overfull \hbox (7.7746pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the field width is zero, it matches zero or more characters. Ot herwise, it matches Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " %f" will match a blank FITS keyword consisti ng of 8 spaces (as Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " crpix%1d" will match keywords consisting of " CRPIX" followed by [264] Overfull \hbox (0.10988pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " P%c" will match any keyword starting with " P" and followed by [265] LaTeX Warning: Hyper reference `Frame' on page 266 undefined on input line 1583 4. LaTeX Warning: Hyper reference `FrameSet' on page 266 undefined on input line 1 5834. LaTeX Warning: Hyper reference `Current' on page 266 undefined on input line 15 834. LaTeX Warning: Hyper reference `Mapping' on page 266 undefined on input line 15 834. Overfull \hbox (29.35176pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFindFram e( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 target, AstFrame $\OMS/zplm/m /n/10 ^^C$\T1/cmtt/m/n/10 template, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 domainlist Overfull \hbox (13.49411pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Note that if a FrameSet is supplied (and a suitable coordinat e system is found), Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 then its Current attribute will be modified to indicate which F rame was used to Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 obtain attribute values which were not specified by the templat e. This Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 will, in some sense, represent the " closest" non-virtual coord inate system to [266] LaTeX Warning: Hyper reference `SkyFrame' on page 267 undefined on input line 1 5834. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Pointer to the template Frame, which should be an instance of t he type of Frame Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 you wish to find. If you wanted to find a Frame describing a ce lestial coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 system, for example, then you might use a SkyFrame here. See th e " Examples" Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (31.86462pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 of Frame domains. This may be used to establish a priority orde r for the different LaTeX Warning: Hyper reference `Domain' on page 267 undefined on input line 158 34. Overfull \hbox (0.10988pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 The function will first try to find a suitable coordinate sys tem whose Domain Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 attribute equals the first domain in this list. If this fails, the second domain Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the list will be used, and so on, until a result is obtained . A blank domain Overfull \hbox (20.84232pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 (e.g. two consecutive commas) indicates that any coordinate sys tem is acceptable Overfull \hbox (21.10475pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 This list is case-insensitive and all white space is ignored. If you do not wish Overfull \hbox (18.27203pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If the target is a FrameSet, the possibility exists that severa l of the Frames within Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it might be matched by the template. Unless the choice is suffi ciently restricted Overfull \hbox (23.52075pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 by the " domainlist" string, the sequence in which Frames are s earched can then become Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 An attempt is made to match the template to each of the tar get' s Frames in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 order: (1) the current Frame, (2) the base Frame, (3) each rema ining Frame in LaTeX Warning: Hyper reference `TranForward' on page 267 undefined on input lin e 15834. LaTeX Warning: Hyper reference `TranInverse' on page 267 undefined on input lin e 15834. Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Generally, the first match found is used. However, the Mapp ing between the target Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system and the resulting Frame is also examined. Pre ference is given Overfull \hbox (42.36206pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to cases where both the forward and inverse transformations are defined (as indicated Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 by the TranForward and TranInverse attributes). If only one tra nsformation is Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If a match is found and the domain of the resulting Frame a lso matches the current Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " domainlist" field, it is accepted. Otherwise, the next " doma inlist" field Overfull \hbox (23.52075pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If a suitable coordinate system is found, the Current attribute of the target FrameSet Overfull \hbox (38.74203pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 will be modified on exit to identify the Frame whose match with the target was eventually LaTeX Warning: Hyper reference `Object' on page 267 undefined on input line 158 34. Overfull \hbox (34.01819pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If the search is successful, the function returns a pointer to a FrameSet which contains Overfull \hbox (28.76947pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the Frame found and a description of how to convert to (and fro m) the coordinate system Overfull \hbox (25.09537pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it represents. Otherwise, a null Object pointer (AST__NULL) is returned without error. [267] Overfull \hbox (27.71973pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If a FrameSet is returned, it will contain two Frames. Frame number 1 (its base Frame) Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 represents the target coordinate system and will be the same as the (base Frame of Overfull \hbox (55.01306pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the) target. Frame number 2 (its current Frame) will be a Frame representing the coordinate Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 system which the function found. The Mapping which inter-relate s these two Frames LaTeX Warning: Hyper reference `astTran2' on page 268 undefined on input line 1 5834. Overfull \hbox (13.02332pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Note that a FrameSet may be used both as a Mapping and as a F rame. If the result is Overfull \hbox (49.76434pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 used as a Mapping (e.g. with astTran2), then it provides a mean s of converting coordinates Overfull \hbox (13.02332pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 from the target coordinate system into the new coordinate syste m that was found (and Overfull \hbox (18.0096pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 vice versa if its inverse transformation is selected). If it is used as a Frame, its LaTeX Warning: Hyper reference `astFrame' on page 268 undefined on input line 1 5834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a 3-dimensional coordinate system in the target Frame (or FrameSet). Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 No attributes have been set in the template Frame (created by a stFrame), so no Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 restriction has been placed on the required coordinate system, other than that Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it should have 3 dimensions. The first suitable Frame found wil l be returned as LaTeX Warning: Hyper reference `astSkyFrame' on page 268 undefined on input lin e 15834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a celestial coordinate system in the target Fra me (or FrameSet). Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 The type of celestial coordinate system is unspecified, so astF indFrame will Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 return the first one found as part of the " result" FrameSet. I f the target is a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 FrameSet, then its Current attribute will be updated to identif y the Frame that Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If no celestial coordinate system can be found, a value of AS T__NULL will be LaTeX Warning: Hyper reference `MaxAxes' on page 268 undefined on input line 15 834. LaTeX Warning: Hyper reference `CmpFrame' on page 268 undefined on input line 1 5834. LaTeX Warning: Hyper reference `PermMap' on page 268 undefined on input line 15 834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This is like the last example, except that in the event of t he target being a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 CmpFrame, the component Frames encapsulated by the CmpFrame wil l be searched for Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 a SkyFrame. If found, the returned Mapping will included a Perm Map which selects Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 This is acomplished by setting the MaxAxes attribute of the t emplate SkyFrame Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to a large number (larger than or equal to the number of axes i n the target Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 CmpFrame). This allows the SkyFrame to be used as a match for F rames containing LaTeX Warning: Hyper reference `System' on page 268 undefined on input line 158 34. LaTeX Warning: Hyper reference `Equinox' on page 268 undefined on input line 15 834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for an equatorial (FK5) coordinate system in the ta rget. The Equinox Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 value for the coordinate system has not been specified, so will be obtained from Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the target. If the target is a FrameSet, its Current attribute will be updated Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a 2-dimensional coordinate system in the target . Initially, a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 search is made for a suitable coordinate system whose Domain at tribute has the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 value " SKY" . If this search fails, a search is then made for one with the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 domain " PIXEL" . If this also fails, then any 2-dimensional co ordinate system [268] Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Only if no 2-dimensional coordinate systems can be reached by applying built-in Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 conversions to any of the Frames in the target will a value of AST__NULL be Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for any 1-dimensional coordinate system in the targ et which has the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This example has exactly the same effect as that above. It i llustrates Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the equivalence of the template' s Domain attribute and the fie lds in the " Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This is a more advanced example which will search for any co ordinate system Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the target having 1, 2 or 3 dimensions. The Frame returned ( as part of the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " result" FrameSet) will always be 1-dimensional, but will be r elated to the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system that was found by a suitable Mapping (e.g. a PermMap) which LaTeX Warning: Hyper reference `PreserveAxes' on page 269 undefined on input li ne 15834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If we had wanted a Frame representing the actual (1, 2 or 3-d imensional) Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system found, we could set the PreserveAxes attribut e to a non-zero LaTeX Warning: Hyper reference `Permute' on page 269 undefined on input line 15 834. LaTeX Warning: Hyper reference `astPermAxes' on page 269 undefined on input lin e 15834. Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for any celestial coordinate system in the target, but only finds one Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 if its axes are in the conventional (longitude,latitude) order and have not been LaTeX Warning: Hyper reference `AlignSystem' on page 269 undefined on input lin e 15834. Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 The Mapping represented by the returned FrameSet results in alignment taking place Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the coordinate system specified by the AlignSystem attribute of the " template" Overfull \hbox (42.36206pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Beware of setting the Domain attribute of the template and then using a " domainlist" Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 string which does not include the template' s domain (or a blan k field). If you Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (12.76088pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 A Frame (describing a coordinate system) will be found by thi s function if (a) it is Overfull \hbox (34.01819pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " matched" by the template you supply, and (b) the value of its Domain attribute appears Overfull \hbox (40.84152pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the " domainlist" string (except that a blank field in this string permits any domain). Overfull \hbox (20.63396pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 A successful match by the template depends on a number of crite ria, as outlined below: [269] Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 In general, a template will only match another Frame which belongs to the same Overfull \hbox (2.99667pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 class as the template, or to a derived (more specialised) class . For example, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 a SkyFrame template will match any other SkyFrame, but will not match a basic LaTeX Warning: Hyper reference `MinAxes' on page 270 undefined on input line 15 834. Overfull \hbox (29.24026pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 The exception to this is that a Frame of any class can be u sed to match a CmpFrame, Overfull \hbox (29.24026pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 if that CmpFrame contains a Frame of the same class as the temp late. Note however, Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the MaxAxes and MinAxes attributes of the template must be set to suitable values Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to allow it to match the CmpFrame. That is, the MinAxes attribu te must be less Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 than or equal to the number of axes in the target, and the MaxA xes attribute must Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If using a CmpFrame as a template frame, the MinAxes and Ma xAxes for the template Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 are determined by the MinAxes and MaxAxes values of the compone nt Frames within Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the template. So if you want a template CmpFrame to be able to match Frames with Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 different numbers of axes, then you must set the MaxAxes and/or MinAxes attributes Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the component template Frames, before combining them togethe r into the template Overfull \hbox (10.60732pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If a template has a value set for any of its main attribute s, then it will only Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 match Frames which have an identical value for that attribute ( or which can be Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 transformed, using a built-in conversion, so that they have the required value Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 for that attribute). If any attribute in the template is un-set , however, then Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Frames are matched regardless of the value they may have for th at attribute. You Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 may therefore make a template more or less specific by choosing the attributes Overfull \hbox (52.8595pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 for which you set values. This requirement does not apply to ' descriptive' attributes Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 An important application of this principle involves the Dom ain attribute. Setting Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the Domain attribute of the template has the effect of restrict ing the search Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to a particular type of Frame (with the domain you specify). Co nversely, if the Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Domain attribute is not set in the template, then the domain of the Frame found Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 is not relevant, so all Frames are searched. Note that the " do mainlist" string Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 provides an alternative way of restricting the search in the sa me manner, but Overfull \hbox (5.3586pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 is a more convenient interface if you wish to search automatica lly for another LaTeX Warning: Hyper reference `MatchEnd' on page 270 undefined on input line 1 5834. Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Normally, a template will only match a Frame which has the same number of axes Overfull \hbox (0.10988pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 as itself. However, for some classes of template, this default behaviour may Overfull \hbox (23.99155pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 be changed by means of the MinAxes, MaxAxes and MatchEnd attrib utes. In addition, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the behaviour of a template may be influenced by its Permute an d PreserveAxes Overfull \hbox (23.99155pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 attributes, which control whether it matches Frames whose axes have been permuted, Overfull \hbox (31.86462pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 and whether this permutation is retained in the Frame which is returned (as opposed Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to returning the axes in the order specified in the template, w hich is the default Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 behaviour). You should consult the descriptions of these attrib utes for details [270] LaTeX Warning: Hyper reference `FitsChan' on page 271 undefined on input line 1 6010. LaTeX Warning: Hyper reference `Channel' on page 271 undefined on input line 16 010. LaTeX Warning: Hyper reference `System' on page 271 undefined on input line 160 10. LaTeX Warning: Hyper reference `Object' on page 271 undefined on input line 160 10. LaTeX Warning: Hyper reference `astWrite' on page 271 undefined on input line 1 6010. LaTeX Warning: Hyper reference `Card' on page 271 undefined on input line 16010 . LaTeX Warning: Hyper reference `astFindFits' on page 271 undefined on input lin e 16010. LaTeX Warning: Hyper reference `astPutFits' on page 271 undefined on input line 16010. LaTeX Warning: Hyper reference `astPutCards' on page 271 undefined on input lin e 16010. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 271 undefined on inp ut line 16010. LaTeX Warning: Hyper reference `astDelFits' on page 271 undefined on input line 16010. LaTeX Warning: Hyper reference `SourceFile' on page 271 undefined on input line 16010. LaTeX Warning: Hyper reference `SinkFile' on page 271 undefined on input line 1 6010. LaTeX Warning: Hyper reference `astRead' on page 271 undefined on input line 16 010. LaTeX Warning: Hyper reference `Encoding' on page 271 undefined on input line 1 6010. LaTeX Warning: Hyper reference `astRetainFits' on page 271 undefined on input l ine 16010. [271] Overfull \hbox (8.09445pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFitsChan ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/ cmtt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink) ( const char Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a source function which takes no arguments and retur ns a pointer to Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 a null-terminated string. This function will be used by the Fit sChan to obtain Overfull \hbox (16.11847pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 input FITS header cards. On each invocation, it should read the next input card Overfull \hbox (88.55078pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 from some external source (such as a FITS file), and return a p ointer to the (null-terminated) Overfull \hbox (0.37231pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contents of the card. It should return a NULL pointer when ther e are no more Overfull \hbox (10.60732pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 If " source" is NULL, the FitsChan will remain empty until ca rds are explicitly Overfull \hbox (28.19052pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 stored in it (e.g. using astPutCards, astPutFits or via the Sou rceFile attribute). Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 this function will be used by the FitsChan to deliver any FITS header cards it Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contains when it is finally deleted. On each invocation, it sho uld deliver the Overfull \hbox (37.11334pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contents of the character string passed to it as a FITS header card to some external Overfull \hbox (0.37231pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the LaTeX Warning: Hyper reference `astSet' on page 272 undefined on input line 160 10. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fi tsChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 Note, the FITSCHAN_OPTIONS environment variable may be used t o specify default Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 [][]\T1/cmtt/m/n/10 No FITS " END" card will be written via the sink function. You should add this Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [272] LaTeX Warning: Hyper reference `FitsTable' on page 273 undefined on input line 16089. LaTeX Warning: Hyper reference `Table' on page 273 undefined on input line 1608 9. LaTeX Warning: Hyper reference `FitsChan' on page 273 undefined on input line 1 6089. Overfull \hbox (17.69308pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 Pointer to an optional FitsChan containing headers to be stored in the FitsTable. Overfull \hbox (16.11847pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 NULL may be supplied if the new FitsTable is to be left empty. If supplied, and Overfull \hbox (9.82pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 if the headers describe columns of a FITS binary table, then eq uivalent (empty) Overfull \hbox (37.11334pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 columns are added to the FitsTable. Each column has the same in dex in the FitsTable LaTeX Warning: Hyper reference `astSet' on page 273 undefined on input line 160 89. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fi tsTable. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 16089--16089 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 273 undefined on input line 160 89. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16089--16089 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 16089--16089 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [273] LaTeX Warning: Hyper reference `FluxFrame' on page 274 undefined on input line 16187. LaTeX Warning: Hyper reference `Frame' on page 274 undefined on input line 1618 7. LaTeX Warning: Hyper reference `System' on page 274 undefined on input line 161 87. LaTeX Warning: Hyper reference `SpecVal' on page 274 undefined on input line 16 187. Overfull \hbox (26.51622pt too wide) in paragraph at lines 16187--16187 []\T1/cmtt/m/n/10 AstFluxFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFluxFra me( double specval, AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 specfrm, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, LaTeX Warning: Hyper reference `astConvert' on page 274 undefined on input line 16187. LaTeX Warning: Hyper reference `Mapping' on page 274 undefined on input line 16 187. Overfull \hbox (31.60219pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 The spectral value to which the flux values refer, given in the spectral coordinate Overfull \hbox (21.10475pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 system specified by " specfrm" . The value supplied for the " s pecval" parameter Overfull \hbox (0.10988pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 becomes the default value for the SpecVal attribute. A value of AST__BAD may Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 be supplied if the spectral position is unknown, but this may r esult in it not Overfull \hbox (0.37231pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 being possible for the astConvert function to determine a Mappi ng between the LaTeX Warning: Hyper reference `SpecFrame' on page 274 undefined on input line 16187. Overfull \hbox (10.60732pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 A pointer to a SpecFrame describing the spectral coordinate sys tem in which the Overfull \hbox (47.61078pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 " specval" parameter is given. A deep copy of this object is ta ken, so any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 changes to the SpecFrame using the supplied pointer will have n o effect on the Overfull \hbox (42.36206pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 new FluxFrame. A NULL pointer can be supplied if AST__BAD is su pplied for " specval" LaTeX Warning: Hyper reference `astSet' on page 274 undefined on input line 161 87. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fl uxFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `AlignSystem' on page 274 undefined on input lin e 16187. Overfull \hbox (21.36719pt too wide) in paragraph at lines 16187--16187 [][]\T1/cmtt/m/n/10 When conversion between two FluxFrames is requested (as whe n supplying FluxFrames Overfull \hbox (26.6159pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 to astConvert), account will be taken of the nature of the flux coordinate systems Overfull \hbox (58.10822pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 they represent, together with any qualifying attribute values, including the AlignSystem Overfull \hbox (0.37231pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 attribute. The results will therefore fully reflect the relatio nship between Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 positions measured in the two systems. In addition, any differe nce in the Unit [274] LaTeX Warning: Hyper reference `Object' on page 275 undefined on input line 161 87. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [275] LaTeX Warning: Hyper reference `Frame' on page 276 undefined on input line 1625 0. Overfull \hbox (36.8509pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 The number of the Frame axis for which formatting is to be perf ormed (axis numbering Overfull \hbox (0.37231pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy LaTeX Warning: Hyper reference `astUnformat' on page 276 undefined on input lin e 16250. Overfull \hbox (0.37231pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 A formatted value may be converted back into a numerical (d ouble) value using Overfull \hbox (5.3586pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [276] LaTeX Warning: Hyper reference `Frame' on page 277 undefined on input line 1633 9. LaTeX Warning: Hyper reference `Title' on page 277 undefined on input line 1633 9. Overfull \hbox (15.85603pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 The number of Frame axes (i.e. the number of dimensions of the coordinate space LaTeX Warning: Hyper reference `astSet' on page 277 undefined on input line 163 39. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fr ame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Plot' on page 277 undefined on input line 16339 . Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 Creates a new 2-dimensional Frame and initialises its Title attribute to the Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 string " Energy Spectrum: Plot $\OML/zplm/m/it/10 <$\T1/cmtt/m/ n/10 n$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 " , where $\OML/zplm/m/it/10 <$\T1/c mtt/m/n/10 n$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 takes the value of the int Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 Creates a new 2-dimensional Frame and initialises its axis L abel attributes LaTeX Warning: Hyper reference `Object' on page 277 undefined on input line 163 39. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16339--16339 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [277] [278] LaTeX Warning: Hyper reference `FrameSet' on page 279 undefined on input line 1 6453. LaTeX Warning: Hyper reference `Mapping' on page 279 undefined on input line 16 453. LaTeX Warning: Hyper reference `Frame' on page 279 undefined on input line 1645 3. LaTeX Warning: Hyper reference `Base' on page 279 undefined on input line 16453 . LaTeX Warning: Hyper reference `Current' on page 279 undefined on input line 16 453. LaTeX Warning: Hyper reference `Title' on page 279 undefined on input line 1645 3. LaTeX Warning: Hyper reference `astInvert' on page 279 undefined on input line 16453. LaTeX Warning: Hyper reference `Region' on page 279 undefined on input line 164 53. LaTeX Warning: Hyper reference `astAddFrame' on page 279 undefined on input lin e 16453. Overfull \hbox (37.11334pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Pointer to the first Frame to be inserted into the FrameSet. Th is initially becomes Overfull \hbox (58.10822pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 both the base and the current Frame. (Further Frames may be add ed using the astAddFrame LaTeX Warning: Hyper reference `astSet' on page 279 undefined on input line 164 53. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fr ameSet. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [279] LaTeX Warning: Hyper reference `astCopy' on page 280 undefined on input line 16 453. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 [][]\T1/cmtt/m/n/10 If a pointer to an existing FrameSet is given for the " fra me" parameter, then Overfull \hbox (31.86462pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 the new FrameSet will (as a special case) be initialised to con tain the same Frames Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 and Mappings, and to have the same attribute values, as the one supplied. This Overfull \hbox (16.11847pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 process is similar to making a copy of a FrameSet (see astCopy) , except that the Overfull \hbox (16.11847pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Frames and Mappings contained in the original are not themselve s copied, but are LaTeX Warning: Hyper reference `Object' on page 280 undefined on input line 164 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [280] LaTeX Warning: Hyper reference `Object' on page 281 undefined on input line 164 82. LaTeX Warning: Hyper reference `astToString' on page 281 undefined on input lin e 16482. Overfull \hbox (5.3586pt too wide) in paragraph at lines 16482--16482 \T1/cmtt/m/n/10 Pointer to a text string holding an Object serialisation create d previously by Overfull \hbox (60.26178pt too wide) in paragraph at lines 16482--16482 \T1/cmtt/m/n/10 Pointer to a new Object created from the supplied serialisation , or NULL if the serialisation [281] LaTeX Warning: Hyper reference `Mapping' on page 282 undefined on input line 16 536. LaTeX Warning: Hyper reference `astClip' on page 282 undefined on input line 16 536. LaTeX Warning: Hyper reference `astCurve' on page 282 undefined on input line 1 6536. LaTeX Warning: Hyper reference `astPolyCurve' on page 282 undefined on input li ne 16536. LaTeX Warning: Hyper reference `Plot' on page 282 undefined on input line 16536 . LaTeX Warning: Hyper reference `Frame' on page 282 undefined on input line 1653 6. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 Pointer to a Mapping. This Mapping should have 1 input coordina te representing Overfull \hbox (0.37231pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 offset along the required curve, normalized so that the start o f the curve is Overfull \hbox (21.36719pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 at offset 0.0, and the end of the curve is at offset 1.0. Note, this offset does Overfull \hbox (26.6159pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 not need to be linearly related to distance along the curve. Th e number of output Overfull \hbox (26.6159pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 coordinates should equal the number of axes in the current Fram e of the Plot. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 Mapping should map a specified offset along the curve, into the corresponding Overfull \hbox (5.62103pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 coordinates in the current Frame of the Plot. The inverse trans formation need LaTeX Warning: Hyper reference `TranInverse' on page 282 undefined on input lin e 16536. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16536--16536 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [282] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. LaTeX Warning: Hyper reference `Object' on page 283 undefined on input line 166 18. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the attribute whose Overfull \hbox (32.085pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 The attribute value, in the data type corresponding to $\OML/zp lm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 (or, in the case of astGetC, Overfull \hbox (13.02332pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 a pointer to a constant null-terminated character string contai ning this value). LaTeX Warning: Hyper reference `RefCount' on page 283 undefined on input line 1 6618. Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 LaTeX Warning: Hyper reference `Title' on page 283 undefined on input line 1661 8. Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 [] \T1/cmtt/m/n/10 Obtains a pointer to a null-terminated character string cont aining the Title Overfull \hbox (5.62103pt too wide) in paragraph at lines 16618--16618 [][]\T1/cmtt/m/n/10 An appropriate " null" value will be returned if this funct ion is invoked with Overfull \hbox (10.86975pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 the AST error status set, or if it should fail for any reason. This null value Overfull \hbox (10.86975pt too wide) in paragraph at lines 16618--16618 [][]\T1/cmtt/m/n/10 The pointer returned by astGetC is guaranteed to remain val id and the string to Overfull \hbox (21.10475pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 which it points will not be over-written for a total of 50 succ essive invocations Overfull \hbox (8.24539pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 of this function. After this, the memory containing the string may be re-used, [283] LaTeX Warning: Hyper reference `Frame' on page 284 undefined on input line 1665 6. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 284 undefined on inpu t line 16656. Overfull \hbox (31.86462pt too wide) in paragraph at lines 16656--16656 [][]\T1/cmtt/m/n/10 A zero value will be returned if this function is invoked w ith the AST error status [284] Overfull \hbox (2.6858pt too wide) in paragraph at lines 16752--16752 []\T1/cmtt/m/n/10 void astGetColumnData( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, flo at fnull, double LaTeX Warning: Hyper reference `FitsTable' on page 285 undefined on input line 16752. Overfull \hbox (22.67937pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The value to return in " coldata" for any cells for which no va lue has been stored Overfull \hbox (47.61078pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the FitsTable. Ignored if the column' s data type is not AST __FLOATTYPE. Supplying Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The value to return in " coldata" for any cells for which no va lue has been stored Overfull \hbox (52.8595pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the FitsTable. Ignored if the column' s data type is not AST __DOUBLETYPE. Supplying LaTeX Warning: Hyper reference `astColumnSize' on page 285 undefined on input l ine 16752. Overfull \hbox (15.85603pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The size of the " coldata" array, in bytes. The amount of memor y needed to hold Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 the data from a column may be determined using astColumnSize. I f the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 array is too small to hold all the column data, trailing column values will be Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 A pointer to an area of memory in which to return the data valu es currently stored Overfull \hbox (31.60219pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the column. The values are stored in row order. If the colum n holds non-scalar Overfull \hbox (15.85603pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 values, the elements of each value are stored in " Fortran" ord er. No data type Overfull \hbox (10.86975pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 conversion is performed - the data type of each returned value is the data type Overfull \hbox (21.36719pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 associated with the column when the column was added to the tab le. If the column Overfull \hbox (0.37231pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 holds strings, the returned strings will be null terminated. An y excess room Overfull \hbox (0.10988pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The number of elements returned in the " coldata" array. This i s the product Overfull \hbox (7.19565pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 of the number of rows returned and the number of elements in ea ch column value. Underfull \hbox (badness 10000) in paragraph at lines 16752--16752 Overfull \hbox (0.10988pt too wide) in paragraph at lines 16752--16752 [][]\T1/cmtt/m/n/10 The " fnull" and " dnull" parameters specify the value to b e returned for any Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 empty cells within columns holding floating point values. For c olumns holding Overfull \hbox (10.86975pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 integer values, the value returned for empty cells is the value returned by the Overfull \hbox (31.60219pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 astColumNull function. For columns holding string values, the A SCII NULL character [285] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. LaTeX Warning: Hyper reference `FitsChan' on page 286 undefined on input line 1 6912. Overfull \hbox (7.19565pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (39.7377pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 from it. No more than 80 characters are read from this string. If NULL is supplied, Overfull \hbox (0.10988pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 A pointer to a buffer to receive the keyword value. The data ty pe depends on Overfull \hbox (11.82336pt too wide) in paragraph at lines 16912--16912 \OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 as d escribed above. The conents of the buffer on entry are left unchanged [286] Overfull \hbox (2.001pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 A value of zero is returned if the keyword was not found in the FitsChan (no error Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If a name is supplied, the card following the current card is checked first. If Overfull \hbox (26.6159pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 this is not the required card, then the rest of the FitsChan is searched, starting Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 with the first card added to the FitsChan. Therefore cards shou ld be accessed Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 in the order they are stored in the FitsChan (if possible) as t his will minimise Overfull \hbox (26.6159pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the requested card is found, it becomes the current card , otherwise the current Overfull \hbox (5.62103pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the stored keyword value is not of the requested type, i t is converted into LaTeX Warning: Hyper reference `astTestFits' on page 287 undefined on input lin e 16912. Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the keyword is found in the FitsChan, but has no associa ted value, an error Overfull \hbox (0.37231pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 is reported. If necessary, the astTestFits function can be used to determine Overfull \hbox (22.9418pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 if the keyword has a defined value in the FitsChan prior to cal ling this function. Overfull \hbox (33.43924pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 .FALSE. is returned as the function value if an error has a lready occurred, or Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 The FITS standard says that string keyword values should be padded with trailing Overfull \hbox (10.86975pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 spaces if they are shorter than 8 characters. For this reason, trailing spaces Overfull \hbox (42.36206pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 are removed from the string returned by astGetFitsS if the orig inal string (including Overfull \hbox (0.37231pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 any trailing spaces) contains 8 or fewer characters. Trailing s paces are not [287] LaTeX Warning: Hyper reference `Frame' on page 288 undefined on input line 1696 4. LaTeX Warning: Hyper reference `FrameSet' on page 288 undefined on input line 1 6964. LaTeX Warning: Hyper reference `Nframe' on page 288 undefined on input line 169 64. Overfull \hbox (5.3586pt too wide) in paragraph at lines 16964--16964 \T1/cmtt/m/n/10 The index of the required Frame within the FrameSet. This value should lie in Overfull \hbox (16.11847pt too wide) in paragraph at lines 16964--16964 \T1/cmtt/m/n/10 the range from 1 to the number of Frames in the FrameSet (as gi ven by its Nframe Overfull \hbox (0.10988pt too wide) in paragraph at lines 16964--16964 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter LaTeX Warning: Hyper reference `RefCount' on page 288 undefined on input line 1 6964. LaTeX Warning: Hyper reference `Object' on page 288 undefined on input line 169 64. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16964--16964 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [288] LaTeX Warning: Hyper reference `KeyMap' on page 289 undefined on input line 169 97. LaTeX Warning: Hyper reference `astGrfSet' on page 289 undefined on input line 16997. LaTeX Warning: Hyper reference `Plot' on page 289 undefined on input line 16997 . Overfull \hbox (2.26344pt too wide) in paragraph at lines 16997--16997 \T1/cmtt/m/n/10 A pointer to the graphics context KeyMap. The returned pointer should be annulled [289] LaTeX Warning: Hyper reference `Mapping' on page 290 undefined on input line 17 072. LaTeX Warning: Hyper reference `FrameSet' on page 290 undefined on input line 1 7072. LaTeX Warning: Hyper reference `Frame' on page 290 undefined on input line 1707 2. Overfull \hbox (26.35347pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 The index of the first Frame in the FrameSet. This Frame descri bes the coordinate Overfull \hbox (31.60219pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 The index of the second Frame in the FrameSet. This Frame descr ibes the coordinate Overfull \hbox (18.27203pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 Pointer to a Mapping whose forward transformation converts coor dinates from the first Overfull \hbox (44.51563pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 coordinate system to the second one, and whose inverse transfor mation converts coordinates Overfull \hbox (15.85603pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 The returned Mapping will include the clipping effect of an y Regions which occur Overfull \hbox (26.6159pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 on the path between the two supplied Frames (this includes the two supplied Frames LaTeX Warning: Hyper reference `Nframe' on page 290 undefined on input line 170 72. LaTeX Warning: Hyper reference `UnitMap' on page 290 undefined on input line 17 072. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 The values given for the " iframe1" and " iframe2" paramete rs should lie in the Overfull \hbox (54.43411pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 range from 1 to the number of Frames in the FrameSet (as given by its Nframe attribute). Overfull \hbox (13.75655pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may also be given to ident ify the FrameSet' Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 s base Frame or current Frame respectively. It is permissible f or both these Overfull \hbox (43.93668pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 parameters to have the same value, in which case a unit Mapping (UnitMap) is returned. LaTeX Warning: Hyper reference `TranForward' on page 290 undefined on input lin e 17072. LaTeX Warning: Hyper reference `TranInverse' on page 290 undefined on input lin e 17072. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 It should always be possible to generate the Mapping reques ted, but this does Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 necessarily guarantee that it will be able to perform the requi red coordinate Overfull \hbox (42.36206pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 conversion. If necessary, the TranForward and TranInverse attri butes of the returned Overfull \hbox (38.68796pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 Mapping should be inspected to determine if the required transf ormation is available. LaTeX Warning: Hyper reference `Object' on page 290 undefined on input line 170 72. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [290] LaTeX Warning: Hyper reference `RefRA' on page 291 undefined on input line 1712 8. LaTeX Warning: Hyper reference `RefDec' on page 291 undefined on input line 171 28. LaTeX Warning: Hyper reference `SkyFrame' on page 291 undefined on input line 1 7128. Overfull \hbox (7.30714pt too wide) in paragraph at lines 17128--17128 []\T1/cmtt/m/n/10 void astGetRefPos( AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, AstSkyFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frm, double $\ OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 lon, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 lat ) LaTeX Warning: Hyper reference `SpecFrame' on page 291 undefined on input line 17128. Overfull \hbox (7.19565pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 Pointer to the SkyFrame which defines the required celestial co ordinate system. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 If NULL is supplied, then the longitude and latitude values are returned as FK5 Overfull \hbox (15.85603pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 A pointer to a double in which to store the longitude of the re ference point, in Overfull \hbox (10.86975pt too wide) in paragraph at lines 17128--17128 [] \T1/cmtt/m/n/10 A pointer to a double in which to store the latitude of t he reference point, in Overfull \hbox (26.35347pt too wide) in paragraph at lines 17128--17128 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error [291] LaTeX Warning: Hyper reference `Region' on page 292 undefined on input line 171 88. LaTeX Warning: Hyper reference `Frame' on page 292 undefined on input line 1718 8. LaTeX Warning: Hyper reference `Negated' on page 292 undefined on input line 17 188. Overfull \hbox (28.19052pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 Pointer to an array in which to return the lower axis bounds co vered by the Region. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 It should have at least as many elements as there are axes in t he Region. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 an axis has no lower limit, the returned value will be the larg est possible negative Overfull \hbox (28.19052pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 Pointer to an array in which to return the upper axis bounds co vered by the Region. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 It should have at least as many elements as there are axes in t he Region. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 an axis has no upper limit, the returned value will be the larg est possible positive Overfull \hbox (26.6159pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 The value of the Negated attribute is ignored (i.e. it is a ssumed that the Region Overfull \hbox (15.85603pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 If an axis has no extent on an axis then the lower limit wi ll be returned larger Overfull \hbox (5.62103pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 than the upper limit. Note, this is different to an axis which has a constant Overfull \hbox (36.8509pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 value (in which case both lower and upper limit will be returne d set to the constant Overfull \hbox (26.35347pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 If the bounds on an axis cannot be determined, AST__BAD is returned for both upper [292] LaTeX Warning: Hyper reference `Frame' on page 293 undefined on input line 1722 6. LaTeX Warning: Hyper reference `Region' on page 293 undefined on input line 172 26. Overfull \hbox (12.49844pt too wide) in paragraph at lines 17226--17226 \T1/cmtt/m/n/10 A pointer to a deep copy of the Frame represented by the Region . Using this pointer Overfull \hbox (18.27203pt too wide) in paragraph at lines 17226--17226 \T1/cmtt/m/n/10 to modify the Frame will have no effect on the Region. To modif y the Region, use the LaTeX Warning: Hyper reference `Object' on page 293 undefined on input line 172 26. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17226--17226 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [293] LaTeX Warning: Hyper reference `FrameSet' on page 294 undefined on input line 1 7267. LaTeX Warning: Hyper reference `Region' on page 294 undefined on input line 172 67. LaTeX Warning: Hyper reference `Frame' on page 294 undefined on input line 1726 7. LaTeX Warning: Hyper reference `astGetRegionFrame' on page 294 undefined on inp ut line 17267. Overfull \hbox (28.2446pt too wide) in paragraph at lines 17267--17267 \T1/cmtt/m/n/10 A pointer to a deep copy of the FrameSet represented by the Reg ion. Using this pointer LaTeX Warning: Hyper reference `Object' on page 294 undefined on input line 172 67. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17267--17267 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [294] LaTeX Warning: Hyper reference `Region' on page 295 undefined on input line 173 48. LaTeX Warning: Hyper reference `MeshSize' on page 295 undefined on input line 1 7348. Overfull \hbox (12.97206pt too wide) in paragraph at lines 17348--17348 []\T1/cmtt/m/n/10 void astGetRegionMesh( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cm tt/m/n/10 this, int surface, int maxpoint, int maxcoord, int Overfull \hbox (23.99155pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 If non-zero, the returned points will cover the surface or the Region. Otherwise, Overfull \hbox (21.57837pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 If zero, the number of points in the mesh is returned in " $\OM S/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 npoint" , but no axis Overfull \hbox (36.8509pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 values are returned and all other parameters are ignored. If no t zero, the supplied Overfull \hbox (5.3586pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 value should be the length of the second dimension of the " poi nts" array. An Overfull \hbox (10.60732pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 The length of the first dimension of the " points" array. An er ror is reported Overfull \hbox (10.60732pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 A pointer to an integer in which to return the number of points in the returned Overfull \hbox (68.34322pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [maxcoord][maxpoint]" Overfull \hbox (31.86462pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 , in which to return the coordinate values at the mesh position s. These are stored Overfull \hbox (5.62103pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 such that the value of coordinate number " coord" for point num ber " point" is LaTeX Warning: Hyper reference `Circle' on page 295 undefined on input line 173 48. LaTeX Warning: Hyper reference `Box' on page 295 undefined on input line 17348. Overfull \hbox (16.11847pt too wide) in paragraph at lines 17348--17348 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Region has been changed since it was Overfull \hbox (0.37231pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 first created, the returned axis values refer to the new (chang ed) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (36.8509pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [295] LaTeX Warning: Hyper reference `Region' on page 296 undefined on input line 174 97. Overfull \hbox (32.0758pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 If zero, the number of points needed to define the Region is re turned in " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 npoint" Overfull \hbox (10.86975pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 , but no axis values are returned and all other parameters are ignored. If not Overfull \hbox (5.62103pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 zero, the supplied value should be the length of the second dim ension of the " Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 points" array. An error is reported if the number of points nee ded to define Overfull \hbox (10.60732pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The length of the first dimension of the " points" array. An er ror is reported Overfull \hbox (33.1768pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 A pointer to an integer in which to return the number of points defining the Region. Overfull \hbox (68.34322pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [maxcoord][maxpoint]" Overfull \hbox (28.19052pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 , in which to return the coordinate values at the positions tha t define the Region. Overfull \hbox (31.33975pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 These are stored such that the value of coordinate number " coo rd" for point number LaTeX Warning: Hyper reference `Box' on page 296 undefined on input line 17497. LaTeX Warning: Hyper reference `Circle' on page 296 undefined on input line 174 97. Overfull \hbox (2.26344pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first returned position is the Circle centre, and the secon d is a point on the LaTeX Warning: Hyper reference `CmpRegion' on page 296 undefined on input line 17497. LaTeX Warning: Hyper reference `astDecompose' on page 296 undefined on input li ne 17497. Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. Overfull \hbox (33.75575pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 To find the points defining a CmpRegion, use this method on the component Regions, which LaTeX Warning: Hyper reference `Ellipse' on page 296 undefined on input line 17 497. Overfull \hbox (7.51216pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first returned position is the Ellipse centre. The second i s the end of one of Overfull \hbox (7.7746pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 the axes of the ellipse. The third is some other point on the c ircumference of the LaTeX Warning: Hyper reference `Interval' on page 296 undefined on input line 1 7497. Overfull \hbox (44.25319pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first point corresponds to the lower bounds position, and t he second point corresponds Overfull \hbox (7.7746pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 to the upper bounds position. These are reversed to indicate an extcluded interval Overfull \hbox (14.59793pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 rather than an included interval. See the Interval constructor for more information. [296] LaTeX Warning: Hyper reference `NullRegion' on page 297 undefined on input line 17497. Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. LaTeX Warning: Hyper reference `PointList' on page 297 undefined on input line 17497. Overfull \hbox (24.83293pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The positions returned are those that were supplied when the Po intList was constructed. LaTeX Warning: Hyper reference `Polygon' on page 297 undefined on input line 17 497. Overfull \hbox (7.51216pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The positions returned are the vertex positions that were suppl ied when the Polygon LaTeX Warning: Hyper reference `Prism' on page 297 undefined on input line 1749 7. Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. Overfull \hbox (12.76088pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 To find the points defining a Prism, use this method on the com ponent Regions, which Overfull \hbox (16.11847pt too wide) in paragraph at lines 17497--17497 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Region has been changed since it was Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 first created, the returned axis values refer to the new (chang ed) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (36.8509pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [297] LaTeX Warning: Hyper reference `Stc' on page 298 undefined on input line 17552. LaTeX Warning: Hyper reference `KeyMap' on page 298 undefined on input line 175 52. LaTeX Warning: Hyper reference `System' on page 298 undefined on input line 175 52. Overfull \hbox (0.10988pt too wide) in paragraph at lines 17552--17552 \T1/cmtt/m/n/10 The index of the AstroCoords element required. The first has in dex one. The Overfull \hbox (43.93668pt too wide) in paragraph at lines 17552--17552 \T1/cmtt/m/n/10 number of AstroCoords elements in the Stc can be found using fu nction astGetStcNcoord. Underfull \hbox (badness 10000) in paragraph at lines 17552--17552 LaTeX Warning: Hyper reference `Object' on page 298 undefined on input line 175 52. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17552--17552 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [298] LaTeX Warning: Hyper reference `Stc' on page 299 undefined on input line 17588. Overfull \hbox (13.49411pt too wide) in paragraph at lines 17588--17588 [][]\T1/cmtt/m/n/10 Zero will be returned if this function is invoked with the AST error status set, [299] LaTeX Warning: Hyper reference `Region' on page 300 undefined on input line 176 25. LaTeX Warning: Hyper reference `Stc' on page 300 undefined on input line 17625. LaTeX Warning: Hyper reference `Object' on page 300 undefined on input line 176 25. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17625--17625 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [300] LaTeX Warning: Hyper reference `FitsChan' on page 301 undefined on input line 1 7668. LaTeX Warning: Hyper reference `FitsTable' on page 301 undefined on input line 17668. LaTeX Warning: Hyper reference `astAnnul' on page 301 undefined on input line 1 7668. Overfull \hbox (28.19052pt too wide) in paragraph at lines 17668--17668 [][]\T1/cmtt/m/n/10 The returned pointer should be annulled using astAnnul when it is no longer needed. LaTeX Warning: Hyper reference `astPutTableHeader' on page 301 undefined on inp ut line 17668. Overfull \hbox (33.43924pt too wide) in paragraph at lines 17668--17668 [][]\T1/cmtt/m/n/10 Changing the contents of the returned FitsChan will have no effect on the FitsTable. Overfull \hbox (5.3586pt too wide) in paragraph at lines 17668--17668 \T1/cmtt/m/n/10 To modify the FitsTable, the modified FitsChan must be stored i n the FitsTable [301] LaTeX Warning: Hyper reference `FitsChan' on page 302 undefined on input line 1 7724. LaTeX Warning: Hyper reference `KeyMap' on page 302 undefined on input line 177 24. LaTeX Warning: Hyper reference `FitsTable' on page 302 undefined on input line 17724. LaTeX Warning: Hyper reference `astPutTable' on page 302 undefined on input lin e 17724. LaTeX Warning: Hyper reference `astPutTables' on page 302 undefined on input li ne 17724. LaTeX Warning: Hyper reference `astWrite' on page 302 undefined on input line 1 7724. LaTeX Warning: Hyper reference `FrameSet' on page 302 undefined on input line 1 7724. LaTeX Warning: Hyper reference `TabOK' on page 302 undefined on input line 1772 4. LaTeX Warning: Hyper reference `astAnnul' on page 302 undefined on input line 1 7724. Overfull \hbox (10.13652pt too wide) in paragraph at lines 17724--17724 \T1/cmtt/m/n/10 A pointer to a deep copy of the KeyMap holding the tables curre ntly in the FitsChan, Overfull \hbox (13.02332pt too wide) in paragraph at lines 17724--17724 \T1/cmtt/m/n/10 or NULL if the FitsChan does not contain any tables. The return ed pointer should be LaTeX Warning: Hyper reference `Object' on page 302 undefined on input line 177 24. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17724--17724 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [302] LaTeX Warning: Hyper reference `Region' on page 303 undefined on input line 178 15. LaTeX Warning: Hyper reference `astSetUnc' on page 303 undefined on input line 17815. Overfull \hbox (47.34834pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 Controls what is returned if no uncertainty information has bee n associated explicitly Overfull \hbox (57.58334pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 with the supplied Region. If a non-zero value is supplied, then the default uncertainty Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 Region used internally within AST is returned (see " Applicabil ity" below). If LaTeX Warning: Hyper reference `CmpRegion' on page 303 undefined on input line 17815. Overfull \hbox (24.83293pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 The default uncertainty for a CmpRegion is taken from one of th e two component Regions. Overfull \hbox (7.7746pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 If the first component Region has a non-default uncertainty, th en it is used as the Overfull \hbox (34.01819pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 default uncertainty for the parent CmpRegion. Otherwise, if the second component Region Overfull \hbox (34.01819pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 has a non-default uncertainty, then it is used as the default u ncertainty for the parent Overfull \hbox (18.27203pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 CmpRegion. If neither of the component Regions has non-default uncertainty, then the Overfull \hbox (14.59793pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 default uncertainty for the CmpRegion is 1.0E-6 of the bounding box of the CmpRegion. LaTeX Warning: Hyper reference `Prism' on page 303 undefined on input line 1781 5. Overfull \hbox (18.0096pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 The default uncertainty for a Prism is formed by combining the uncertainties from the Overfull \hbox (20.8964pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 two component Regions. If a component Region does not have a no n-default uncertainty, Overfull \hbox (28.76947pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 then its default uncertainty will be used to form the default u ncertainty of the parent Overfull \hbox (2.26344pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 For other classes of Region, the default uncertainty is 1.0E-6 of the bounding box Overfull \hbox (12.76088pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 of the Region. If the bounding box has zero width on any axis, then the uncertainty LaTeX Warning: Hyper reference `System' on page 303 undefined on input line 178 15. LaTeX Warning: Hyper reference `astMapRegion' on page 303 undefined on input li ne 17815. Overfull \hbox (21.36719pt too wide) in paragraph at lines 17815--17815 [][]\T1/cmtt/m/n/10 If uncertainty information is associated with a Region, and the coordinate system Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 described by the Region is subsequently changed (e.g. by changi ng the value of Overfull \hbox (10.60732pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 its System attribute, or using the astMapRegion function), then the uncertainty Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 information returned by this function will be modified so that it refers to the LaTeX Warning: Hyper reference `Object' on page 303 undefined on input line 178 15. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17815--17815 [][]\T1/cmtt/m/n/10 A null Object pointer (NULL) will be returned if this funct ion is invoked with [303] LaTeX Warning: Hyper reference `astGrfPush' on page 304 undefined on input line 17852. LaTeX Warning: Hyper reference `Plot' on page 304 undefined on input line 17852 . LaTeX Warning: Hyper reference `astGrfSet' on page 304 undefined on input line 17852. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17852--17852 [][]\T1/cmtt/m/n/10 This function returns without action if there are no snapsh ots to restore. No [304] LaTeX Warning: Hyper reference `Plot' on page 305 undefined on input line 17883 . LaTeX Warning: Hyper reference `astGrfPop' on page 305 undefined on input line 17883. LaTeX Warning: Hyper reference `astGrfSet' on page 305 undefined on input line 17883. [305] LaTeX Warning: Hyper reference `Plot' on page 306 undefined on input line 18354 . LaTeX Warning: Hyper reference `ast_link' on page 306 undefined on input line 1 8354. LaTeX Warning: Hyper reference `Grf' on page 306 undefined on input line 18354. Overfull \hbox (31.60219pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 A name indicating the graphics function to be replaced. Various graphics functions Overfull \hbox (26.6159pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 are used by the Plot class, and any combination of them may be supplied by calling Overfull \hbox (47.61078pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 this function once for each function to be replaced. If any of the graphics functions Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 are not replaced in this way, the corresponding functions in th e graphics interface Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 selected at link-time (using the ast_link command) are used. Th e allowed names Overfull \hbox (13.23167pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The string is case insensitive. For details of the interface re quired for each, Overfull \hbox (5.09616pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 A Pointer to the function to be used to provide the functionali ty indicated by Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 parameter name. The interface for each function is described be low, but the function Overfull \hbox (21.36719pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 Once a function has been provided, a null pointer can be supp lied in a subsequent Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 call to astGrfSet to reset the function to the corresponding fu nction in the graphics LaTeX Warning: Hyper reference `astPlot' on page 306 undefined on input line 18 354. Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 All the functions listed below (except for " Cap" ) should re turn an integer value Overfull \hbox (60.26178pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of 0 if an error occurs, and 1 otherwise. All x and y values re fer to " graphics cordinates" LaTeX Warning: Hyper reference `KeyMap' on page 306 undefined on input line 183 54. LaTeX Warning: Hyper reference `astGetGrfContext' on page 306 undefined on inpu t line 18354. Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The first parameter (" grfcon" ) for each function is an AST KeyMap pointer that can Overfull \hbox (9.34921pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 be used by the called function to establish the context in whic h it is being called. Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The contents of the KeyMap are determined by the calling applic ation, which should Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 obtain a pointer to the KeyMap using the astGetGrfContext funct ion, and then store Overfull \hbox (15.64767pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 any necessary information in the KeyMap using the methods of th e KeyMap class. Note, Overfull \hbox (9.34921pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the functions listed below should never annul or delete the sup plied KeyMap pointer. [306] Overfull \hbox (18.0096pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Attr" function returns the current value of a specified graphics attribute, and Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 optionally establishes a new value. The supplied value is conve rted to an integer Overfull \hbox (1.8985pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int Attr( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 grf con, int attr, double value, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 old_v alue, int prim ) Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 attr - An integer value identifying the required attribute. The following symbolic Overfull \hbox (7.98296pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 values are defined in grf.h: GRF__STYLE (Line style), GRF__WIDT H (Line width), Overfull \hbox (8.24539pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 GRF__SIZE (Character and marker size scale factor), GRF__FONT ( Character font), Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 value - A new value to store for the attribute. If this is AST__BAD no value Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 old_value - A pointer to a double in which to return the at tribute value. If Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 prim - The sort of graphics primitive to be drawn with the new attribute. Identified Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " BBuf" function should start a new graphics buffering co ntext. A matching call Overfull \hbox (28.76947pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 to the function " EBuf" should be used to end the context. The nature of the buffering Overfull \hbox (10.13652pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Cap" function is called to determine if the grf module has a given capability, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 cap - The capability being inquired about. This will be one of the following Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 GRF__SCALES: This function should return a non-zero value if th e " Scales" function Overfull \hbox (19.84665pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 is implemented, and zero otherwise. The supplied " value" argum ent should be ignored. Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 GRF__MJUST: This function should return a non-zero value if t he " Text" and " TxExt" Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 functions recognise " M" as a character in the justification st ring. If the first Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 character of a justification string is " M" , then the text sho uld be justified with Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the given reference point at the bottom of the bounding box. Th is is different to Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 " B" justification, which requests that the reference point be put on the baseline Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of the text, since some characters hang down below the baseline . If the " Text" or Overfull \hbox (34.01819pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 " TxExt" function cannot differentiate between " M" and " B" , then this function should Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 return zero, in which case " M" justification will never be req uested by Plot. The [307] LaTeX Warning: Hyper reference `Escape' on page 308 undefined on input line 183 54. Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 GRF__ESC: This function should return a non-zero value if the " Text" and " TxExt" Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 functions can recognise and interpret graphics escape sequences within the supplied Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 string (see attribute Escape). Zero should be returned if escap e sequences cannot Overfull \hbox (4.1005pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 be interpreted (in which case the Plot class will interpret the m itself if needed). Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The supplied " value" argument should be ignored only if escape sequences cannot be Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 interpreted by " Text" and " TxExt" . Otherwise, " value" indic ates whether " Text" Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 and " TxExt" should interpret escape sequences in subsequent ca lls. If " value" is Overfull \hbox (41.89127pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 non-zero then escape sequences should be interpreted by " Text" and " TxExt" . Otherwise, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 value - The use of this parameter depends on the value of " cap" as described Overfull \hbox (21.36719pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 Returned Function Value: The value returned by the function depends on the value Overfull \hbox (21.10475pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of " cap" as described above. Zero should be returned if the su pplied capability Overfull \hbox (54.75063pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " EBuf" function should end the current graphics bufferin g context. See the description Overfull \hbox (12.49844pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Flush" function ensures that the display device is up-t o-date, by flushing any Overfull \hbox (44.25319pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Line" function displays lines joining the given positio ns and requires the following Overfull \hbox (33.75575pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Mark" function displays markers at the given positions. It requires the following [308] Overfull \hbox (28.19052pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 type - An integer which can be used to indicate the type of marker symbol required. Overfull \hbox (28.2446pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Qch" function returns the heights of characters drawn v ertically and horizontally Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 chv - A pointer to the float which is to receive the height of characters drawn Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 chh - A pointer to the float which is to receive the height of characters drawn Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Scales" function returns two values (one for each axis) which scale increments Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 on the corresponding axis into a " normal" coordinate system in which: 1) the axes Overfull \hbox (23.52075pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 have equal scale in terms of (for instance) millimetres per uni t distance, 2) X values Overfull \hbox (23.52075pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 increase from left to right, and 3) Y values increase from bott om to top. It requires Overfull \hbox (17.69308pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 alpha - A pointer to the float which is to receive the scal e for the X axis (i.e. Overfull \hbox (12.44437pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 beta - A pointer to the float which is to receive the scale for the Y axis (i.e. Overfull \hbox (23.25832pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Text" function displays a character string at a given p osition using a specified Overfull \hbox (0.53506pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int Text( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 grf con, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, float x, float y, c onst char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 just, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 just - A character string which specifies the location with in the text string Overfull \hbox (47.0859pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 which is to be placed at the reference position given by x and y. The first character Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 may be ' T' for " top" , ' C' for " centre" , or ' B' for " bot tom" , and specifies Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the vertical location of the reference position. Note, " bottom " corresponds Overfull \hbox (9.82pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 to the base-line of normal text. Some characters (eg " y" , " g " , " p" , etc) Overfull \hbox (3.52155pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 descend below the base-line. The second character may be ' L' f or " left" , ' Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 C' for " centre" , or ' R' for " right" , and specifies the hor izontal location Overfull \hbox (3.52155pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of the reference position. If the string has less than 2 charac ters then ' C' Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 upx - The x component of the up-vector for the text. If nec essary the supplied Overfull \hbox (36.8509pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements [309] Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 upy - The y component of the up-vector for the text. If nec essary the supplied Overfull \hbox (36.8509pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " TxExt" function returns the corners of a box which woul d enclose the supplied Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 character string if it were displayed using the Text function d escribed above. The Overfull \hbox (47.13998pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 returned box includes any leading or trailing spaces. It requir es the following interface: Overfull \hbox (5.78378pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int TxExt( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 gr fcon, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, float x, float y, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 just, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 just - A character string which specifies the location with in the text string Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 which is to be placed at the reference position given by x and y. See " Text" Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 xb - An array of 4 elements in which to return the x coordi nate of each corner Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 yb - An array of 4 elements in which to return the y coordi nate of each corner [310] LaTeX Warning: Hyper reference `Plot' on page 311 undefined on input line 18399 . LaTeX Warning: Hyper reference `Plot3D' on page 311 undefined on input line 183 99. LaTeX Warning: Hyper reference `RootCorner' on page 311 undefined on input line 18399. Overfull \hbox (47.61078pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 If the supplied Plot is a Plot3D, the axes will be annotate d using three 2-dimensional Overfull \hbox (21.36719pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 Plots, one for each 2D plane in the 3D current coordinate syste m. The plots will Overfull \hbox (21.36719pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 be " pasted" onto 3 faces of the cuboid graphics volume specifi ed when the Plot3D Overfull \hbox (0.10988pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 was constructed. The faces to be used can be controlled by the " RootCorner" LaTeX Warning: Hyper reference `Frame' on page 311 undefined on input line 1839 9. Overfull \hbox (0.37231pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 An error results if either the current Frame or the base Fr ame of the Plot is LaTeX Warning: Hyper reference `TranForward' on page 311 undefined on input lin e 18399. LaTeX Warning: Hyper reference `TranInverse' on page 311 undefined on input lin e 18399. Overfull \hbox (10.86975pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames Overfull \hbox (0.37231pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 of the Plot is not defined in either direction (i.e. the Plot' s TranForward [311] LaTeX Warning: Hyper reference `Plot' on page 312 undefined on input line 18466 . LaTeX Warning: Hyper reference `astGrid' on page 312 undefined on input line 18 466. LaTeX Warning: Hyper reference `Mapping' on page 312 undefined on input line 18 466. LaTeX Warning: Hyper reference `astClip' on page 312 undefined on input line 18 466. LaTeX Warning: Hyper reference `Naxes' on page 312 undefined on input line 1846 6. Overfull \hbox (15.85603pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 The index of the Plot axis whose physical coordinate value is t o be varied along Overfull \hbox (5.62103pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 the length of the curve (all other coordinates will remain fixe d). This value Overfull \hbox (42.09962pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (26.35347pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 The length of curve to be drawn, given as an increment along th e selected physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 18466--18466 [][]\T1/cmtt/m/n/10 No curve is drawn if the " start" array contains any coordi nates with the value LaTeX Warning: Hyper reference `Frame' on page 312 undefined on input line 1846 6. LaTeX Warning: Hyper reference `TranInverse' on page 312 undefined on input lin e 18466. Overfull \hbox (10.86975pt too wide) in paragraph at lines 18466--18466 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [312] LaTeX Warning: Hyper reference `GrismMap' on page 313 undefined on input line 1 8533. LaTeX Warning: Hyper reference `Mapping' on page 313 undefined on input line 18 533. LaTeX Warning: Hyper reference `GrismWaveR' on page 313 undefined on input line 18533. LaTeX Warning: Hyper reference `GrismNRP' on page 313 undefined on input line 1 8533. LaTeX Warning: Hyper reference `GrismG' on page 313 undefined on input line 185 33. LaTeX Warning: Hyper reference `astSet' on page 313 undefined on input line 185 33. Overfull \hbox (10.86975pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Gr ismMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 18533--18533 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 313 undefined on input line 185 33. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18533--18533 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [313] LaTeX Warning: Hyper reference `Object' on page 314 undefined on input line 185 81. Overfull \hbox (10.60732pt too wide) in paragraph at lines 18581--18581 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [314] LaTeX Warning: Hyper reference `Table' on page 315 undefined on input line 1861 8. LaTeX Warning: Hyper reference `astAddColumn' on page 315 undefined on input li ne 18618. Overfull \hbox (15.85603pt too wide) in paragraph at lines 18618--18618 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces [315] LaTeX Warning: Hyper reference `Table' on page 316 undefined on input line 1865 5. LaTeX Warning: Hyper reference `astAddParameter' on page 316 undefined on input line 18655. Overfull \hbox (31.60219pt too wide) in paragraph at lines 18655--18655 \T1/cmtt/m/n/10 The character string holding the upper case name of the paramet er. Trailing spaces [316] LaTeX Warning: Hyper reference `Object' on page 317 undefined on input line 186 85. LaTeX Warning: Hyper reference `astEnd' on page 317 undefined on input line 186 85. [317] LaTeX Warning: Hyper reference `Frame' on page 318 undefined on input line 1877 5. LaTeX Warning: Hyper reference `SkyFrame' on page 318 undefined on input line 1 8775. Overfull \hbox (28.71822pt too wide) in paragraph at lines 18775--18775 []\T1/cmtt/m/n/10 void astIntersect( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const double a1[2], const double a2[2], const double LaTeX Warning: Hyper reference `Naxes' on page 318 undefined on input line 1877 5. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (1.94693pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (7.19565pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (1.94693pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the second geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (31.86462pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 For SkyFrames each curve will be a great circle, and in gen eral each pair of curves Overfull \hbox (0.10988pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 will intersect at two diametrically opposite points on the sky. The returned Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input Overfull \hbox (0.37231pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 coordinates has this value, or if the two points defining eithe r geodesic are LaTeX Warning: Hyper reference `astDistance' on page 318 undefined on input lin e 18775. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between [318] LaTeX Warning: Hyper reference `Interval' on page 319 undefined on input line 1 8908. LaTeX Warning: Hyper reference `Region' on page 319 undefined on input line 189 08. LaTeX Warning: Hyper reference `Frame' on page 319 undefined on input line 1890 8. LaTeX Warning: Hyper reference `SkyFrame' on page 319 undefined on input line 1 8908. LaTeX Warning: Hyper reference `Box' on page 319 undefined on input line 18908. Overfull \hbox (10.55888pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 AstInterval $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astInterval ( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const double lbnd[], co nst double ubnd[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame LaTeX Warning: Hyper reference `Naxes' on page 319 undefined on input line 1890 8. Overfull \hbox (42.09962pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the lower limits on each axis. Set a value to AST__BAD to indic ate that the axis Overfull \hbox (42.09962pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the upper limits on each axis. Set a value to AST__BAD to indic ate that the axis Overfull \hbox (47.34834pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 with the boundary of the Interval being created. The uncertaint y in any point Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 on the boundary of the Interval is found by shifting the suppli ed " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the LaTeX Warning: Hyper reference `Circle' on page 319 undefined on input line 189 08. LaTeX Warning: Hyper reference `Ellipse' on page 319 undefined on input line 18 908. LaTeX Warning: Hyper reference `Prism' on page 319 undefined on input line 1890 8. LaTeX Warning: Hyper reference `Object' on page 319 undefined on input line 189 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (26.09103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 will have no effect on the created Interval. Alternatively, a N ULL Object pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box LaTeX Warning: Hyper reference `astOverlap' on page 319 undefined on input line 18908. LaTeX Warning: Hyper reference `astSimplify' on page 319 undefined on input lin e 18908. Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [319] LaTeX Warning: Hyper reference `astSet' on page 320 undefined on input line 189 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new In terval. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 18908--18908 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [320] LaTeX Warning: Hyper reference `IntraMap' on page 321 undefined on input line 1 9000. LaTeX Warning: Hyper reference `Mapping' on page 321 undefined on input line 19 000. LaTeX Warning: Hyper reference `astIntraReg' on page 321 undefined on input lin e 19000. Overfull \hbox (5.52135pt too wide) in paragraph at lines 19000--19000 []\T1/cmtt/m/n/10 AstIntraMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astIntraMap ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int nin, int nout, con st char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the transformation Overfull \hbox (17.69308pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 function to use (which should previously have been registered u sing astIntraReg). Overfull \hbox (26.35347pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 The number of input coordinates. This must be compatible with t he number of input Overfull \hbox (37.11334pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 coordinates accepted by the transformation function (as specifi ed when this function Overfull \hbox (0.10988pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 The number of output coordinates. This must be compatible with the number of Overfull \hbox (0.37231pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 output coordinates produced by the transformation function (as specified when LaTeX Warning: Hyper reference `astSet' on page 321 undefined on input line 190 00. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new In traMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19000--19000 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 321 undefined on input line 190 00. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19000--19000 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [321] [322] LaTeX Warning: Hyper reference `IntraMap' on page 323 undefined on input line 1 9183. LaTeX Warning: Hyper reference `Mapping' on page 323 undefined on input line 19 183. LaTeX Warning: Hyper reference `astIntraMap' on page 323 undefined on input lin e 19183. LaTeX Warning: Hyper reference `Channel' on page 323 undefined on input line 19 183. Overfull \hbox (5.78378pt too wide) in paragraph at lines 19183--19183 []\T1/cmtt/m/n/10 astIntraReg( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int nin, int nout, void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 tran)( A stMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 , int, Overfull \hbox (26.77866pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 int, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 [], int , int, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 [] ), unsigned int flags, c onst char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 purpose, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing a unique name to be associated Overfull \hbox (48.92296pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 with the transformation function in order to identify it. This name is case sensitive. Overfull \hbox (26.35347pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 The number of input coordinates accepted by the transformation function (i.e. the Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 number of dimensions of the space in which the input points res ide). A value Overfull \hbox (21.10475pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of AST__ANY may be given if the function is able to accommodate a variable number Overfull \hbox (1.6845pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 The number of output coordinates produced by the transformation function (i.e. Overfull \hbox (26.6159pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the number of dimensions of the space in which the output point s reside). A value Overfull \hbox (0.10988pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of AST__ANY may be given if the function is able to produce a v ariable number LaTeX Warning: Hyper reference `astTranP' on page 323 undefined on input line 1 9183. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to the transformation function to be registered. This f unction should Overfull \hbox (42.36206pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 perform whatever coordinate transformations are required and sh ould have an interface Overfull \hbox (21.10475pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 This value may be used to supply a set of flags which describe the transformation Overfull \hbox (23.99155pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function and which may affect the behaviour of any IntraMap whi ch uses it. Often, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 a value of zero will be given here, but you may also supply the bitwise OR of Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing a short (one lin e) textual comment Overfull \hbox (73.85437pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the author of the transformation Overfull \hbox (0.10988pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing contact details for the author Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of the transformation function (e.g. an e-mail or WWW address). If any IntraMap Overfull \hbox (5.3586pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses this transformation function is exported as part of a dataset to an Overfull \hbox (26.6159pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 external user who does not have access to the function, then th ese contact details [323] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 Beware that an external representation of an IntraMap (crea ted by writing it to Overfull \hbox (18.74283pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 a Channel) will not include the coordinate transformation funct ion which it uses, Overfull \hbox (7.19565pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 so will only refer to the function by its name (as assigned usi ng astIntraReg). Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Consequently, the external representation cannot be utilised by another program Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 unless that program has also registered the same transformation function with Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the same name using an identical invocation of astIntraReg. If no such registration Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 has been performed, then attempting to read the external repres entation will result Overfull \hbox (16.11847pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 You may use astIntraReg to register a transformation functi on with the same name Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 more than once, but only if the arguments supplied are identica l on each occasion Overfull \hbox (57.58334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 (i.e there is no way of changing things once a function has bee n successfully registered Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 under a given name, and attempting to do so will result in an e rror). This feature Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 simply allows registration to be performed independently, but c onsistently, at Overfull \hbox (26.35347pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 several places within your program, without having to check whe ther it has already LaTeX Warning: Hyper reference `astSetStatus' on page 324 undefined on input li ne 19183. Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 If an error occurs in the transformation function, this may be indicated by setting Overfull \hbox (1.94693pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the AST error status to an error value (using astSetStatus) bef ore it returns. Overfull \hbox (47.34834pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 This will immediately terminate the current AST operation. The error value AST__ITFER Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 is available for this purpose, but other values may also be use d (e.g. if you Overfull \hbox (18.0096pt too wide) in paragraph at lines 19183--19183 []\T1/cmtt/m/n/10 The following flags are defined in the ``ast.h' ' header file and allow you to provide Overfull \hbox (18.27203pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 further information about the nature of the transformation func tion. Having selected Overfull \hbox (18.27203pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the set of flags which apply, you should supply the bitwise OR of their values as the LaTeX Warning: Hyper reference `TranForward' on page 324 undefined on input lin e 19183. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__NOFWD: If this flag is set, it indicates that the tran sformation function Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 does not implement a forward coordinate transformation. In this case, any IntraMap Overfull \hbox (36.8509pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses it will have a TranForward attribute value of zero a nd the transformation Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function itself will not be invoked with its ``forward' ' argum ent set to a non-zero LaTeX Warning: Hyper reference `TranInverse' on page 324 undefined on input lin e 19183. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__NOINV: If this flag is set, it indicates that the tran sformation function Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 does not implement an inverse coordinate transformation. In thi s case, any IntraMap Overfull \hbox (36.8509pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses it will have a TranInverse attribute value of zero a nd the transformation Overfull \hbox (1.94693pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function itself will not be invoked with its ``forward' ' argum ent set to zero. LaTeX Warning: Hyper reference `UnitMap' on page 324 undefined on input line 19 183. LaTeX Warning: Hyper reference `astSimplify' on page 324 undefined on input lin e 19183. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__SIMPFI: You may set this flag if applying the transfor mation function' s Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 transformation, should always restore the original set of coord inates. It indicates Overfull \hbox (41.31232pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 that AST may replace such a sequence of operations by an identi ty Mapping (a UnitMap) Overfull \hbox (33.43924pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using astSimplify). Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__SIMPIF: You may set this flag if applying the transfor mation function' s Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 transformation, should always restore the original set of coord inates. It indicates Overfull \hbox (41.31232pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 that AST may replace such a sequence of operations by an identi ty Mapping (a UnitMap) Overfull \hbox (33.43924pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using astSimplify). [324] [325] LaTeX Warning: Hyper reference `Mapping' on page 326 undefined on input line 19 208. LaTeX Warning: Hyper reference `Invert' on page 326 undefined on input line 192 08. [326] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. LaTeX Warning: Hyper reference `Object' on page 327 undefined on input line 192 71. LaTeX Warning: Hyper reference `Class' on page 327 undefined on input line 1927 1. Overfull \hbox (3.47949pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 One if the Object belongs to the class called $\OML/zplm/m/it/1 0 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 (or to a class d erived from LaTeX Warning: Hyper reference `Frame' on page 327 undefined on input line 1927 1. Underfull \hbox (badness 10000) in paragraph at lines 19271--19271 Underfull \hbox (badness 10000) in paragraph at lines 19271--19271 [] \T1/cmtt/m/n/10 Tests whether Object " obj" is a member of the Frame class, or of any class Overfull \hbox (23.27441pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 Every AST class provides a function (astIsA$\OML/zplm/m/it/ 10 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ) of this form, where $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$ Overfull \hbox (8.24539pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Overfull \hbox (21.36719pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function should fa il for any reason. In Overfull \hbox (10.86975pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 particular, it will fail if the pointer supplied does not ident ify an Object of [327] LaTeX Warning: Hyper reference `KeyMap' on page 328 undefined on input line 193 46. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 328 undefined on inp ut line 19346. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 328 undefined on inp ut line 19346. LaTeX Warning: Hyper reference `KeyCase' on page 328 undefined on input line 19 346. LaTeX Warning: Hyper reference `Object' on page 328 undefined on input line 193 46. LaTeX Warning: Hyper reference `Mapping' on page 328 undefined on input line 19 346. LaTeX Warning: Hyper reference `astSet' on page 328 undefined on input line 193 46. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ke yMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19346--19346 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 19346--19346 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 19346--19346 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [328] LaTeX Warning: Hyper reference `Mapping' on page 329 undefined on input line 19 456. Overfull \hbox (18.90558pt too wide) in paragraph at lines 19456--19456 []\T1/cmtt/m/n/10 int astLinearApprox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 lbnd, const d ouble $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ubnd, double LaTeX Warning: Hyper reference `Nin' on page 329 undefined on input line 19456. Overfull \hbox (26.6159pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the lower bounds of a box defined within Overfull \hbox (21.10475pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the input coordinate system of the Mapping. The number of eleme nts in this array Overfull \hbox (15.85603pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 should equal the value of the Mapping' s Nin attribute. This bo x should specify Overfull \hbox (16.11847pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 [] \T1/cmtt/m/n/10 The maximum permitted deviation from linearity, expressed as a positive Cartesian Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 displacement in the output coordinate space of the Mapping. If a linear fit to Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the forward transformation of the Mapping deviates from the tru e transformation Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 by more than this amount at any point which is tested, then no fit coefficients LaTeX Warning: Hyper reference `Nout' on page 329 undefined on input line 19456 . Overfull \hbox (21.10475pt too wide) in paragraph at lines 19456--19456 [] \T1/cmtt/m/n/10 Pointer to an array of doubles in which to return the co- efficients of the linear Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 approximation to the specified transformation. This array shoul d have at least Overfull \hbox (40.42569pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 " ( Nin $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 1 ) $\OMS/zplm/m/n /10 ^^C$ \T1/cmtt/m/n/10 Nout" , elements. The first Nout elements hold the con stant offsets Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 for the transformation outputs. The remaining elements hold the gradients. So Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 if the Mapping has 2 inputs and 3 outputs the linear approximat ion to the forward Overfull \hbox (4.1005pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 If the forward transformation is sufficiently linear, a non-zer o value is returned. LaTeX Warning: Hyper reference `astInvert' on page 329 undefined on input line 19456. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 This function fits the Mapping' s forward transformation. T o fit the inverse Overfull \hbox (5.62103pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using astInvert before invoking Overfull \hbox (0.37231pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 If a Mapping output is found to have a bad value (AST__BAD) at one or more of Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the test points used in the linearity test, then all the values in the returned Overfull \hbox (5.62103pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 fit that correspond to that output are set to AST__BAD. However , this does not Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 affect the linearity tests on the other Mapping outputs - if th ey are all found Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 to be linear then usable coefficients will be returned for them in the fit, and Overfull \hbox (0.10988pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the function will return a non-zero value. Consequently, it may be necessary Overfull \hbox (12.44437pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 to check that the values in the returned fit are not AST__BAD b efore using them. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 If all Mapping outputs generate bad values, then zero is return ed as the function [329] Overfull \hbox (26.35347pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [330] LaTeX Warning: Hyper reference `Object' on page 331 undefined on input line 195 34. LaTeX Warning: Hyper reference `astUnlock' on page 331 undefined on input line 19534. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 If the Object is curently locked by another thread then this fu nction will either Overfull \hbox (37.11334pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 report an error or block. If a non-zero value is supplied for " wait" , the calling Overfull \hbox (5.3586pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 thread waits until the object is available for it to use. Other wise, an error Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 is reported and the function returns immediately without lockin g the Object. LaTeX Warning: Hyper reference `astAnnul' on page 331 undefined on input line 1 9534. Overfull \hbox (31.86462pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 The astAnnul function is exceptional in that it can be used on pointers for Objects Overfull \hbox (0.37231pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 that are not currently locked by the calling thread. All other AST functions Overfull \hbox (31.86462pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 This function returns without action if the Object is alrea dy locked by the calling LaTeX Warning: Hyper reference `astCopy' on page 331 undefined on input line 19 534. Overfull \hbox (26.35347pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 If simultaneous use of the same object is required by two o r more threads, astCopy Overfull \hbox (0.37231pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 should be used to to produce a deep copy of the Object for each thread. Each Overfull \hbox (16.11847pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 copy should then be unlocked by the parent thread (i.e. the thr ead that created Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 the copy), and then locked by the child thread (i.e. the thread that wants to Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 This function returns without action if the AST library has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [331] LaTeX Warning: Hyper reference `LutMap' on page 332 undefined on input line 196 45. LaTeX Warning: Hyper reference `Mapping' on page 332 undefined on input line 19 645. Overfull \hbox (7.72334pt too wide) in paragraph at lines 19645--19645 []\T1/cmtt/m/n/10 AstLutMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astLutMap( in t nlut, const double lut[], double start, double inc, const Overfull \hbox (36.8509pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 The lookup table spacing (the increment in input coordinate val ue between successive Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 lookup table entries). This value may be positive or negative, but must not be LaTeX Warning: Hyper reference `astSet' on page 332 undefined on input line 196 45. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Lu tMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `TranInverse' on page 332 undefined on input lin e 19645. Overfull \hbox (26.6159pt too wide) in paragraph at lines 19645--19645 [][]\T1/cmtt/m/n/10 If the entries in the lookup table either increase or decre ase monotonically, then Overfull \hbox (21.36719pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the new LutMap' s TranInverse attribute will have a value of on e, indicating that Overfull \hbox (0.37231pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the inverse transformation can be performed. Otherwise, it will have a value Overfull \hbox (0.37231pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of zero, so that any attempt to use the inverse transformation will result in [332] LaTeX Warning: Hyper reference `Object' on page 333 undefined on input line 196 45. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19645--19645 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 19645--19645 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [333] LaTeX Warning: Hyper reference `Mapping' on page 334 undefined on input line 19 788. Overfull \hbox (18.22078pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 void astMapBox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, const double lbnd_in[], const double ubnd_in[], int Overfull \hbox (13.44568pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 forward, int coord_out, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 lbnd_out, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ubnd_out, double x l[], double xu[] Overfull \hbox (22.9418pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to an array of double, with one element for each Mappin g input coordinate. Overfull \hbox (22.9418pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to an array of double, with one element for each Mappin g input coordinate. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 Note that it is permissible for the upper bound to be less th an the corresponding Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 If this value is non-zero, then the Mapping' s forward transfor mation will be Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 used to transform the input box. Otherwise, its inverse transfo rmation will be LaTeX Warning: Hyper reference `Nout' on page 334 undefined on input line 19788 . Overfull \hbox (41.83719pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 (If the inverse transformation is selected, then references t o " input" and " output" Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinates in this description should be transposed. For examp le, the size of Overfull \hbox (29.24026pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 the " lbnd_in" and " ubnd_in" arrays should match the number of output coordinates, Overfull \hbox (23.99155pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 as given by the Mapping' s Nout attribute. Similarly, the " coo rd_out" parameter, Overfull \hbox (38.42552pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 The index of the output coordinate for which the lower and uppe r bounds are required. Overfull \hbox (26.35347pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 This value should be at least one, and no larger than the numbe r of Mapping output Overfull \hbox (5.62103pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to a double in which to return the lowest value taken b y the nominated Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 [] \T1/cmtt/m/n/10 An optional pointer to an array of double, with one eleme nt for each Mapping input Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinate. If given, this array will be filled with the coordi nates of an input Overfull \hbox (52.8595pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [334] Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 [] \T1/cmtt/m/n/10 An optional pointer to an array of double, with one eleme nt for each Mapping input Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinate. If given, this array will be filled with the coordi nates of an input Overfull \hbox (52.8595pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate Overfull \hbox (16.11847pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 Any input points which are transformed by the Mapping to gi ve output coordinates Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 containing the value AST__BAD are regarded as invalid and are i gnored. They will Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 make no contribution to determining the output bounds, even alt hough the nominated Overfull \hbox (2.99667pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 An error will occur if the required output bounds cannot be found. Typically, Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 this might happen if all the input points which the function co nsiders turn out Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 to be invalid (see above). The number of points considered befo re generating Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 such an error is quite large, so this is unlikely to occur by a ccident unless Overfull \hbox (17.43065pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 valid points are restricted to a very small subset of the input coordinate space. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 The values returned via " lbnd_out" , " ubnd_out" , " xl" a nd " xu" will be set Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 to the value AST__BAD if this function should fail for any reas on. Their initial Overfull \hbox (20.84232pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 values on entry will not be altered if the function is invoked with the AST error [335] LaTeX Warning: Hyper reference `KeyMap' on page 336 undefined on input line 198 34. Overfull \hbox (31.86462pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 Entries from the source KeyMap will replace any existing en tries in the destination Overfull \hbox (10.60732pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 The one exception to the above rule is that if a source ent ry contains a scalar Overfull \hbox (5.62103pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 KeyMap entry, and the destination contains a scalar KeyMap entr y with the same Overfull \hbox (26.35347pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 key, then the source KeyMap entry will be copied into the desti nation KeyMap entry Overfull \hbox (7.19565pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 using this function, rather than simply replacing the destinati on KeyMap entry. LaTeX Warning: Hyper reference `MapLocked' on page 336 undefined on input line 19834. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 If the destination entry has a non-zero value for its MapLo cked attribute, then Overfull \hbox (36.8509pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [336] LaTeX Warning: Hyper reference `KeyMap' on page 337 undefined on input line 198 72. LaTeX Warning: Hyper reference `astMapHasKey' on page 337 undefined on input li ne 19872. LaTeX Warning: Hyper reference `KeyCase' on page 337 undefined on input line 19 872. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase Overfull \hbox (7.51216pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name is prese nt in the KeyMap and [337] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. LaTeX Warning: Hyper reference `KeyMap' on page 338 undefined on input line 199 99. LaTeX Warning: Hyper reference `KeyCase' on page 338 undefined on input line 19 999. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase LaTeX Warning: Hyper reference `astMapPutU' on page 338 undefined on input line 19999. Overfull \hbox (10.60732pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 A pointer to a buffer in which to return the requested value. I f the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see astMapPutU), Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (29.24026pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 exit. For pointer types (" A" and " C" ), the buffer should be a suitable pointer, Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 and the address of this pointer should be supplied as the " val ue" parameter. Overfull \hbox (7.51216pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (0.10988pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied buffer Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 If the stored value is a vector value, then the first value in the vector will LaTeX Warning: Hyper reference `astFree' on page 338 undefined on input line 19 999. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 A string pointer returned by astMapGet0C is guaranteed to r emain valid and the Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 string to which it points will not be over-written for a total of 50 successive Overfull \hbox (10.60732pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 invocations of this function. After this, the memory containing the string may Overfull \hbox (0.10988pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 be re-used, so a copy of the string should be made if it is nee ded for longer Overfull \hbox (5.3586pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer LaTeX Warning: Hyper reference `Object' on page 338 undefined on input line 199 99. LaTeX Warning: Hyper reference `astAnnul' on page 338 undefined on input line 1 9999. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 If the returned value is an AST Object pointer, the Object' s reference count Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 is incremented by this call. Any subsequent changes made to the Object using Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 the returned pointer will be reflected in any any other active pointers for the Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 Object. The returned pointer should be annulled using astAnnul when it is no [338] Overfull \hbox (8.46577pt too wide) in paragraph at lines 19999--19999 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 name astMapGet0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (2.52588pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 For example, astMapGet0D would be used to get a " double" value , while astMapGet0I [339] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. LaTeX Warning: Hyper reference `KeyMap' on page 340 undefined on input line 201 43. Overfull \hbox (15.56409pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 int astMapGet1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zpl m/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int mxval, int $\OMS /zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nval, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\ OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type Overfull \hbox (32.23856pt too wide) in paragraph at lines 20143--20143 \OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value ) int astMapGet1C( AstKeyMap $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 key, int l, int mxval, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nval, LaTeX Warning: Hyper reference `KeyCase' on page 340 undefined on input line 20 143. Overfull \hbox (15.85603pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase Overfull \hbox (5.3586pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the LaTeX Warning: Hyper reference `astMapPutU' on page 340 undefined on input line 20143. Overfull \hbox (15.85603pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 A pointer to an array in which to return the requested values. If the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see astMapPutU), Overfull \hbox (5.62103pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (7.51216pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20143--20143 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (21.36719pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied array will Overfull \hbox (0.37231pt too wide) in paragraph at lines 20143--20143 [][]\T1/cmtt/m/n/10 If the stored value is a scalar value, then the value will be returned in the Overfull \hbox (49.23947pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 The " value" buffer supplied to the astMapGet1C function shou ld be a pointer to a character Overfull \hbox (2.73706pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 array with " mxval$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l" elem ents, where " l" is the maximum length of a string to be Overfull \hbox (23.52075pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 returned. The value of " l" should be supplied as an extra para meter following " key" Overfull \hbox (14.3355pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 when invoking astMapGet1C, and should include space for a termi nating null character. [340] Overfull \hbox (8.46577pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 name astMapGet1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (28.76947pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 For example, astMapGet1D would be used to get " double" values, while astMapGet1I would Overfull \hbox (23.52075pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 be used to get " int" values, etc. For D or I, the supplied " v alue" parameter should Overfull \hbox (39.2669pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 be a pointer to an array of doubles or ints, with " mxval" elem ents. For C, the supplied Overfull \hbox (20.05783pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 " value" parameter should be a pointer to a character string wi th " mxval$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l" elements. Overfull \hbox (7.7746pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 For A, the supplied " value" parameter should be a pointer to a n array of AstObject [341] LaTeX Warning: Hyper reference `KeyMap' on page 342 undefined on input line 202 13. LaTeX Warning: Hyper reference `KeyCase' on page 342 undefined on input line 20 213. Overfull \hbox (15.85603pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase LaTeX Warning: Hyper reference `astMapPutU' on page 342 undefined on input line 20213. Overfull \hbox (36.8509pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 Address at which to return a pointer to the required string val ue. If the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see astMapPutU), Overfull \hbox (7.51216pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20213--20213 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (0.10988pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied buffer LaTeX Warning: Hyper reference `astFree' on page 342 undefined on input line 20 213. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20213--20213 [][]\T1/cmtt/m/n/10 The string pointer returned by astMapGetC is guaranteed to remain valid and the Overfull \hbox (10.86975pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 string to which it points will not be over-written for a total of 50 successive Overfull \hbox (10.60732pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 invocations of this function. After this, the memory containing the string may Overfull \hbox (0.10988pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 be re-used, so a copy of the string should be made if it is nee ded for longer Overfull \hbox (5.3586pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer [342] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. LaTeX Warning: Hyper reference `KeyMap' on page 343 undefined on input line 203 44. Overfull \hbox (5.06665pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 int astMapGetElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/ zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int elem, $\OML/z plm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type $\OMS/ zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value Overfull \hbox (13.65686pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 ) int astMapGetElemC( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int l, int e lem, char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value LaTeX Warning: Hyper reference `KeyCase' on page 343 undefined on input line 20 344. Overfull \hbox (15.85603pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase Overfull \hbox (0.10988pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 The index of the required vector element, starting at zero. An error will be LaTeX Warning: Hyper reference `astMapPutU' on page 343 undefined on input line 20344. Overfull \hbox (10.60732pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 A pointer to a buffer in which to return the requested value. I f the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see astMapPutU), Overfull \hbox (5.62103pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (7.51216pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20344--20344 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 or if it has an undefined value, but a zero value will be retur ned as the function Overfull \hbox (2.26344pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 The " value" buffer supplied to the astMapGetElemC function s hould be a pointer to Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 a character array with " l" elements, where " l" is the maximum length of the string Overfull \hbox (18.27203pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 to be returned. The value of " l" should be supplied as an extr a parameter following Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 " key" when invoking astMapGetElemC, and should include space f or a terminating null Overfull \hbox (8.46577pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (24.47437pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 name astMapGetElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to matc h the data type [343] Overfull \hbox (34.01819pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 For example, astMapGetElemD would be used to get a " double" va lue, while astMapGetElemI Overfull \hbox (28.2446pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 would be used to get an " int" value, etc. For D or I, the supp lied " value" parameter Overfull \hbox (23.52075pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 should be a pointer to a double or int. For C, the supplied " v alue" parameter should Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 be a pointer to a character string with " l" elements. For A, t he supplied " value" [344] LaTeX Warning: Hyper reference `KeyMap' on page 345 undefined on input line 203 96. LaTeX Warning: Hyper reference `KeyCase' on page 345 undefined on input line 20 396. Overfull \hbox (12.18193pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e KeyCase attribute LaTeX Warning: Hyper reference `astMapDefined' on page 345 undefined on input l ine 20396. Overfull \hbox (26.6159pt too wide) in paragraph at lines 20396--20396 [][]\T1/cmtt/m/n/10 A non-zero function value is returned if the key exists but has an undefined value Overfull \hbox (10.34488pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 (that is, the returned value does not depend on whether the ent ry has a defined Overfull \hbox (5.3586pt too wide) in paragraph at lines 20396--20396 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [345] LaTeX Warning: Hyper reference `KeyMap' on page 346 undefined on input line 204 56. LaTeX Warning: Hyper reference `astMapSize' on page 346 undefined on input line 20456. LaTeX Warning: Hyper reference `SortBy' on page 346 undefined on input line 204 56. Overfull \hbox (26.09103pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 The index into the KeyMap. The first entry has index zero, and the last has index Overfull \hbox (0.37231pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 " size-1" , where " size" is the value returned by the astMapSi ze function. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20456--20456 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 20456--20456 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [346] LaTeX Warning: Hyper reference `KeyMap' on page 347 undefined on input line 205 08. LaTeX Warning: Hyper reference `KeyCase' on page 347 undefined on input line 20 508. Overfull \hbox (12.18193pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e KeyCase attribute Overfull \hbox (23.25832pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The length (i.e. number of characters) of the longest formatted value associated with Overfull \hbox (21.36719pt too wide) in paragraph at lines 20508--20508 [][]\T1/cmtt/m/n/10 A function value of zero will be returned without error if the named entry cannot Overfull \hbox (5.3586pt too wide) in paragraph at lines 20508--20508 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [347] LaTeX Warning: Hyper reference `KeyMap' on page 348 undefined on input line 205 53. LaTeX Warning: Hyper reference `KeyCase' on page 348 undefined on input line 20 553. Overfull \hbox (12.18193pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e KeyCase attribute Overfull \hbox (7.51216pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The length of the entry. One for a scalar, greater than one for a vector. A value Overfull \hbox (5.3586pt too wide) in paragraph at lines 20553--20553 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [348] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. LaTeX Warning: Hyper reference `KeyMap' on page 349 undefined on input line 206 63. Overfull \hbox (46.79396pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 void astMapPut0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 comment LaTeX Warning: Hyper reference `KeyCase' on page 349 undefined on input line 20 663. Overfull \hbox (31.33975pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 A character string to be stored with the value, which can later be used to identify Overfull \hbox (0.37231pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 the value. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (20.84232pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 The value to be stored. The data type of this value should matc h the 1-character Overfull \hbox (16.11847pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 type code appended to the function name (e.g. if you are using astMapPut0A, the Overfull \hbox (26.09103pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the value. A NULL Overfull \hbox (10.86975pt too wide) in paragraph at lines 20663--20663 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the ne w value will replace LaTeX Warning: Hyper reference `Object' on page 349 undefined on input line 206 63. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20663--20663 [][]\T1/cmtt/m/n/10 If the stored value is an AST Object pointer, the Object' s reference count is Overfull \hbox (5.62103pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 incremented by this call. Any subsequent changes made to the Ob ject using the Overfull \hbox (29.24026pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 returned pointer will be reflected in any any other active poin ters for the Object, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 including any obtained later using astMapget0A. The reference c ount for the Object Overfull \hbox (63.0945pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 will be decremented when the KeyMap is destroyed, or the entry is removed or over-written Overfull \hbox (8.46577pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 name astMapPut0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type [349] Overfull \hbox (13.02332pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 For example, astMapPut0D would be used to store a " double" val ue, while astMapPut0I LaTeX Warning: Hyper reference `astShow' on page 350 undefined on input line 20 663. LaTeX Warning: Hyper reference `astWrite' on page 350 undefined on input line 2 0663. Overfull \hbox (7.98578pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 Note that KeyMaps containing generic " void $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " pointers cannot be written out using [350] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. LaTeX Warning: Hyper reference `KeyMap' on page 351 undefined on input line 207 67. Overfull \hbox (33.46098pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 void astMapPut1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int size, const $\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type va lue[], LaTeX Warning: Hyper reference `KeyCase' on page 351 undefined on input line 20 767. Overfull \hbox (36.58847pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 A character string to be stored with the values, which can late r be used to identify Overfull \hbox (5.62103pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 the values. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (10.60732pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 The array of values to be stored. The data type of this value s hould match the Overfull \hbox (55.22142pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 1-character type code appended to the function name (e.g. if yo u are using astMapPut1A, Overfull \hbox (5.09616pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the values. A Overfull \hbox (16.11847pt too wide) in paragraph at lines 20767--20767 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the ne w values will replace Overfull \hbox (8.46577pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 name astMapPut1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (7.7746pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I LaTeX Warning: Hyper reference `astShow' on page 351 undefined on input line 20 767. LaTeX Warning: Hyper reference `astWrite' on page 351 undefined on input line 2 0767. Overfull \hbox (7.98578pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 Note that KeyMaps containing generic " void $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " pointers cannot be written out using [351] [352] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. LaTeX Warning: Hyper reference `KeyMap' on page 353 undefined on input line 208 92. Overfull \hbox (4.59303pt too wide) in paragraph at lines 20892--20892 []\T1/cmtt/m/n/10 void astMapPutElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML /zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int elem, $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value LaTeX Warning: Hyper reference `KeyCase' on page 353 undefined on input line 20 892. Overfull \hbox (15.85603pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase Overfull \hbox (23.52075pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 If the " elem" index is outside the range of the vector, the le ngth of the vector will Overfull \hbox (7.7746pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 be increased by one element and the supplied value will be stor ed at the end of the LaTeX Warning: Hyper reference `Table' on page 353 undefined on input line 2089 2. LaTeX Warning: Hyper reference `astAddColumn' on page 353 undefined on input li ne 20892. Overfull \hbox (4.1005pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 If the " elem" index is outside the range of the vector, an err or will be reported. Overfull \hbox (28.50703pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 The number of elements in each cell of a column is specified wh en the column is created Overfull \hbox (5.3586pt too wide) in paragraph at lines 20892--20892 [][]\T1/cmtt/m/n/10 If the entry originally holds a scalar value, it will be tr eated like a vector Overfull \hbox (0.37231pt too wide) in paragraph at lines 20892--20892 [][]\T1/cmtt/m/n/10 If the specified key cannot be found in the given KeyMap, o r is found but has Overfull \hbox (21.36719pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 an undefined value, a new vector entry with the given name, and data type implied Overfull \hbox (8.46577pt too wide) in paragraph at lines 20892--20892 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (24.47437pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 name astMapPutElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to matc h the data type [353] Overfull \hbox (34.01819pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 For example, astMapPutElemD would be used to put a " double" va lue, while astMapPutElemI Overfull \hbox (28.2446pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 would be used to put an " int" value, etc. For D or I, the supp lied " value" parameter Overfull \hbox (23.25832pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 should be a double or int. For C, the supplied " value" paramet er should be a pointer Overfull \hbox (18.27203pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 to a character string. For A, the supplied " value" parameter s hould be an AstObject [354] LaTeX Warning: Hyper reference `KeyMap' on page 355 undefined on input line 209 42. LaTeX Warning: Hyper reference `MapLocked' on page 355 undefined on input line 20942. LaTeX Warning: Hyper reference `KeyCase' on page 355 undefined on input line 20 942. Overfull \hbox (31.33975pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 A character string to be stored with the value, which can later be used to identify Overfull \hbox (0.37231pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 the value. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (26.09103pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the value. A NULL Overfull \hbox (5.62103pt too wide) in paragraph at lines 20942--20942 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the va lue associated with [355] LaTeX Warning: Hyper reference `Region' on page 356 undefined on input line 210 10. LaTeX Warning: Hyper reference `Mapping' on page 356 undefined on input line 21 010. LaTeX Warning: Hyper reference `PermMap' on page 356 undefined on input line 21 010. LaTeX Warning: Hyper reference `MathMap' on page 356 undefined on input line 21 010. LaTeX Warning: Hyper reference `SphMap' on page 356 undefined on input line 210 10. Overfull \hbox (47.61078pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Pointer to a Mapping which transforms positions from the coordi nate system represented Overfull \hbox (42.36206pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 by the supplied Region to the coordinate system specified by " frame" . The supplied Overfull \hbox (63.35693pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Mapping should define both forward and inverse transformations, and these transformations Overfull \hbox (10.86975pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 should form a genuine inverse pair. That is, transforming a pos ition using the Overfull \hbox (10.86975pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 forward transformation and then using the inverse transformatio n should produce Overfull \hbox (41.31232pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 the original input position. Some Mapping classes (such as Perm Map, MathMap, SphMap) LaTeX Warning: Hyper reference `Frame' on page 356 undefined on input line 2101 0. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Pointer to a Frame describing the coordinate system in which th e new Region is Overfull \hbox (18.0096pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 A pointer to a new Region. This Region will represent the area within the coordinate Overfull \hbox (26.6159pt too wide) in paragraph at lines 21010--21010 [][]\T1/cmtt/m/n/10 The uncertainty associated with the supplied Region is modi fied using the supplied LaTeX Warning: Hyper reference `Object' on page 356 undefined on input line 210 10. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21010--21010 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [356] LaTeX Warning: Hyper reference `KeyMap' on page 357 undefined on input line 210 39. LaTeX Warning: Hyper reference `KeyCase' on page 357 undefined on input line 21 039. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21039--21039 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 21039--21039 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase [357] LaTeX Warning: Hyper reference `KeyMap' on page 358 undefined on input line 210 76. LaTeX Warning: Hyper reference `KeyCase' on page 358 undefined on input line 21 076. Overfull \hbox (5.3586pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 The character string identifying the entry to be renamed. Trail ing spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase Overfull \hbox (10.60732pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 The new character string to associated with the renamed entry. Trailing spaces Overfull \hbox (5.62103pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 are ignored. The supplied string is converted to upper case bef ore use if the [358] LaTeX Warning: Hyper reference `KeyMap' on page 359 undefined on input line 211 10. Overfull \hbox (5.3586pt too wide) in paragraph at lines 21110--21110 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [359] LaTeX Warning: Hyper reference `Mapping' on page 360 undefined on input line 21 193. Overfull \hbox (24.31422pt too wide) in paragraph at lines 21193--21193 []\T1/cmtt/m/n/10 void astMapSplit( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int nin, const int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 in, int $\ OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 out, AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$ \T1/cmtt/m/n/10 map LaTeX Warning: Hyper reference `Nin' on page 360 undefined on input line 21193. Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 [] \T1/cmtt/m/n/10 Pointer to an array holding the indices within the suppli ed Mapping of the inputs Overfull \hbox (17.43065pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 which are to be picked from the Mapping. This array should have " nin" elements. Overfull \hbox (31.86462pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 If " Nin" is the number of inputs of the supplied Mapping, then each element should Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Pointer to an array in which to return the indices of the outpu ts of the supplied Overfull \hbox (10.86975pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Mapping which are fed by the picked inputs. A value of one is u sed to refer to Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 the first Mapping output. The supplied array should have a leng th at least equal Overfull \hbox (5.62103pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 to the number of outputs in the supplied Mapping. The number of values stored Overfull \hbox (1.94693pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 in the array on exit will equal the number of outputs in the re turned Mapping. Overfull \hbox (31.60219pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 The i' th element in the returned array holds the index within the supplied Mapping Overfull \hbox (21.10475pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Address of a location at which to return a pointer to the retur ned Mapping. This Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Mapping will have " nin" inputs (the number of outputs may be d ifferent to " nin" Overfull \hbox (26.6159pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 ). NULL is returned if the supplied Mapping has no subset of ou tputs which depend Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 only on the selected inputs. The returned Mapping is a deep cop y of the required Overfull \hbox (0.37231pt too wide) in paragraph at lines 21193--21193 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t, or if it should Overfull \hbox (7.19565pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 fail for any reason, then a NULL value will be returned for the " map" pointer. [360] LaTeX Warning: Hyper reference `KeyMap' on page 361 undefined on input line 212 52. LaTeX Warning: Hyper reference `KeyCase' on page 361 undefined on input line 21 252. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e KeyCase attribute Overfull \hbox (12.76088pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__BYTETYPE (for LaTeX Warning: Hyper reference `Object' on page 361 undefined on input line 212 52. LaTeX Warning: Hyper reference `astMapPutU' on page 361 undefined on input line 21252. Overfull \hbox (79.10309pt too wide) in paragraph at lines 21252--21252 [][]\T1/cmtt/m/n/10 i.e. unsigned chars ) AST__DOUBLETYPE (for double precision floating point), AST__FLOATTYPE Overfull \hbox (2.4718pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 (for single precision floating point), AST__STRINGTYPE (for cha racter string), Overfull \hbox (35.80116pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 AST__OBJECTTYPE (for AST Object pointer), AST__POINTERTYPE (for arbitrary C pointer) Overfull \hbox (10.86975pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 or AST__UNDEFTYPE (for undefined values created by astMapPutU). AST__BADTYPE is Overfull \hbox (29.24026pt too wide) in paragraph at lines 21252--21252 [][]\T1/cmtt/m/n/10 A function value of AST__BADTYPE will be returned if an err or has already occurred, [361] LaTeX Warning: Hyper reference `Plot' on page 362 undefined on input line 21338 . Overfull \hbox (13.18324pt too wide) in paragraph at lines 21338--21338 []\T1/cmtt/m/n/10 void astMark( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, int nmark, int ncoord, int indim, const double $\OMS/zplm/m/n/10 ^^C$\T1/c mtt/m/n/10 in, int Overfull \hbox (10.60732pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of markers to draw. This may be zero, in which case nothing will be LaTeX Warning: Hyper reference `Frame' on page 362 undefined on input line 2133 8. LaTeX Warning: Hyper reference `Naxes' on page 362 undefined on input line 2133 8. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of coordinates being supplied for each mark (i.e. th e number of axes Overfull \hbox (36.8509pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (5.62103pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 the marker coordinates). This value is required so that the coo rdinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 21338--21338 [] \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of shape " [ncoord][indim]" Overfull \hbox (31.86462pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 giving the physical coordinates of the points where markers are to be drawn. These Overfull \hbox (21.10475pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 should be stored such that the value of coordinate number " coo rd" for input mark Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 A value specifying the type (e.g. shape) of marker to be drawn. The set of values Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 which may be used (and the shapes that will result) is determin ed by the underlying Overfull \hbox (10.86975pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 Markers are not drawn at positions which have any coordinat e equal to the value Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 AST__BAD (or where the transformation into graphical coordinate s yields coordinates LaTeX Warning: Hyper reference `astClip' on page 362 undefined on input line 21 338. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 If any marker position is clipped (see astClip), then the e ntire marker is not LaTeX Warning: Hyper reference `TranInverse' on page 362 undefined on input lin e 21338. Overfull \hbox (10.86975pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [362] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. LaTeX Warning: Hyper reference `Region' on page 363 undefined on input line 215 38. Overfull \hbox (3.90186pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 int astMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m /it/10 >$\T1/cmtt/m/n/10 ( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this , AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, int inside, int ndim, c onst int LaTeX Warning: Hyper reference `Mapping' on page 363 undefined on input line 21 538. LaTeX Warning: Hyper reference `UnitMap' on page 363 undefined on input line 21 538. Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to a Mapping. The forward transformation should map pos itions in the Overfull \hbox (0.10988pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 coordinate system of the supplied Region into pixel coordinates as defined by Overfull \hbox (42.36206pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the " lbnd" and " ubnd" parameters. A NULL pointer can be suppl ied if the coordinate Overfull \hbox (31.86462pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 system of the supplied Region corresponds to pixel coordinates. This is equivalent LaTeX Warning: Hyper reference `Nin' on page 363 undefined on input line 21538. LaTeX Warning: Hyper reference `Naxes' on page 363 undefined on input line 2153 8. LaTeX Warning: Hyper reference `Nout' on page 363 undefined on input line 21538 . Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 The number of inputs for this Mapping (as given by its Nin at tribute) should match Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the number of axes in the supplied Region (as given by the Naxe s attribute of Overfull \hbox (36.0636pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the Region). The number of outputs for the Mapping (as given by its Nout attribute) Overfull \hbox (7.19565pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 should match the number of grid dimensions given by the value o f " ndim" below. LaTeX Warning: Hyper reference `Negated' on page 363 undefined on input line 21 538. Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 A boolean value which indicates which pixel are to be masked. I f a non-zero value Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 is supplied, then all grid pixels with centres inside the suppl ied Region are Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 assigned the value given by " val" , and all other pixels are l eft unchanged. If Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 zero is supplied, then all grid pixels with centres not inside the supplied Region Overfull \hbox (17.69308pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 are assigned the value given by " val" , and all other pixels a re left unchanged. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Note, the Negated attribute of the Region is used to determine which pixel are Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 inside the Region and which are outside. So the inside of a Reg ion which has Overfull \hbox (12.44437pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 not been negated is the same as the outside of the correspondin g negated Region. LaTeX Warning: Hyper reference `PointList' on page 363 undefined on input line 21538. Overfull \hbox (16.11847pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 For types of Region such as PointList which have zero volume, pixel centres will Overfull \hbox (16.11847pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 rarely fall exactly within the Region. For this reason, the inc lusion criterion Overfull \hbox (10.86975pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 is changed for zero-volume Regions so that pixels are included (or excluded) if Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 any part of the Region passes through the pixel. For a PointLis t, this means Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 that pixels are included (or excluded) if they contain at least one of the points Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates [363] Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (10.60732pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the data to be masked. The numerical type of this array should match the 1- or Overfull \hbox (39.7377pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 2-character type code appended to the function name (e.g. if yo u are using astMaskF, Overfull \hbox (15.85603pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 On exit, the samples specified by " inside" are set to the va lue of " val" . All Overfull \hbox (10.60732pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 [][]\T1/cmtt/m/n/10 An error will be reported if the overlap of the Region and the array cannot be Overfull \hbox (3.21706pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 function name astMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OM L/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so a s to match the Overfull \hbox (7.7746pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 For example, astMaskD would be used to process " double" data, while astMaskS would [364] LaTeX Warning: Hyper reference `Frame' on page 365 undefined on input line 2160 0. LaTeX Warning: Hyper reference `Axis' on page 365 undefined on input line 21600 . Overfull \hbox (5.62103pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 Pointer to an integer array in which to return the indices of t he axes (within Overfull \hbox (37.11334pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 the first Frame) that correspond to each axis within the second Frame. Axis indices Overfull \hbox (10.86975pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 start at 1. A value of zero will be stored in the returned arra y for each axis Overfull \hbox (15.5936pt too wide) in paragraph at lines 21600--21600 []\T1/cmtt/m/n/10 The number of elements in this array must be greater than or equal to the number LaTeX Warning: Hyper reference `Mapping' on page 365 undefined on input line 21 600. LaTeX Warning: Hyper reference `astFindFrame' on page 365 undefined on input li ne 21600. LaTeX Warning: Hyper reference `astConvert' on page 365 undefined on input line 21600. LaTeX Warning: Hyper reference `SkyFrame' on page 365 undefined on input line 2 1600. Overfull \hbox (21.36719pt too wide) in paragraph at lines 21600--21600 [][]\T1/cmtt/m/n/10 Corresponding axes are identified by the fact that a Mappin g can be found between Overfull \hbox (52.59706pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 them using astFindFrame or astConvert. Thus, " corresponding ax es" are not necessarily Overfull \hbox (0.10988pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 identical. For instance, SkyFrame axes in two Frames will match even if they [365] LaTeX Warning: Hyper reference `MathMap' on page 366 undefined on input line 22 337. LaTeX Warning: Hyper reference `Mapping' on page 366 undefined on input line 22 337. LaTeX Warning: Hyper reference `IntraMap' on page 366 undefined on input line 2 2337. Overfull \hbox (28.9294pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 AstMathMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMathMap( int nin, int nout, int nfwd, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 f wd[], int ninv, const LaTeX Warning: Hyper reference `Nin' on page 366 undefined on input line 22337. Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Number of input variables for the MathMap. This determines the value of its Nin LaTeX Warning: Hyper reference `Nout' on page 366 undefined on input line 22337 . Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Number of output variables for the MathMap. This determines the value of its Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 The number of forward transformation functions being supplied. This must be at Overfull \hbox (52.8595pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 least equal to " nout" , but may be increased to accommodate an y additional expressions Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which define intermediate variables for the forward transformat ion (see the " Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 An array (with " nfwd" elements) of pointers to null terminated strings which Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 contain the expressions defining the forward transformation. Th e syntax of these Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 The number of inverse transformation functions being supplied. This must be at Overfull \hbox (47.61078pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 least equal to " nin" , but may be increased to accommodate any additional expressions Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which define intermediate variables for the inverse transformat ion (see the " Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 An array (with " ninv" elements) of pointers to null terminated strings which Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 contain the expressions defining the inverse transformation. Th e syntax of these LaTeX Warning: Hyper reference `astSet' on page 366 undefined on input line 223 37. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ma thMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [366] LaTeX Warning: Hyper reference `Seed' on page 367 undefined on input line 22337 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 The sequence of numbers produced by the random number funct ions available within Overfull \hbox (26.6159pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 a MathMap is normally unpredictable and different for each Math Map. However, this LaTeX Warning: Hyper reference `astSimplify' on page 367 undefined on input lin e 22337. LaTeX Warning: Hyper reference `SimpFI' on page 367 undefined on input line 223 37. LaTeX Warning: Hyper reference `SimpIF' on page 367 undefined on input line 223 37. Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 Normally, compound Mappings (CmpMaps) which involve MathMap s will not be subject Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 to simplification (e.g. using astSimplify) because AST cannot k now how different Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 MathMaps will interact. However, in the special case where a Ma thMap occurs in Overfull \hbox (63.35693pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 series with its own inverse, then simplification may be possibl e. Whether simplification Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 does, in fact, occur under these circumstances is controlled by the MathMap' s LaTeX Warning: Hyper reference `Object' on page 367 undefined on input line 223 37. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (22.99588pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 A MathMap' s transformation functions are supplied as a set o f expressions in an array Overfull \hbox (7.51216pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of character strings. Normally you would supply the same number of expressions for Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 the forward transformation, via the " fwd" parameter, as there are output variables Overfull \hbox (9.87408pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 (given by the MathMap' s Nout attribute). For instance, if Nout is 2 you might use: Overfull \hbox (33.75575pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which defines a transformation from Cartesian to polar coordina tes. Here, the variables Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 that appear on the left of each expression (" r" and " theta" ) provide names for the Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 output variables and those that appear on the right (" x" and " y" ) are references Overfull \hbox (7.51216pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 To complement this, you must also supply expressions for the inverse transformation Overfull \hbox (28.2446pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 via the " inv" parameter. In this case, the number of expressio ns given would normally Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 match the number of MathMap input coordinates (given by the Nin attribute). If Nin Overfull \hbox (2.26344pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which expresses the transformation from polar to Cartesian coor dinates. Note that Overfull \hbox (5.15024pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 here the input variables (" x" and " y" ) are named on the left of each expression, Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Normally, you cannot refer to a variable on the right of an e xpression unless it is Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 named on the left of an expression in the complementary set of functions. Therefore Overfull \hbox (39.2669pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 both sets of functions (forward and inverse) must be formulated using the same consistent Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 set of variable names. This means that if you wish to leave one of the transformations Overfull \hbox (18.0096pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 undefined, you must supply dummy expressions which simply name each of the output (or [367] Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 for the inverse transformation above, which serves to name the input variables but Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 It is sometimes useful to calculate intermediate values and t hen to use these in the Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 final expressions for the output (or input) variables. This may be done by supplying Overfull \hbox (2.26344pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 additional expressions for the forward (or inverse) transformat ion functions. For Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 instance, the following array of five expressions describes 2-d imensional pin-cushion Overfull \hbox (1.47614pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Here, we first calculate three intermediate results (" r" , " r out" and " theta" ) Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 and then use these to calculate the final results (" xout" and " yout" ). The MathMap Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 knows that only the final two results constitute values for the output variables because Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 its Nout attribute is set to 2. You may define as many intermed iate variables in this Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 way as you choose. Having defined a variable, you may then refe r to it on the right Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Note that when defining the inverse transformation you may on ly refer to the output Overfull \hbox (28.50703pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 variables " xout" and " yout" . The intermediate variables " r" , " rout" and " theta" Overfull \hbox (2.001pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 (above) are private to the forward transformation and may not b e referenced by the Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 inverse transformation. The inverse transformation may, however , define its own private Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The expressions given for the forward and inverse transformat ions closely follow the Overfull \hbox (46.09024pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 syntax of the C programming language (with some extensions for compatibility with Fortran). Overfull \hbox (36.38011pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 They may contain references to variables and literal constants, together with arithmetic, Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 boolean, relational and bitwise operators, and function invocat ions. A set of symbolic Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 constants is also available. Each of these is described in deta il below. Parentheses Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 may be used to over-ride the normal order of evaluation. There is no built-in limit Overfull \hbox (49.76434pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 to the length of expressions and they are insensitive to case o r the presence of additional Overfull \hbox (23.25832pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Variable names must begin with an alphabetic character and ma y contain only alphabetic Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 characters, digits, and the underscore character " _" . There i s no built-in limit Overfull \hbox (52.3887pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Literal constants, such as " 0" , " 1" , " 0.007" or " 2.505e -16" may appear in expressions, Overfull \hbox (44.25319pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 with the decimal point and exponent being optional (a " D" may also be used as an exponent Overfull \hbox (25.09537pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 character for compatibility with Fortran). A unary minus " -" m ay be used as a prefix. Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Unless indicated otherwise, if any argument of a function or operator has the value Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 AST__BAD (indicating missing data), then the result of that fun ction or operation is Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 also AST__BAD, so that such values are propagated automatically through all operations Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 performed by MathMap transformations. The special value AST__BA D can be represented [368] Overfull \hbox (29.46065pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 A $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 result (i.e. equal to AST__BAD) is also produced in response to any numerical Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 error (such as division by zero or numerical overflow), or if a n invalid argument value Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Boolean values are represented using zero to indicate false a nd non-zero to indicate Overfull \hbox (39.2669pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 true. In addition, the value AST__BAD is taken to mean " unknow n" . The values returned Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 by boolean operators may therefore be 0, 1 or AST__BAD. Where a ppropriate, " tri-state" Overfull \hbox (24.55203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 logic is implemented. For example, " a$\OMS/zplm/m/n/10 j$$j$\T 1/cmtt/m/n/10 b" may evaluate to 1 if " a" is non-zero, even Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 if " b" has the value AST__BAD. This is because the result of t he operation would not Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 && x2: Boolean AND between " x1" and " x2" , returning 1 if both " x1" and Overfull \hbox (7.19565pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 " x2" are non-zero, and 0 otherwise. This operator implements t ri-state logic. Overfull \hbox (1.14116pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OMS/zplm/m/n/10 j$$j$ \T1/cmtt/m/n/10 x2: Boolean OR b etween " x1" and " x2" , returning 1 if either " x1" or Overfull \hbox (7.19565pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 " x2" are non-zero, and 0 otherwise. This operator implements t ri-state logic. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $[]$$[]$ x2: Boolean exclusive OR (XOR) between " x1" an d " x2" , returning 1 if Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 exactly one of " x1" and " x2" is non-zero, and 0 otherwise. Tr i-state logic Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 is not used with this operator. (The synonyms " .neqv." and " . xor." are also Overfull \hbox (51.80975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 provided for compatibility with Fortran, although the second of these is not standard.) Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 .eqv. x2: This is provided only for compatibility with F ortran and tests Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 whether the boolean states of " x1" and " x2" (i.e. true/false) are equal. It Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 is the negative of the exclusive OR (XOR) function. Tri-state l ogic is not used Overfull \hbox (17.69308pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 ! x: Boolean unary NOT operation, returning 1 if " x" is ze ro, and 0 otherwise. Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Relational operators return the boolean result (0 or 1) of co mparing the values of Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 two floating point values for equality or inequality. The value AST__BAD may also Overfull \hbox (37.11334pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 == x2: Tests whether " x1" equals " x1" . (The synonym " .eq." is also provided Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 != x2: Tests whether " x1" is unequal to " x2" . (The sy nonym " .ne." is [369] Overfull \hbox (8.7222pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 x2: Tests whether " x1" is greater than " x2" . (The synonym " .gt." is Overfull \hbox (19.21964pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 = x2: Tests whether " x1" is greater than or equal to " x2" . (The synonym Overfull \hbox (19.21964pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$ \T1/cmtt/m/n/10 x2: Tests whether " x1" is less than " x2" . (The synonym " .lt." is also Overfull \hbox (3.47348pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 = x2: Tests whether " x1" is less than or equal to " x2" . (The synonym Overfull \hbox (34.9718pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Note that relational operators cannot usefully be used to compa re values with the $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 > $ Overfull \hbox (12.66475pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 value (representing missing data), because the result is always $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 . The isbad() Overfull \hbox (14.3355pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The bitwise operators provided by C are often useful when ope rating on raw data (e.g. Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 from instruments), so they are also provided for use in MathMap expressions. In this Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 case, however, the values on which they operate are floating po int values rather than Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 pure integers. In order to produce results which match the pure integer case, the Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 operands are regarded as fixed point binary numbers (i.e. with the binary equivalent Overfull \hbox (14.59793pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of a decimal point) with negative numbers represented using two s-complement notation. Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 For integer values, the resulting bit pattern corresponds to th at of the equivalent Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 signed integer (digits to the right of the point being zero). O perations on the bits Overfull \hbox (11.82336pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$$>$ \T1/cmtt/m/n/10 x2: Rightward b it shift. The integer value of " x2" is taken (rounding Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 towards zero) and the bits representing " x1" are then shifted this number of Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 places to the right (or to the left if the number of places is negative). This Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$$<$ \T1/cmtt/m/n/10 x2: Leftward bi t shift. The integer value of " x2" is taken (rounding Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 towards zero), and the bits representing " x1" are then shifted this number of Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 places to the left (or to the right if the number of places is negative). This Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 & x2: Bitwise AND between the bits of " x1" and those of " x2" (equivalent Overfull \hbox (14.00975pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OMS/zplm/m/n/10 j$ \T1/cmtt/m/n/10 x2: Bitwise OR betw een the bits of " x1" and those of " x2" (equivalent to Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $[]$ x2: Bitwise exclusive OR (XOR) between the bits of " x1" and those of " Overfull \hbox (31.87064pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Note that no bit inversion operator (" $\OMS/zplm/m/n/10 ^^X$\T 1/cmtt/m/n/10 " in C) is provided. This is because inverting Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 the bits of a twos-complement fixed point binary number is equi valent to simply negating Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 it. This differs from the pure integer case because bits to the right of the binary Overfull \hbox (10.39896pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 point are also inverted. To invert only those bits to the left of the binary point, [370] Overfull \hbox (22.9418pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 ceil(x): Smallest integer value not less then " x" (round t owards plus infinity). Overfull \hbox (12.44437pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 floor(x): Largest integer not greater than " x" (round towa rds minus infinity). Overfull \hbox (1.94693pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 fmod(x1, x2): Remainder when " x1" is divided by " x2" , sa me as mod(x1, x2). Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 gauss(x1, x2): Random sample from a Gaussian distribution w ith mean " x1" and Overfull \hbox (1.94693pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 mod(x1, x2): Remainder when " x1" is divided by " x2" , sam e as fmod(x1, x2). Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 poisson(x): Random integer-valued sample from a Poisson dis tribution with mean Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 rand(x1, x2): Random sample from a uniform distribution in the range " x1" to Overfull \hbox (17.69308pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 sign(x1, x2): Absolute value of " x1" with the sign of " x2 " (transfer of sign). [371] Overfull \hbox (3.21706pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The following symbolic constants are available (the enclosing " $\OML/zplm/m/it/10 <$$>$\T1/cmtt/m/n/10 " brackets must Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : The " bad" value (AST__BAD) used to flag missing data. Note that you Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 cannot usefully compare values with this constant because the r esult is always Overfull \hbox (42.26593pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 dig$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : Number of decimal digits of precision available in a floating point (double ) LaTeX Warning: Hyper reference `Base' on page 372 undefined on input line 22337 . Overfull \hbox (26.37558pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 epsilon$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Smallest positive number such that 1.0$\OT1/zplm/m/n/10 +$$\OML/zplm/m/ it/10 <$\T1/cmtt/m/n/10 epsilon$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 is disting uishable Overfull \hbox (44.26929pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 mant_dig$\OML/zplm/m/it/10 >$\T1/cmtt/ m/n/10 : The number of base $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zpl m/m/it/10 >$ \T1/cmtt/m/n/10 digits stored in the mantissa of a floating Overfull \hbox (38.06696pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 max_10_exp$\OML/zplm/m/it/10 >$\T1/cmt t/m/n/10 : Maximum integer such that 10 raised to that power can be represented Overfull \hbox (18.0257pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 max_exp$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Maximum integer such that $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 raised to that power minus 1 can Overfull \hbox (32.81824pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : Smallest positive number which can be represented as a normalised floating Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min_10_exp$\OML/zplm/m/it/10 >$\T1/cmt t/m/n/10 : Minimum negative integer such that 10 raised to that power can Overfull \hbox (2.0171pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min_exp$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Minimum negative integer such that $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 raised to that power Overfull \hbox (1.32593pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zplm/m/it/10 >$\T1/cmtt/m/n /10 : The radix (number base) used to represent the mantissa of floating Overfull \hbox (53.81311pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 rounds$\OML/zplm/m/it/10 >$\T1/cmtt/m/ n/10 : The mode used for rounding floating point results after addition. Possib le Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 values include: -1 (indeterminate), 0 (toward zero), 1 (to near est), 2 (toward Overfull \hbox (47.61078pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 plus infinity) and 3 (toward minus infinity). Other values indi cate machine-dependent Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Items appearing in expressions are evaluated in the following order (highest precedence [372] Overfull \hbox (26.35948pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 All operators associate from left-to-right, except for unary $\ OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 , unary -, !, .not. and [373] LaTeX Warning: Hyper reference `MatrixMap' on page 374 undefined on input line 22458. LaTeX Warning: Hyper reference `Mapping' on page 374 undefined on input line 22 458. Overfull \hbox (18.22078pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 AstMatrixMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMatrixM ap( int nin, int nout, int form, const double matrix[], const Overfull \hbox (5.3586pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The number of input coordinates, which determines the number of columns in the Overfull \hbox (33.1768pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The number of output coordinates, which determines the number o f rows in the matrix. Overfull \hbox (22.67937pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 An integer which indicates the form in which the matrix element s will be supplied. Overfull \hbox (10.60732pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of zero indicates that a full " nout" x " nin" matrix of values will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 supplied via the " matrix" parameter (below). In this case, the elements should Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 be given in row order (the elements of the first row, followed by the elements Overfull \hbox (44.72398pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of 1 indicates that only the diagonal elements of the matrix will be supplied, Overfull \hbox (31.86462pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 and that all others should be zero. In this case, the elements of " matrix" should Overfull \hbox (21.10475pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of 2 indicates that a " unit" matrix is required, who se diagonal elements Overfull \hbox (0.37231pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 are set to unity (with all other elements zero). In this case, the " matrix" Overfull \hbox (21.10475pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The array of matrix elements to be used, stored according to th e value of " form" LaTeX Warning: Hyper reference `astSet' on page 374 undefined on input line 224 58. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ma trixMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 22458--22458 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `TranForward' on page 374 undefined on input lin e 22458. LaTeX Warning: Hyper reference `TranInverse' on page 374 undefined on input lin e 22458. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 In general, a MatrixMap' s forward transformation will alwa ys be available (as Overfull \hbox (37.11334pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 indicated by its TranForward attribute), but its inverse transf ormation (TranInverse Overfull \hbox (43.93668pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 attribute) will only be available if the associated matrix is s quare and non-singular. [374] Overfull \hbox (21.36719pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 As an exception to this, the inverse transformation is alwa ys available if a unit Overfull \hbox (16.11847pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 or diagonal matrix is specified. In this case, if the matrix is not square, one Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 or more of the input coordinate values may not be recoverable f rom a set of output Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 coordinates. Any coordinates affected in this way will simply b e set to the value LaTeX Warning: Hyper reference `Object' on page 375 undefined on input line 224 58. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [375] LaTeX Warning: Hyper reference `Variant' on page 376 undefined on input line 22 531. LaTeX Warning: Hyper reference `Frame' on page 376 undefined on input line 2253 1. LaTeX Warning: Hyper reference `FrameSet' on page 376 undefined on input line 2 2531. LaTeX Warning: Hyper reference `Mapping' on page 376 undefined on input line 22 531. LaTeX Warning: Hyper reference `Nframe' on page 376 undefined on input line 225 31. Overfull \hbox (21.10475pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 The index of the Frame within the FrameSet which is to be mirro red by the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 Frame. This value should lie in the range from 1 to the number of Frames in the Overfull \hbox (0.10988pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 FrameSet (as given by its Nframe attribute). If AST__NOFRAME is supplied (or Overfull \hbox (0.37231pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 the current Frame is specified), then any mirroring established by a previous Overfull \hbox (2.99667pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Mirrors can be chained. That is, if Frame B is set to be a mirror of Frame A, Overfull \hbox (10.60732pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 and Frame C is set to be a mirror of Frame B, then Frame C will act as a mirror LaTeX Warning: Hyper reference `astAddVariant' on page 376 undefined on input l ine 22531. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Variant Mappings cannot be added to the current Frame if it is mirroring another Overfull \hbox (21.36719pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 Frame. So calls to the astAddVariant function will cause an err or to be reported Overfull \hbox (21.36719pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 A value of AST__BASE may be given for the " iframe" paramet er to specify the base Overfull \hbox (5.62103pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Any variant Mappings explicitly added to the current Frame using astAddVariant [376] LaTeX Warning: Hyper reference `Region' on page 377 undefined on input line 225 54. LaTeX Warning: Hyper reference `Negated' on page 377 undefined on input line 22 554. [377] LaTeX Warning: Hyper reference `Frame' on page 378 undefined on input line 2261 1. LaTeX Warning: Hyper reference `Naxes' on page 378 undefined on input line 2261 1. Overfull \hbox (49.9727pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). Initially, Overfull \hbox (16.11847pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 this should contain a set of coordinate values representing a p oint in the space Overfull \hbox (5.09616pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 which the Frame describes. If these values lie outside the expe cted range for Overfull \hbox (44.98642pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 the Frame, they will be replaced with more acceptable (normalis ed) values. Otherwise, Overfull \hbox (42.36206pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 For some classes of Frame, whose coordinate values are not constrained, this function Overfull \hbox (15.85603pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 will never modify the values supplied. However, for Frames whos e axes represent Overfull \hbox (47.34834pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 cyclic quantities (such as angles or positions on the sky), coo rdinates will typically LaTeX Warning: Hyper reference `NormMap' on page 378 undefined on input line 22 611. LaTeX Warning: Hyper reference `Mapping' on page 378 undefined on input line 22 611. Overfull \hbox (0.37231pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 The NormMap class is a Mapping which can be used to normali se a set of points LaTeX Warning: Hyper reference `astFormat' on page 378 undefined on input line 22611. Overfull \hbox (16.11847pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 It is intended to be possible to put any set of coordinates into a form suitable Overfull \hbox (0.37231pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 for display by using this function to normalise them, followed by appropriate [378] LaTeX Warning: Hyper reference `NormMap' on page 379 undefined on input line 22 691. LaTeX Warning: Hyper reference `Mapping' on page 379 undefined on input line 22 691. LaTeX Warning: Hyper reference `astNorm' on page 379 undefined on input line 22 691. LaTeX Warning: Hyper reference `Frame' on page 379 undefined on input line 2269 1. LaTeX Warning: Hyper reference `astSimplify' on page 379 undefined on input lin e 22691. LaTeX Warning: Hyper reference `UnitMap' on page 379 undefined on input line 22 691. LaTeX Warning: Hyper reference `CmpMap' on page 379 undefined on input line 226 91. Overfull \hbox (17.43065pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 A pointer to the Frame which is to be used to normalise the sup plied axis values. LaTeX Warning: Hyper reference `astSet' on page 379 undefined on input line 226 91. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new No rmMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 22691--22691 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 379 undefined on input line 226 91. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22691--22691 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 22691--22691 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [379] LaTeX Warning: Hyper reference `NullRegion' on page 380 undefined on input line 22776. LaTeX Warning: Hyper reference `Region' on page 380 undefined on input line 227 76. LaTeX Warning: Hyper reference `Negated' on page 380 undefined on input line 22 776. Overfull \hbox (5.73253pt too wide) in paragraph at lines 22776--22776 []\T1/cmtt/m/n/10 AstNullRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astNullRe gion( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, AstRegion $\OMS/zpl m/m/n/10 ^^C$\T1/cmtt/m/n/10 unc, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 options, LaTeX Warning: Hyper reference `Frame' on page 380 undefined on input line 2277 6. Overfull \hbox (10.60732pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (47.34834pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 with positions in the supplied Frame. The uncertainty in any po int in the Frame Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 is found by shifting the supplied " uncertainty" Region so that it is centred Overfull \hbox (26.6159pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 at the point being considered. The area covered by the shifted uncertainty Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 then represents the uncertainty in the position. The uncertaint y is assumed to LaTeX Warning: Hyper reference `Box' on page 380 undefined on input line 22776. LaTeX Warning: Hyper reference `Circle' on page 380 undefined on input line 227 76. LaTeX Warning: Hyper reference `Ellipse' on page 380 undefined on input line 22 776. LaTeX Warning: Hyper reference `Prism' on page 380 undefined on input line 2277 6. LaTeX Warning: Hyper reference `Object' on page 380 undefined on input line 227 76. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (36.58847pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 will have no effect on the created NullRegion. Alternatively, a NULL Object pointer LaTeX Warning: Hyper reference `astSet' on page 380 undefined on input line 227 76. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Nu llRegion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 syntax used is identical to that for the astSet function and ma y include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [380] LaTeX Warning: Hyper reference `astClearStatus' on page 381 undefined on input line 22809. Overfull \hbox (42.36206pt too wide) in paragraph at lines 22809--22809 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (26.35347pt too wide) in paragraph at lines 22809--22809 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [381] LaTeX Warning: Hyper reference `Frame' on page 382 undefined on input line 2288 5. Overfull \hbox (12.97206pt too wide) in paragraph at lines 22885--22885 []\T1/cmtt/m/n/10 void astOffset( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const double point1[], const double point2[], double LaTeX Warning: Hyper reference `Naxes' on page 382 undefined on input line 2288 5. Overfull \hbox (21.10475pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 should contain the coordinates of the point marking the start o f the geodesic Overfull \hbox (15.85603pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis This s hould contain the Overfull \hbox (5.3586pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 The required offset from the first point along the geodesic cur ve. If this is Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 positive, it will be towards the second point. If it is negativ e, it will be Overfull \hbox (10.86975pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 in the opposite direction. This offset need not imply a positio n lying between Overfull \hbox (21.10475pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates LaTeX Warning: Hyper reference `astDistance' on page 382 undefined on input lin e 22885. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 " Bad" coordinate values will also be returned if the two p oints supplied are Overfull \hbox (42.36206pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [382] LaTeX Warning: Hyper reference `Frame' on page 383 undefined on input line 2297 1. Overfull \hbox (26.3563pt too wide) in paragraph at lines 22971--22971 []\T1/cmtt/m/n/10 double astOffset2( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const double point1[2], double angle, double offset, LaTeX Warning: Hyper reference `Naxes' on page 383 undefined on input line 2297 1. Overfull \hbox (21.10475pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (0.37231pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 should contain the coordinates of the point marking the start o f the geodesic Overfull \hbox (0.10988pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The angle (in radians) from the positive direction of the secon d axis, to the Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 direction of the required position, as seen from the starting p osition. Positive Overfull \hbox (0.37231pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 rotation is in the sense of rotation from the positive directio n of axis 2 to Overfull \hbox (5.3586pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The required offset from the first point along the geodesic cur ve. If this is Overfull \hbox (16.11847pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 positive, it will be in the direction of the given angle. If it is negative, it Overfull \hbox (21.10475pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (22.20857pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The direction of the geodesic curve at the end point. That is, the angle (in radians) Overfull \hbox (23.52075pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 between the positive direction of the second axis and the conti nuation of the geodesic Overfull \hbox (18.27203pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 curve at the requested end point. Positive rotation is in the s ense of rotation from LaTeX Warning: Hyper reference `astDistance' on page 383 undefined on input lin e 22971. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [383] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. LaTeX Warning: Hyper reference `Polygon' on page 384 undefined on input line 23 240. LaTeX Warning: Hyper reference `Frame' on page 384 undefined on input line 2324 0. LaTeX Warning: Hyper reference `Domain' on page 384 undefined on input line 232 40. LaTeX Warning: Hyper reference `Title' on page 384 undefined on input line 2324 0. Overfull \hbox (10.58418pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astOutline$\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( $\OM L/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 val ue, int oper, const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/1 0 >$ \T1/cmtt/m/n/10 array[], const Overfull \hbox (13.02332pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 int lbnd[2], const int ubnd[2], double maxerr, int maxvert, con st int inside[2], int Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the outl ined pixels. It Overfull \hbox (37.11334pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to a 2-dimensional array containing the data to be proc essed. The numerical Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 type of this array should match the 1- or 2-character type code appended to the Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 function name (e.g. if you are using astOutlineF, the type of e ach array element Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the second dimension least Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the first pixel Overfull \hbox (16.11847pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [384] Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (34.70335pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel grid, its extent along a particular (j' th) dimension bei ng ubnd[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixels. For FITS images, the lbnd values will be 1 and the ubnd values will be Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 equal to the NAXISi header values. Other data systems, such as the Starlink NDF Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 system, allow an arbitrary pixel origin to be used (i.e. lbnd i s not necessarily Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 These bounds also define the input grid' s floating point coo rdinate system, each Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel having unit extent along each dimension with integral coo rdinate values Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Together with " maxvert" , this determines how accurately the r eturned Polygon Overfull \hbox (26.35347pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 represents the required region of the data array. It gives the target discrepancy Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 between the returned Polygon and the accurate outline in the da ta array, expressed Overfull \hbox (39.7377pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 as a number of pixels. Insignificant vertices are removed from the accurate outline, Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 one by one, until the number of vertices remaining in the retur ned Polygon equals Overfull \hbox (42.36206pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 " maxvert" , or the largest discrepancy between the accurate ou tline and the returned Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Polygon is greater than " maxerr" . If " maxerr" is zero or les s, its value is Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 ignored and the returned Polygon will have the number of vertic es specified by Overfull \hbox (0.10988pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Together with " maxerr" , this determines how accurately the re turned Polygon Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 represents the required region of the data array. It gives the maximum allowed Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 number of vertices in the returned Polygon. Insignificant verti ces are removed Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 from the accurate outline, one by one, until the number of vert ices remaining Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 in the returned Polygon equals " maxvert" , or the largest disc repancy between Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 the accurate outline and the returned Polygon is greater than " maxerr" . If Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 " maxvert" is less than 3, its value is ignored and the number of vertices in Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 the returned Polygon will be the minimum needed to ensure that the discrepancy Overfull \hbox (1.94693pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 between the accurate outline and the returned Polygon is less t han " maxerr" . Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel indice s of a pixel known Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 to be inside the required region. This is needed because the su pplied data array Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 may contain several disjoint areas of pixels that satisfy the c riterion specified Overfull \hbox (37.11334pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 by " value" and " oper" . In such cases, the area described by the returned Polygon Overfull \hbox (26.35347pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 will be the one that contains the pixel specified by " inside" . If the specified Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel is outside the bounds given by " lbnd" and " ubnd" , or h as a value that Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 does not meet the criterion specified by " value" and " oper" , then this function Overfull \hbox (0.10988pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 will search for a suitable pixel. The search starts at the cent ral pixel and Overfull \hbox (38.68796pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 proceeds in a spiral manner until a pixel is found that meets t he specified crierion. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 A flag indicating the nature of the pixel coordinate system use d to describe the Overfull \hbox (57.84578pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 vertex positions in the returned Polygon. If non-zero, the stan dard Starlink definition Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 of pixel coordinate is used in which a pixel with integer index I spans a range Overfull \hbox (64.93155pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 of pixel coordinate from (I-1) to I (i.e. pixel corners have in tegral pixel coordinates). Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 If zero, the definition of pixel coordinate used by other AST f unctions such as Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 astResample, astMask, etc., is used. In this definition, a pixe l with integer Overfull \hbox (8.7222pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 index I spans a range of pixel coordinate from (I-0.5) to (I$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 0.5) (i.e. pixel [385] LaTeX Warning: Hyper reference `astDownsize' on page 386 undefined on input lin e 23240. Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 This function proceeds by first finding a very accurate pol ygon, and then removing Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 The returned Polygon is the outer boundary of the contiguou s set of pixels that Overfull \hbox (33.43924pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 includes ths specified " inside" point, and satisfy the specifi ed value requirement. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 This set of pixels may potentially include " holes" where the p ixel values fail Overfull \hbox (43.93668pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 to meet the specified value requirement. Such holes will be ign ored by this function. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 NULL will be returned if this function is invoked with the global error status Overfull \hbox (3.21706pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (13.97693pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 function name astOutline$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$ \OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, s o as to match Overfull \hbox (7.7746pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 For example, astOutlineD would be used to process " double" dat a, while astOutlineS [386] LaTeX Warning: Hyper reference `Region' on page 387 undefined on input line 233 06. Overfull \hbox (12.76088pt too wide) in paragraph at lines 23306--23306 \T1/cmtt/m/n/10 A value indicating if there is any overlap between the two Regi ons. Possible values Overfull \hbox (2.52588pt too wide) in paragraph at lines 23306--23306 []\T1/cmtt/m/n/10 0 - The check could not be performed because the second Regio n could not be mapped Overfull \hbox (61.8364pt too wide) in paragraph at lines 23306--23306 []\T1/cmtt/m/n/10 6 - The second Region is the exact negation of the first Regi on to within their uncertainties. LaTeX Warning: Hyper reference `Closed' on page 387 undefined on input line 233 06. Overfull \hbox (0.37231pt too wide) in paragraph at lines 23306--23306 [][]\T1/cmtt/m/n/10 The returned values 5 and 6 do not check the value of the C losed attribute in Overfull \hbox (10.60732pt too wide) in paragraph at lines 23306--23306 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [387] LaTeX Warning: Hyper reference `Table' on page 388 undefined on input line 2336 7. LaTeX Warning: Hyper reference `Nparameter' on page 388 undefined on input line 23367. Overfull \hbox (5.3586pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 The index into the list of parameters. The first parameter has index one, and Overfull \hbox (0.37231pt too wide) in paragraph at lines 23367--23367 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 23367--23367 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [388] LaTeX Warning: Hyper reference `PcdMap' on page 389 undefined on input line 234 70. LaTeX Warning: Hyper reference `Mapping' on page 389 undefined on input line 23 470. LaTeX Warning: Hyper reference `Disco' on page 389 undefined on input line 2347 0. LaTeX Warning: Hyper reference `astInvert' on page 389 undefined on input line 23470. Overfull \hbox (9.50914pt too wide) in paragraph at lines 23470--23470 []\T1/cmtt/m/n/10 AstPcdMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPcdMap( do uble disco, const double pcdcen[2], const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 options, ... Overfull \hbox (0.10988pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 The distortion coefficient. Negative values give barrel distort ion, positive LaTeX Warning: Hyper reference `astSet' on page 389 undefined on input line 234 70. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pc dMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 23470--23470 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 389 undefined on input line 234 70. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23470--23470 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [389] Overfull \hbox (2.26344pt too wide) in paragraph at lines 23470--23470 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [390] LaTeX Warning: Hyper reference `Frame' on page 391 undefined on input line 2350 9. LaTeX Warning: Hyper reference `Naxes' on page 391 undefined on input line 2350 9. Overfull \hbox (0.10988pt too wide) in paragraph at lines 23509--23509 \T1/cmtt/m/n/10 An array with one element for each axis of the Frame (Naxes att ribute). This Overfull \hbox (21.36719pt too wide) in paragraph at lines 23509--23509 \T1/cmtt/m/n/10 should list the axes in their new order, using the original axi s numbering (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 23509--23509 [][]\T1/cmtt/m/n/10 Only genuine permutations of the axis order are permitted, so each axis must be Overfull \hbox (54.43411pt too wide) in paragraph at lines 23509--23509 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [391] LaTeX Warning: Hyper reference `PermMap' on page 392 undefined on input line 23 647. LaTeX Warning: Hyper reference `Mapping' on page 392 undefined on input line 23 647. Overfull \hbox (5.09898pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 AstPermMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPermMap( int nin, const int inperm[], int nout, const int outperm[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array with " nin" elements which, for each input co ordinate, should Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 contain the number of the output coordinate whose value is to b e used (note that Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 this array therefore defines the inverse coordinate transformat ion). Coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 For details of additional special values that may be used in this array, see the Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, each input coordinate will Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 obtain its value from the corresponding output coordinate (or w ill be assigned Overfull \hbox (21.10475pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array with " nout" elements which, for each output coordinate, should Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 contain the number of the input coordinate whose value is to be used (note that Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 this array therefore defines the forward coordinate transformat ion). Coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 For details of additional special values that may be used in this array, see the Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, each outpu t coordinate will Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 obtain its value from the corresponding input coordinate (or wi ll be assigned Overfull \hbox (15.85603pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array containing values which may be assigned to in put and/or output Overfull \hbox (0.10988pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 coordinates instead of deriving them from other coordinate valu es. If either Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of the " inperm" or " outperm" arrays contains a negative value , it is used to Overfull \hbox (47.61078pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 address this " constant" array (such that -1 addresses the firs t element, -2 addresses Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 the second element, etc.) and the value obtained is used as the corresponding Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 Care should be taken to ensure that locations lying outside t he extent of this Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 array are not accidentally addressed. The array is not used if the " inperm" Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [392] LaTeX Warning: Hyper reference `astSet' on page 393 undefined on input line 236 47. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pe rmMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 If either of the " inperm" or " outperm" arrays contains a zero value (or a positive Overfull \hbox (7.98296pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 value which does not identify a valid output/input coordinate, as appropriate), Overfull \hbox (42.36206pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 This function does not attempt to ensure that the forward a nd inverse transformations Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 performed by the PermMap are self-consistent in any way. You ar e therefore free Overfull \hbox (12.44437pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 to supply coordinate permutation arrays that achieve whatever e ffect is desired. LaTeX Warning: Hyper reference `Object' on page 393 undefined on input line 236 47. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [393] LaTeX Warning: Hyper reference `Frame' on page 394 undefined on input line 2375 9. LaTeX Warning: Hyper reference `Title' on page 394 undefined on input line 2375 9. LaTeX Warning: Hyper reference `Mapping' on page 394 undefined on input line 23 759. Overfull \hbox (13.6056pt too wide) in paragraph at lines 23759--23759 []\T1/cmtt/m/n/10 AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPickAxes( A stFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, int naxes, const int axes[] , AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map Overfull \hbox (26.35347pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 An array, with " naxes" elements, which lists the axes to be co pied. These should Overfull \hbox (16.11847pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be given in the order required in the new Frame, using the axis numbering in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 original Frame (which starts at 1 for the first axis). Axes may be selected in Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 any order, but each may only be used once. If additional (defau lt) axes are also Overfull \hbox (7.19565pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 to be included, the corresponding elements of this array should be set to zero. LaTeX Warning: Hyper reference `PermMap' on page 394 undefined on input line 23 759. LaTeX Warning: Hyper reference `UnitMap' on page 394 undefined on input line 23 759. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Address of a location in which to return a pointer to a new Map ping. This will Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be a PermMap (or a UnitMap as a special case) that describes th e axis permutation Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 that has taken place between the original and new Frames. The M apping' s forward Overfull \hbox (18.74283pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 transformation will convert coordinates from the original Frame into the new one, Overfull \hbox (17.69308pt too wide) in paragraph at lines 23759--23759 []\T1/cmtt/m/n/10 If this Mapping is not required, a NULL value may be supplied for this parameter. Underfull \hbox (badness 10000) in paragraph at lines 23759--23759 LaTeX Warning: Hyper reference `SkyFrame' on page 394 undefined on input line 2 3759. Overfull \hbox (23.25832pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 This function applies to all Frames. The class of Frame returne d may differ from that Overfull \hbox (23.52075pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 of the original Frame, depending on which axes are selected. Fo r example, if a single Overfull \hbox (7.7746pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 axis is picked from a SkyFrame (which must always have two axes ) then the resulting Overfull \hbox (14.59793pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Frame cannot be a valid SkyFrame, so will revert to the parent class (Frame) instead. LaTeX Warning: Hyper reference `FrameSet' on page 394 undefined on input line 2 3759. Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Using this function on a FrameSet is identical to using it on t he current Frame in LaTeX Warning: Hyper reference `Region' on page 394 undefined on input line 237 59. LaTeX Warning: Hyper reference `Box' on page 394 undefined on input line 23759. LaTeX Warning: Hyper reference `Circle' on page 394 undefined on input line 237 59. Overfull \hbox (39.2669pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 If this function is used on a Region, an attempt is made to ret ain the bounds information Overfull \hbox (25.09537pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 on the selected axes. If succesful, the returned Frame will be a Region of some class. Overfull \hbox (49.76434pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Otherwise, the returned Frame is obtained by calling this funct ion on the Frame represented Overfull \hbox (7.7746pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 by the supplied Region (the returned Frame will then not be a R egion). In order to Overfull \hbox (18.0096pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be succesful, the selected axes in the Region must be independe nt of the others. For Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 instance, a Box can be split in this way but a Circle cannot. A nother requirement Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [394] LaTeX Warning: Hyper reference `astCopy' on page 395 undefined on input line 23 759. Overfull \hbox (26.6159pt too wide) in paragraph at lines 23759--23759 [][]\T1/cmtt/m/n/10 The new Frame will contain a " deep" copy (c.f. astCopy) of all the data selected Overfull \hbox (5.62103pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 from the original Frame. Modifying any aspect of the new Frame will therefore LaTeX Warning: Hyper reference `Object' on page 395 undefined on input line 237 59. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23759--23759 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [395] LaTeX Warning: Hyper reference `Plot' on page 396 undefined on input line 23932 . LaTeX Warning: Hyper reference `FrameSet' on page 396 undefined on input line 2 3932. LaTeX Warning: Hyper reference `Frame' on page 396 undefined on input line 2393 2. LaTeX Warning: Hyper reference `Mapping' on page 396 undefined on input line 23 932. LaTeX Warning: Hyper reference `astCurve' on page 396 undefined on input line 2 3932. LaTeX Warning: Hyper reference `astMark' on page 396 undefined on input line 23 932. LaTeX Warning: Hyper reference `astText' on page 396 undefined on input line 23 932. LaTeX Warning: Hyper reference `astGridLine' on page 396 undefined on input lin e 23932. LaTeX Warning: Hyper reference `astGrid' on page 396 undefined on input line 23 932. LaTeX Warning: Hyper reference `Current' on page 396 undefined on input line 23 932. LaTeX Warning: Hyper reference `astClip' on page 396 undefined on input line 23 932. Overfull \hbox (7.93452pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPlot( AstFra me $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const float graphbox[ 4 ], cons t double basebox[ Overfull \hbox (1.94693pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 Pointer to a Frame describing the physical coordinate system in which to plot. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 A pointer to a FrameSet may also be given, in which case its cu rrent Frame will Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 be used to define the physical coordinate system and its base F rame will be mapped LaTeX Warning: Hyper reference `Object' on page 396 undefined on input line 239 32. LaTeX Warning: Hyper reference `Label(axis)' on page 396 undefined on input lin e 23932. Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is given, a default 2-di mensional Frame will Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 be used to describe the physical coordinate system. Labels, etc . may then be Overfull \hbox (15.06873pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 attached to this by setting the appropriate Frame attributes (e .g. Label(axis)) Overfull \hbox (0.10988pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 An array giving the position and extent of the plotting area (o n the plotting Overfull \hbox (22.9418pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 surface of the underlying graphics system) in which graphical o utput is to appear. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 This must be specified using graphical coordinates appropriate to the underlying Overfull \hbox (5.09616pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 The first pair of values should give the coordinates of the b ottom left corner Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of the plotting area and the second pair should give the coordi nates of the top Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 right corner. The coordinate on the horizontal axis should be g iven first in Overfull \hbox (37.11334pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [396] Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 An array giving the coordinates of two points in the supplied F rame (or in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 base Frame if a FrameSet was supplied) which correspond to the bottom left and Overfull \hbox (47.61078pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 top right corners of the plotting area, as specified above. Thi s range of coordinates Overfull \hbox (21.10475pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 will be mapped linearly on to the plotting area. The coordinate s should be given LaTeX Warning: Hyper reference `astSet' on page 397 undefined on input line 239 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pl ot. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Base' on page 397 undefined on input line 23932 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 The base Frame of the returned Plot will be a new Frame whi ch is created by this Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 function to represent the coordinate system of the underlying g raphics system Overfull \hbox (5.09616pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 (graphical coordinates). It is given a Frame index of 1 within the Plot. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 choice of base Frame (Base attribute) should not, in general, b e changed once Overfull \hbox (37.11334pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 a Plot has been created (although you could use this as a way o f moving the plotting Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a Frame is supplied (via the " frame" pointer), then it becomes the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a FrameSet is supplied (via the " frame" pointer), then all the Frames within Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 this FrameSet become part of the new Plot (where their Frame in dices are increased Overfull \hbox (17.69308pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 by 1), with the FrameSet' s current Frame becoming the current Frame of the Plot. LaTeX Warning: Hyper reference `Title' on page 397 undefined on input line 2393 2. Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is supplied (via the " frame" pointer), then Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 the returned Plot will contain two Frames, both created by this function. The Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 base Frame will describe graphics coordinates (as above) and th e current Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 will be a basic Frame with no attributes set (this will therefo re give default Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 values for such things as the Plot Title and the Label on each axis). Physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 An error will result if the Frame supplied (or the base Fra me if a FrameSet was Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [397] LaTeX Warning: Hyper reference `Plot3D' on page 398 undefined on input line 240 68. LaTeX Warning: Hyper reference `Plot' on page 398 undefined on input line 24068 . Overfull \hbox (28.9294pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 AstPlot3D $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPlot3D( As tFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const float graphbox[ 6 ], const double basebox[ LaTeX Warning: Hyper reference `Frame' on page 398 undefined on input line 2406 8. LaTeX Warning: Hyper reference `FrameSet' on page 398 undefined on input line 2 4068. Overfull \hbox (1.94693pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 Pointer to a Frame describing the physical coordinate system in which to plot. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 A pointer to a FrameSet may also be given, in which case its cu rrent Frame will Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 be used to define the physical coordinate system and its base F rame will be mapped LaTeX Warning: Hyper reference `Object' on page 398 undefined on input line 240 68. LaTeX Warning: Hyper reference `Label(axis)' on page 398 undefined on input lin e 24068. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is given, a default 3-di mensional Frame will Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 be used to describe the physical coordinate system. Labels, etc . may then be Overfull \hbox (15.06873pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 attached to this by setting the appropriate Frame attributes (e .g. Label(axis)) Overfull \hbox (31.60219pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 An array giving the position and extent of the plotting volume (within the plotting Overfull \hbox (12.44437pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 space of the underlying graphics system) in which graphical out put is to appear. Overfull \hbox (15.85603pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 This must be specified using graphical coordinates appropriate to the underlying Overfull \hbox (15.5936pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 The first triple of values should give the coordinates of the bottom left corner Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of the plotting volume and the second triple should give the co ordinates of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 top right corner. The coordinate on the horizontal axis should be given first Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 in each pair. Note that the order in which these points are giv en is important Overfull \hbox (12.44437pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 because it defines up, down, left and right for subsequent grap hical operations. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 An array giving the coordinates of two points in the supplied F rame (or in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 base Frame if a FrameSet was supplied) which correspond to the bottom left and Overfull \hbox (58.10822pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 top right corners of the plotting volume, as specified above. T his range of coordinates Overfull \hbox (21.10475pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 will be mapped linearly on to the plotting area. The coordinate s should be given LaTeX Warning: Hyper reference `astSet' on page 398 undefined on input line 240 68. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pl ot3D. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [398] LaTeX Warning: Hyper reference `Base' on page 399 undefined on input line 24068 . Overfull \hbox (0.10988pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 The base Frame of the returned Plot3D will be a new Frame w hich is created by Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 this function to represent the coordinate system of the underly ing graphics system Overfull \hbox (10.34488pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 (graphical coordinates). It is given a Frame index of 1 within the Plot3D. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 choice of base Frame (Base attribute) should not, in general, b e changed once Overfull \hbox (0.37231pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 a Plot3D has been created (although you could use this as a way of moving the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a Frame is supplied (via the " frame" pointer), then it becomes the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a FrameSet is supplied (via the " frame" pointer), then all the Frames within Overfull \hbox (37.11334pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 this FrameSet become part of the new Plot3D (where their Frame indices are increased Overfull \hbox (28.19052pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 by 1), with the FrameSet' s current Frame becoming the current Frame of the Plot3D. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 At least one of the three axes of the current Frame must be independent of the LaTeX Warning: Hyper reference `Title' on page 399 undefined on input line 2406 8. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is supplied (via the " frame" pointer), then Overfull \hbox (16.11847pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 the returned Plot3D will contain two Frames, both created by th is function. The Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 base Frame will describe graphics coordinates (as above) and th e current Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 will be a basic Frame with no attributes set (this will therefo re give default Overfull \hbox (21.10475pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 values for such things as the Plot3D Title and the Label on eac h axis). Physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 An error will result if the Frame supplied (or the base Fra me if a FrameSet was Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [399] LaTeX Warning: Hyper reference `PointList' on page 400 undefined on input line 24201. LaTeX Warning: Hyper reference `Region' on page 400 undefined on input line 242 01. LaTeX Warning: Hyper reference `Frame' on page 400 undefined on input line 2420 1. Overfull \hbox (34.17812pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 AstPointList $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPointLi st( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int npnt, int ncoord, int dim, const double Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame LaTeX Warning: Hyper reference `Naxes' on page 400 undefined on input line 2420 1. Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The number of coordinates being supplied for each point. This m ust equal the Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " poin ts" array (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 contains the point coordinates). This value is required so that the coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 values can be correctly located if they do not entirely fill th is array. The Overfull \hbox (31.60219pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of sh ape " [ncoord][dim]" Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 giving the physical coordinates of the points. These should be stored such that Overfull \hbox (31.86462pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the value of coordinate number " coord" for point number " pnt" is found in element Overfull \hbox (47.34834pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 with each point in the PointList being created. The uncertainty at any point Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 in the PointList is found by shifting the supplied " uncertaint y" Region so that Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 it is centred at the point being considered. The area covered b y the shifted Overfull \hbox (36.8509pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 uncertainty Region then represents the uncertainty in the posit ion. The uncertainty LaTeX Warning: Hyper reference `Box' on page 400 undefined on input line 24201. LaTeX Warning: Hyper reference `Circle' on page 400 undefined on input line 242 01. LaTeX Warning: Hyper reference `Ellipse' on page 400 undefined on input line 24 201. LaTeX Warning: Hyper reference `Prism' on page 400 undefined on input line 2420 1. LaTeX Warning: Hyper reference `Object' on page 400 undefined on input line 242 01. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 will have no effect on the created Box. Alternatively, a NULL O bject pointer may Overfull \hbox (31.86462pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 be supplied, in which case a default uncertainty is used equiva lent to a box 1.0E-6 LaTeX Warning: Hyper reference `astOverlap' on page 400 undefined on input line 24201. LaTeX Warning: Hyper reference `astSimplify' on page 400 undefined on input lin e 24201. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [400] LaTeX Warning: Hyper reference `astSet' on page 401 undefined on input line 242 01. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po intList. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [401] LaTeX Warning: Hyper reference `PolyMap' on page 402 undefined on input line 24 278. Overfull \hbox (29.14058pt too wide) in paragraph at lines 24278--24278 []\T1/cmtt/m/n/10 void astPolyCoeffs( AstPolyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 this, int forward, int nel, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 coeffs, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ncoeff LaTeX Warning: Hyper reference `Mapping' on page 402 undefined on input line 24 278. Overfull \hbox (17.69308pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 If non-zero, the coefficients of the forward PolyMap transforma tion are returned. Overfull \hbox (0.32106pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 The length of the supplied " coeffs" array. It should be at lea st " ncoeff$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ( Overfull \hbox (22.53198pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 nin $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 2 )" if " foward" is n on-zero, and " ncoeff$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ( nout $\OT1/zplm/m/ n/10 +$ \T1/cmtt/m/n/10 2 )" otherwise, where Overfull \hbox (5.62103pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 " ncoeff" is the number of coefficients to be returned. If a va lue of zero is Overfull \hbox (21.36719pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 supplied, no coefficient values are returned, but the number of coefficients used Overfull \hbox (21.10475pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 An array in which to return the coefficients used by the reques ted transformation Overfull \hbox (0.37231pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 of the PolyMap. Ignored if " nel" is zero. The coefficient data is returned Overfull \hbox (5.62103pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 in the form in which it is supplied to the PolyMap constructor. That is, each Overfull \hbox (32.81824pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" or " 2 $ \OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" adjacent elements describe a single c oefficient Overfull \hbox (37.11334pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 of the forward or inverse transformation. See the PolyMap const ructor documentation Overfull \hbox (47.61078pt too wide) in paragraph at lines 24278--24278 []\T1/cmtt/m/n/10 If the supplied array is too short to hold all the coefficien ts, trailing coefficients Overfull \hbox (55.48386pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 are excluded. If the supplied array is longer than needed to ho ld all the coefficients, Overfull \hbox (21.10475pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 The number of coefficients used by the requested transformation . A value of zero Overfull \hbox (26.6159pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [402] LaTeX Warning: Hyper reference `Plot' on page 403 undefined on input line 24355 . LaTeX Warning: Hyper reference `astCurve' on page 403 undefined on input line 2 4355. LaTeX Warning: Hyper reference `Mapping' on page 403 undefined on input line 24 355. LaTeX Warning: Hyper reference `astClip' on page 403 undefined on input line 24 355. Overfull \hbox (18.43196pt too wide) in paragraph at lines 24355--24355 []\T1/cmtt/m/n/10 void astPolyCurve( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, int npoint, int ncoord, int indim, const double $\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 in LaTeX Warning: Hyper reference `Frame' on page 403 undefined on input line 2435 5. LaTeX Warning: Hyper reference `Naxes' on page 403 undefined on input line 2435 5. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 The number of coordinates being supplied for each point (i.e. t he number of axes Overfull \hbox (36.8509pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (0.37231pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 the input coordinates). This value is required so that the coor dinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 24355--24355 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord][indim]" Overfull \hbox (16.11847pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 giving the physical coordinates of the points which are to be j oined in sequence Overfull \hbox (0.37231pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 by geodesic curves. These should be stored such that the value of coordinate Overfull \hbox (21.36719pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 number " coord" for point number " point" is found in element " in[coord][point]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 24355--24355 [][]\T1/cmtt/m/n/10 No curve is drawn on either side of any point which has any coordinate equal to LaTeX Warning: Hyper reference `TranInverse' on page 403 undefined on input lin e 24355. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24355--24355 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [403] LaTeX Warning: Hyper reference `PolyMap' on page 404 undefined on input line 24 482. LaTeX Warning: Hyper reference `Mapping' on page 404 undefined on input line 24 482. LaTeX Warning: Hyper reference `IterInverse' on page 404 undefined on input lin e 24482. Overfull \hbox (12.97206pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 AstPolyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPolyMap( int nin, int nout, int ncoeff_f, const double coeff_f[], int Overfull \hbox (26.35347pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the for ward transformation Overfull \hbox (28.19052pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of the PolyMap. If zero is supplied, the forward transformation will be undefined. Overfull \hbox (17.02083pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 An array containing " ncoeff_f$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" Overfull \hbox (1.94693pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the forward transformation. Overfull \hbox (36.8509pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 Within each such group, the first element is the coefficient va lue; the next element Overfull \hbox (16.11847pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 is the integer index of the PolyMap output which uses the coeff icient within its Overfull \hbox (0.37231pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 defining polynomial (the first output has index 1); the remaini ng elements of Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 the group give the integer powers to use with each input coordi nate value (powers Overfull \hbox (33.43924pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 For instance, if the PolyMap has 3 inputs and 2 outputs, each group consisting Overfull \hbox (37.11334pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of 5 elements, A groups such as " (1.2, 2.0, 1.0, 3.0, 0.0)" de scribes a coefficient Overfull \hbox (21.10475pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 with value 1.2 which is used within the definition of output 2. The output value Overfull \hbox (42.36206pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 is incremented by the product of the coefficient value, the val ue of input coordinate Overfull \hbox (15.5936pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 1 raised to the power 1, and the value of input coordinate 2 ra ised to the power Overfull \hbox (36.8509pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 3. Input coordinate 3 is not used since its power is specified as zero. As another Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 example, the group " (-1.0, 1.0, 0.0, 0.0, 0.0 )" describes add s a constant value Overfull \hbox (8.24539pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 -1.0 onto output 1 (it is a constant value since the power for every input axis Overfull \hbox (16.11847pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 Each final output coordinate value is the sum of the " ncoeff _f" terms described Overfull \hbox (26.35347pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the inv erse transformation Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of the PolyMap. If zero is supplied, the default behaviour is t o use an iterative Overfull \hbox (47.61078pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 method to evaluate the inverse based only on the forward transf ormation (see attribute Overfull \hbox (27.51826pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 An array containing " ncoeff_i$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" Overfull \hbox (2.99667pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the inverse transformation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 using the same schame as " coeff_f" , except that " inputs" and " outputs" are Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [404] LaTeX Warning: Hyper reference `astSet' on page 405 undefined on input line 244 82. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po lyMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24482--24482 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 405 undefined on input line 244 82. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [405] LaTeX Warning: Hyper reference `PolyMap' on page 406 undefined on input line 24 657. LaTeX Warning: Hyper reference `Mapping' on page 406 undefined on input line 24 657. Overfull \hbox (31.86462pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 If non-zero, the forward PolyMap transformation is replaced. Ot herwise the inverse Overfull \hbox (21.10475pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The target accuracy, expressed as a geodesic distance within th e PolyMap' s input Overfull \hbox (26.35347pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The maximum allowed accuracy for an acceptable polynomial, expr essed as a geodesic Overfull \hbox (26.6159pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 distance within the PolyMap' s input space (if " forward" is ze ro) or output space Overfull \hbox (5.09616pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The maximum allowed polynomial order. This is one more than the maximum power Overfull \hbox (43.93668pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 of either input axis. So for instance, a value of 3 refers to a quadratic polynomial. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Note, cross terms with total powers greater than or equal to ma xorder are not Overfull \hbox (47.61078pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [406] LaTeX Warning: Hyper reference `Nin' on page 407 undefined on input line 24657. LaTeX Warning: Hyper reference `Nout' on page 407 undefined on input line 24657 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Pointer to an array holding the lower bounds of a rectangular r egion within the Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 PolyMap' s input space (if " forward" is zero) or output space (if " forward" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 is non-zero). The new polynomial will be evaluated over this re ctangle. The Overfull \hbox (34.48898pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 length of this array should equal the value of the PolyMap' s N in or Nout attribute, Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Pointer to an array holding the upper bounds of a rectangular r egion within the Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 PolyMap' s input space (if " forward" is zero) or output space (if " forward" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 is non-zero). The new polynomial will be evaluated over this re ctangle. The Overfull \hbox (34.48898pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 length of this array should equal the value of the PolyMap' s N in or Nout attribute, LaTeX Warning: Hyper reference `ChebyMap' on page 407 undefined on input line 2 4657. Overfull \hbox (2.001pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The ChebyMap implementation of this method allows NULL pointers to be supplied for Overfull \hbox (44.51563pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 " lbnd" and/or " ubnd" , in which case the corresponding bounds supplied when the ChebyMap Overfull \hbox (44.25319pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 was created are used. The returned PolyMap will be a ChebyMap, and the new transformation Overfull \hbox (2.26344pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 A pointer to the new PolyMap. A NULL pointer will be returned i f the fit fails to LaTeX Warning: Hyper reference `IterInverse' on page 407 undefined on input lin e 24657. Overfull \hbox (16.11847pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 The IterInverse attribute is always cleared in the returned PolyMap. This means Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 that the returned PolyMap will always use the new fit by defaul t, rather than Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 the iterative inverse, regardless of the setting of IterInverse in the supplied Overfull \hbox (5.3586pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 This function can only be used on 1D or 2D PolyMaps which h ave the same number LaTeX Warning: Hyper reference `Object' on page 407 undefined on input line 246 57. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [407] LaTeX Warning: Hyper reference `Polygon' on page 408 undefined on input line 24 802. LaTeX Warning: Hyper reference `Frame' on page 408 undefined on input line 2480 2. LaTeX Warning: Hyper reference `SkyFrame' on page 408 undefined on input line 2 4802. Overfull \hbox (50.13545pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPolygon( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int npnt, int dim, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 points, AstRegion LaTeX Warning: Hyper reference `Region' on page 408 undefined on input line 248 02. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. It must have exactly 2 Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 axes. A deep copy is taken of the supplied Frame. This means th at any subsequent Overfull \hbox (33.43924pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 changes made to the Frame using the supplied pointer will have no effect the Region. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " poin ts" array (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 contains the point coordinates). This value is required so that the coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 values can be correctly located if they do not entirely fill th is array. The Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of sh ape " [2][dim]" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 giving the physical coordinates of the vertices. These should b e stored such Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 that the value of coordinate number " coord" for point number " pnt" is found Overfull \hbox (47.34834pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 with the boundary of the Polygon being created. The uncertainty in any point Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 on the boundary of the Polygon is found by shifting the supplie d " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the LaTeX Warning: Hyper reference `Box' on page 408 undefined on input line 24802. LaTeX Warning: Hyper reference `Circle' on page 408 undefined on input line 248 02. LaTeX Warning: Hyper reference `Ellipse' on page 408 undefined on input line 24 802. LaTeX Warning: Hyper reference `Prism' on page 408 undefined on input line 2480 2. LaTeX Warning: Hyper reference `Object' on page 408 undefined on input line 248 02. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a P rism containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 will have no effect on the created Polygon. Alternatively, a NU LL Object pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [408] LaTeX Warning: Hyper reference `astOverlap' on page 409 undefined on input line 24802. LaTeX Warning: Hyper reference `astSimplify' on page 409 undefined on input lin e 24802. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the astOverlap f unction compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 system and subsequently simplified (using astSimplify), the unc ertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 409 undefined on input line 248 02. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po lygon. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [409] LaTeX Warning: Hyper reference `Prism' on page 410 undefined on input line 2488 1. LaTeX Warning: Hyper reference `Region' on page 410 undefined on input line 248 81. LaTeX Warning: Hyper reference `Circle' on page 410 undefined on input line 248 81. LaTeX Warning: Hyper reference `Interval' on page 410 undefined on input line 2 4881. Overfull \hbox (9.9315pt too wide) in paragraph at lines 24881--24881 []\T1/cmtt/m/n/10 AstPrism $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPrism( AstR egion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region1, AstRegion $\OMS/zplm/m/n/1 0 ^^C$\T1/cmtt/m/n/10 region2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... LaTeX Warning: Hyper reference `astSet' on page 410 undefined on input line 248 81. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pr ism. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24881--24881 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no LaTeX Warning: Hyper reference `Object' on page 410 undefined on input line 248 81. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [410] LaTeX Warning: Hyper reference `Table' on page 411 undefined on input line 2490 1. [411] LaTeX Warning: Hyper reference `FitsChan' on page 412 undefined on input line 2 4923. [412] LaTeX Warning: Hyper reference `FitsChan' on page 413 undefined on input line 2 4969. LaTeX Warning: Hyper reference `Card' on page 413 undefined on input line 24969 . LaTeX Warning: Hyper reference `astRead' on page 413 undefined on input line 24 969. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS cards to be Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 stored. Each individual card should occupy 80 characters in thi s string, and Overfull \hbox (21.36719pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 there should be no delimiters, new lines, etc, between adjacent cards. The final Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 card may be less than 80 characters long. This is the format pr oduced by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24969--24969 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [413] LaTeX Warning: Hyper reference `Channel' on page 414 undefined on input line 25 013. LaTeX Warning: Hyper reference `astChannelData' on page 414 undefined on input line 25013. Overfull \hbox (47.34834pt too wide) in paragraph at lines 25013--25013 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [414] Overfull \hbox (15.8076pt too wide) in paragraph at lines 25071--25071 []\T1/cmtt/m/n/10 void astPutColumnData( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int clen, size_t size, LaTeX Warning: Hyper reference `FitsTable' on page 415 undefined on input line 25071. Overfull \hbox (22.67937pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 If the column holds character strings, then this must be set to the length of Overfull \hbox (16.11847pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 each fixed length string in the supplied array. This is often d etermined by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 appropriate TFORMn keyword in the binary table header. The supp lied value is Overfull \hbox (10.60732pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 The size of the " coldata" array, in bytes. This should be an i nteger multiple Overfull \hbox (5.62103pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 of the number of bytes needed to hold the full vector value sto red in a single Overfull \hbox (0.10988pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 A pointer to an area of memory holding the data to copy into th e column. The Overfull \hbox (21.10475pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 values should be stored in row order. If the column holds non-s calar values, the Overfull \hbox (42.36206pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [415] LaTeX Warning: Hyper reference `FitsChan' on page 416 undefined on input line 2 5124. LaTeX Warning: Hyper reference `Card' on page 416 undefined on input line 25124 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 Pointer to a possibly null-terminated character string containi ng the FITS card Overfull \hbox (21.10475pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 to be stored. No more than 80 characters will be used from this string (or fewer Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 If this value is zero, the new card is inserted in front of the current card in Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 the FitsChan (as identified by the initial value of the Card at tribute). If it Overfull \hbox (5.62103pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 is non-zero, the new card replaces the current card. In either case, the Card Overfull \hbox (16.11847pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 attribute is then incremented by one so that it subsequently id entifies the card Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 [][]\T1/cmtt/m/n/10 If the Card attribute initially points at the " end-of-file " (i.e. exceeds the Overfull \hbox (16.11847pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 number of cards in the FitsChan), then the new card is appended as the last card Overfull \hbox (26.35347pt too wide) in paragraph at lines 25124--25124 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [416] LaTeX Warning: Hyper reference `FitsChan' on page 417 undefined on input line 2 5178. LaTeX Warning: Hyper reference `astRead' on page 417 undefined on input line 25 178. LaTeX Warning: Hyper reference `FitsTable' on page 417 undefined on input line 25178. Overfull \hbox (52.8595pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 Pointer to a FitsTable to be added to the FitsChan. If a FitsTa ble with the associated Overfull \hbox (7.19565pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 extension name already exists in the FitsChan, it is replaced w ith the new one. Overfull \hbox (21.10475pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 A deep copy of the FitsTable is stored in the FitsChan, so any subsequent changes LaTeX Warning: Hyper reference `astGetTables' on page 417 undefined on input li ne 25178. LaTeX Warning: Hyper reference `astPutTables' on page 417 undefined on input li ne 25178. [417] LaTeX Warning: Hyper reference `FitsTable' on page 418 undefined on input line 25224. LaTeX Warning: Hyper reference `FitsChan' on page 418 undefined on input line 2 5224. LaTeX Warning: Hyper reference `Table' on page 418 undefined on input line 2522 4. Overfull \hbox (16.11847pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 Pointer to a FitsChan holding the headers for the FitsTable. A deep copy of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 supplied FitsChan is stored in the FitsTable, replacing the cur rent FitsChan in Overfull \hbox (2.99667pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 the Fitstable. Keywords that are fixed either by the properties of the Table, Overfull \hbox (37.11334pt too wide) in paragraph at lines 25224--25224 [][]\T1/cmtt/m/n/10 The attributes of the supplied FitsChan, together with any source and sink functions Overfull \hbox (5.62103pt too wide) in paragraph at lines 25224--25224 [][]\T1/cmtt/m/n/10 Values for the following keywords are generated automatical ly by the FitsTable Overfull \hbox (47.0859pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 (any values for these keywords in the supplied FitsChan will be ignored): " XTENSION" Overfull \hbox (31.86462pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [418] LaTeX Warning: Hyper reference `FitsChan' on page 419 undefined on input line 2 5282. LaTeX Warning: Hyper reference `astRead' on page 419 undefined on input line 25 282. LaTeX Warning: Hyper reference `KeyMap' on page 419 undefined on input line 252 82. LaTeX Warning: Hyper reference `FitsTable' on page 419 undefined on input line 25282. Overfull \hbox (26.6159pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 Pointer to a KeyMap holding the tables that are to be added to the FitsChan. Each Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 entry should hold a scalar value which is a pointer to a FitsTa ble to be added Overfull \hbox (21.36719pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 to the FitsChan. Any unusable entries are ignored. The key asso ciated with each Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 entry should be the name of the FITS binary extension from whic h the table was Overfull \hbox (16.11847pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 read. If a FitsTable with the associated key already exists in the FitsChan, it Overfull \hbox (0.37231pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 is replaced with the new one. A deep copy of each usable FitsTa ble is stored Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 in the FitsChan, so any subsequent changes made to the FitsTabl es will have no LaTeX Warning: Hyper reference `astGetTables' on page 419 undefined on input li ne 25282. Overfull \hbox (22.9418pt too wide) in paragraph at lines 25282--25282 [][]\T1/cmtt/m/n/10 The tables in the supplied KeyMap are added to any tables a lready in the FitsChan. LaTeX Warning: Hyper reference `astPutTable' on page 419 undefined on input lin e 25282. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25282--25282 [][]\T1/cmtt/m/n/10 The astPutTable method provides a simpler means of adding a single table to a [419] LaTeX Warning: Hyper reference `Mapping' on page 420 undefined on input line 25 397. Overfull \hbox (15.85886pt too wide) in paragraph at lines 25397--25397 []\T1/cmtt/m/n/10 int QuadApprox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, const double lbnd[2], const double ubnd[2], int nx, LaTeX Warning: Hyper reference `Nin' on page 420 undefined on input line 25397. Overfull \hbox (26.6159pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the lower bounds of a box defined within Overfull \hbox (21.10475pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 the input coordinate system of the Mapping. The number of eleme nts in this array Overfull \hbox (15.85603pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 should equal the value of the Mapping' s Nin attribute. This bo x should specify Overfull \hbox (16.11847pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.37231pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 The number of points to place along the first Mapping inp ut. The first point Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 is at " lbnd[0]" and the last is at " ubnd[0]" . If a value les s than three is Overfull \hbox (5.62103pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 The number of points to place along the second Mapping in put. The first point Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 is at " lbnd[1]" and the last is at " ubnd[1]" . If a value les s than three is LaTeX Warning: Hyper reference `Nout' on page 420 undefined on input line 25397 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 Pointer to an array of doubles in which to return the co- efficients of the quadratic Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 approximation to the specified transformation. This array shoul d have at least Overfull \hbox (0.5835pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 " 6$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Nout" , elements. The first 6 elements hold the fit to the first Mapping Overfull \hbox (16.11847pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 output. The next 6 elements hold the fit to the second Mapping output, etc. So Overfull \hbox (37.11334pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 if the Mapping has 2 inputs and 2 outputs the quadratic approxi mation to the forward Overfull \hbox (29.52779pt too wide) in paragraph at lines 25397--25397 []\T1/cmtt/m/n/10 X_out = fit[0] $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[1]$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fi t[2]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/ n/10 fit[3]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/ cmtt/m/n/10 Y_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[4]$\OMS/zplm/m/n/10 ^ ^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in Overfull \hbox (27.70023pt too wide) in paragraph at lines 25397--25397 \OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[5]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in Y_out = fit[6] $\OT1/zplm/m/n/1 0 +$ \T1/cmtt/m/n/10 fit[7]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in $\OT1/zpl m/m/n/10 +$ \T1/cmtt/m/n/10 fit[8]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in $\ OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[9]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to a double in which to return the RMS residual between the fit and the Overfull \hbox (2.52588pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 If a quadratic approximation was created, a non-zero value is r eturned. Otherwise LaTeX Warning: Hyper reference `astInvert' on page 420 undefined on input line 25397. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25397--25397 [][]\T1/cmtt/m/n/10 This function fits the Mapping' s forward transformation. T o fit the inverse Overfull \hbox (5.62103pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using astInvert before invoking [420] Overfull \hbox (26.35347pt too wide) in paragraph at lines 25397--25397 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [421] LaTeX Warning: Hyper reference `Mapping' on page 422 undefined on input line 25 466. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25466--25466 [] \T1/cmtt/m/n/10 The address of an array holding the axis values at the po sition at which the rate Overfull \hbox (16.11847pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 of change is to be evaluated. The number of elements in this ar ray should equal Overfull \hbox (31.60219pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The index of the Mapping output for which the rate of change is to be found (output Overfull \hbox (5.3586pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The index of the Mapping input which is to be varied in order t o find the rate Overfull \hbox (12.76088pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The rate of change of Mapping output " ax1" with respect to inp ut " ax2" , evaluated Overfull \hbox (16.11847pt too wide) in paragraph at lines 25466--25466 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [422] LaTeX Warning: Hyper reference `RateMap' on page 423 undefined on input line 25 566. LaTeX Warning: Hyper reference `Mapping' on page 423 undefined on input line 25 566. Overfull \hbox (4.4716pt too wide) in paragraph at lines 25566--25566 []\T1/cmtt/m/n/10 AstRateMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astRateMap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, int ax1, int ax2, const c har $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... Overfull \hbox (5.62103pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Index of the output from the encapsulated Mapping for which the rate of change Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 is required. This corresponds to the delta quantity forming the numerator of Overfull \hbox (52.8595pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Index of the input to the encapsulated Mapping which is to be v aried. This corresponds Overfull \hbox (42.36206pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 to the delta quantity forming the denominator of the required e lement of the Jacobian LaTeX Warning: Hyper reference `astSet' on page 423 undefined on input line 255 66. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ra teMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 25566--25566 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `astCopy' on page 423 undefined on input line 25 566. Overfull \hbox (10.60732pt too wide) in paragraph at lines 25566--25566 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astRateMap (the new Overfull \hbox (5.3586pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 RateMap simply retains a reference to them). They may continue to be used for Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a RateMap contain ing a copy of Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [423] LaTeX Warning: Hyper reference `Object' on page 424 undefined on input line 255 66. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25566--25566 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [424] LaTeX Warning: Hyper reference `Object' on page 425 undefined on input line 256 34. LaTeX Warning: Hyper reference `Channel' on page 425 undefined on input line 25 634. LaTeX Warning: Hyper reference `FitsChan' on page 425 undefined on input line 2 5634. LaTeX Warning: Hyper reference `astRetainFits' on page 425 undefined on input l ine 25634. Overfull \hbox (18.0096pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 All successful use of astRead on a FitsChan is destructive, so that FITS header cards Overfull \hbox (7.7746pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 are consumed in the process of reading an Object, and are remov ed from the FitsChan Overfull \hbox (33.49332pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 (this deletion can be prevented for specific cards by calling t he FitsChan astRetainFits Overfull \hbox (18.27203pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 function). An unsuccessful call of astRead (for instance, cause d by the FitsChan not Overfull \hbox (2.52588pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 containing the necessary FITS headers cards needed to create an Object) results in LaTeX Warning: Hyper reference `StcsChan' on page 425 undefined on input line 2 5634. LaTeX Warning: Hyper reference `Region' on page 425 undefined on input line 256 34. LaTeX Warning: Hyper reference `KeyMap' on page 425 undefined on input line 256 34. LaTeX Warning: Hyper reference `StcsArea' on page 425 undefined on input line 2 5634. LaTeX Warning: Hyper reference `StcsCoords' on page 425 undefined on input line 25634. LaTeX Warning: Hyper reference `StcsProps' on page 425 undefined on input line 25634. Overfull \hbox (17.74716pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 The AST Object returned by a successful use of astRead on an St csChan, will be either Overfull \hbox (28.76947pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 a Region or a KeyMap, depending on the values of the StcsArea, StcsCoords and StcsProps Overfull \hbox (2.001pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 A pointer to the new Object. The class to which this will belon g is determined by Overfull \hbox (21.36719pt too wide) in paragraph at lines 25634--25634 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned, without error, if the Channel Overfull \hbox (16.11847pt too wide) in paragraph at lines 25634--25634 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [425] LaTeX Warning: Hyper reference `FitsChan' on page 426 undefined on input line 2 5676. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25676--25676 [][]\T1/cmtt/m/n/10 This function returns without action if no source function was specified when LaTeX Warning: Hyper reference `SourceFile' on page 426 undefined on input line 25676. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25676--25676 [][]\T1/cmtt/m/n/10 The SourceFile attribute is ignored by this function. New c ards are read from [426] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. LaTeX Warning: Hyper reference `Mapping' on page 427 undefined on input line 26 182. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 427 undefined on in put line 26182. Overfull \hbox (6.0526pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 void astRebin$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, double wlim, int ndim_in, const int lbnd_in[], Overfull \hbox (14.93054pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T 1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int spread, const Overfull \hbox (0.85513pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 double params[], int flags, double tol, int maxpix, $\OML/zplm/ m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, in t ndim_out, Overfull \hbox (34.9718pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 const int lbnd_out[], const int ubnd_out[], const int lbnd[], c onst int ubnd[], $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ [427] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to a Mapping, whose forward transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 coordinates of pixels in the input grid into the coordinate sys tem of the output LaTeX Warning: Hyper reference `Nin' on page 428 undefined on input line 26182. LaTeX Warning: Hyper reference `Nout' on page 428 undefined on input line 26182 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its Nin attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates (Nout attrib ute) should match Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Gives the required number of input pixel values which must cont ribute to an output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 pixel in order for the output pixel value to be considered vali d. If the sum Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the input pixel weights contributing to an output pixel is l ess than the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 " wlim" value, then the output pixel value is returned set to t he supplied bad Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the input data to be rebined. The numerical type of this array should match the Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 1- or 2-character type code appended to the function name (e.g. if you are using Overfull \hbox (15.85603pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array. If this array is supplied (together with the correspondi ng " out_var" Overfull \hbox (38.68796pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array), then estimates of the variance of the rebined output da ta will be calculated. Overfull \hbox (22.9418pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no input variance estimates are being provided, a NULL poi nter should be given. Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for dividing eac h input data value Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 up amongst the corresponding output pixels. It may be used to s elect from a set Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of pre-defined schemes by supplying one of the values described in the " Pixel Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Spreading Schemes" section below. If a value of zero is supplie d, then the default Overfull \hbox (12.44437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 linear spreading scheme is used (equivalent to supplying the va lue AST__LINEAR). Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 parameter values required by the pixel spreading scheme. If suc h parameters are Overfull \hbox (31.60219pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [428] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 control over the rebinning operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the out put grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 in adjacent panel will be higher, and may cause the edges of th e panel to be visible Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 when viewing the output image at high contrast. If this is a pr oblem, reduce Overfull \hbox (36.8509pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (10.60732pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 In all cases, this value is also used to flag any output elem ents in the " out" Overfull \hbox (5.09616pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 (and " out_var" ) array(s) for which rebined values could not b e obtained (see Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the " Propagation of Missing Data" section below for details of the circumstances Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [429] Overfull \hbox (47.61078pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the first pixel in the region of the input grid which is to be included in Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the last pixel in the region of the input grid which is to b e included in the Overfull \hbox (84.08937pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 region of the input grid which is to be included in the rebined output array. This Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 region should lie wholly within the extent of the input grid (a s defined by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 " lbnd_in" and " ubnd_in" arrays). Regions of the input grid ly ing outside this Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid, in which Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the rebined data values will be returned. The numerical type of this array should Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 match that of the " in" array, and the data storage order shoul d be such that Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the index of the first grid dimension varies most rapidly and t hat of the final Overfull \hbox (12.18193pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to an array with the same type and size as the " out" array. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 If given, this array will be used to return variance estimates for the rebined Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 data values. This array will only be used if the " in_var" arra y has also been Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The output variance values will be calculated on the assumpti on that errors on Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the input data values are statistically independent and that th eir variance estimates Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 may simply be summed (with appropriate weighting factors) when several input pixels Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 contribute to an output data value. If this assumption is not v alid, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 output error estimates may be biased. In addition, note that th e statistical Overfull \hbox (36.0636pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 errors on neighbouring output data values (as well as the estim ates of those errors) Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 may often be correlated, even if the above assumption about the input data is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no output variance estimates are required, a NULL pointer should be given. Overfull \hbox (13.7145pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 To select the appropriate rebinning function, you should repl ace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the generic Overfull \hbox (3.47949pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 function name astRebin$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [430] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 431 undefined on in put line 26182. Overfull \hbox (41.17413pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that, unlike astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/ n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 , the astRebin$\OML/zplm/m/it/10 <$\ T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 set of functions does not yet support Overfull \hbox (12.76088pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The pixel spreading scheme specifies the Point Spread Functio n (PSF) applied to each Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 input pixel value as it is copied into the output array. It can be thought of as the Overfull \hbox (8.72821pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 inverse of the sub-pixel interpolation schemes used by the astR esample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n /10 group of Overfull \hbox (34.01819pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 functions. That is, in a sub-pixel interpolation scheme the ker nel specifies the weight Overfull \hbox (39.2669pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to assign to each input pixel when forming the weighted mean of the input pixels, whereas Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the kernel in a pixel spreading scheme specifies the fraction o f the input data value Overfull \hbox (2.26344pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 which is to be assigned to each output pixel. As for interpolat ion, the choice of Overfull \hbox (2.52588pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 suitable pixel spreading scheme involves stricking a balance be tween schemes which Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 tend to degrade sharp features in the data by smoothing them, a nd those which attempt Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to preserve sharp features but which often tend to introduce un wanted artifacts. See Overfull \hbox (18.0096pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The binning algorithm used has the ability to introduce artif acts not seen when using Overfull \hbox (20.8964pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 a resampling algorithm. Particularly, when viewing the output i mage at high contrast, Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 systems of curves lines covering the entire image may be visibl e. These are caused Overfull \hbox (15.64767pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 by a beating effect between the input pixel positions and the o utput pixels position, Overfull \hbox (2.52588pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 and their nature and strength depend critically upon the nature of the Mapping and Overfull \hbox (34.01819pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the spreading function being used. In general, the nearest neig hbour spreading function Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 demonstrates this effect more clearly than the other functions, and for this reason Overfull \hbox (7.51216pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The following values (defined in the " ast.h" header file) ma y be assigned to the " Overfull \hbox (24.47437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 spread" parameter. See the astResample$\OML/zplm/m/it/10 <$\T1/ cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 documentation for details of these schemes Overfull \hbox (64.79337pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 In addition, the following schemes can be used with astRebin$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 but no t with astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T 1/cmtt/m/n/10 : Overfull \hbox (16.54083pt too wide) in paragraph at lines 26182--26182 [][]\T1/cmtt/m/n/10 AST__GAUSS: This scheme uses a kernel of the form exp(-k$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), w ith k a positive Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 constant determined by the full-width at half-maximum (FWHM). T he FWHM should Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 be supplied in units of output pixels by means of the " params[ 1]" value and should Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 be at least 0.1. The " params[0]" value should be used to speci fy at what point Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the Gaussian is truncated to zero. This should be given as a nu mber of output Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 pixels on either side of the central output point in each dimen sion (the nearest Overfull \hbox (23.25832pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [431] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. Overfull \hbox (28.76947pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Instances of missing data (bad pixels) in the output grid are identified by occurrences Overfull \hbox (39.2669pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are produced if the sum of the weights Overfull \hbox (7.51216pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 An input pixel is considered bad (and is consequently ignored ) if its data value is Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 In addition, associated output variance estimates (if calcula ted) may be declared bad Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array fo r similar reasons. [432] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 433 undefined on input line 26767. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 433 undefined on in put line 26767. Overfull \hbox (21.79875pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 void astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, double wlim, int ndim_in, const int lbnd_in[], Overfull \hbox (14.93054pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T 1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int spread, const Overfull \hbox (0.85513pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 double params[], int flags, double tol, int maxpix, $\OML/zplm/ m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, in t ndim_out, Overfull \hbox (34.9718pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 const int lbnd_out[], const int ubnd_out[], const int lbnd[], c onst int ubnd[], $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ LaTeX Warning: Hyper reference `Mapping' on page 433 undefined on input line 26 767. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to a Mapping, whose forward transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 coordinates of pixels in the input grid into the coordinate sys tem of the output LaTeX Warning: Hyper reference `Nin' on page 433 undefined on input line 26767. LaTeX Warning: Hyper reference `Nout' on page 433 undefined on input line 26767 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its Nin attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates (Nout attrib ute) should match Overfull \hbox (2.99667pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the number of output grid dimensions given by " ndim_out" . If " in" is NULL, Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This value is only used if the AST__REBINEND flag is specified via the " flags" Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter. It gives the required number of input pixel values w hich must contribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to an output pixel (i.e. the output pixel weight) in order for the output pixel Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value to be considered valid. If the sum of the input pixel wei ghts contributing Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to an output pixel is less than the supplied " wlim" value, the n the output pixel Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [433] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The number of dimensions in the input grid. This should be at l east one. Not Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the centre of the first pixel in the input grid along each d imension. Not Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the input data to be rebined. The numerical type of this array should match the Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 1- or 2-character type code appended to the function name (e.g. if you are using Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 rapidly (i.e. Fortran array indexing is used). If a NULL pointe r is supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 for " in" , then no data is added to the output arrays, but any initialisation Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 array. If neither the AST__USEVAR nor the AST__VARWGT flag is s et, no input variance Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates are required and this pointer will not be used. A NUL L pointer may Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for dividing eac h input data value Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 up amongst the corresponding output pixels. It may be used to s elect from a set Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of pre-defined schemes by supplying one of the values described in the " Pixel Overfull \hbox (17.07208pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Spreading Schemes" section in the description of the astRebin$\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 funct ions. If Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 a value of zero is supplied, then the default linear spreading scheme is used Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter values required by the pixel spreading scheme. If suc h parameters are Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 required, this will be noted in the " Pixel Spreading Schemes" section in the Overfull \hbox (31.60219pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 control over the rebinning operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [434] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the out put grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in adjacent panel will be higher, and may cause the edges of th e panel to be visible Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 when viewing the output image at high contrast. If this is a pr oblem, reduce Overfull \hbox (36.8509pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 performance, accurate results will still be obtained. Not used if " in" is NULL. Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 In all cases, this value is also used to flag any output elem ents in the " out" Overfull \hbox (5.09616pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (and " out_var" ) array(s) for which rebined values could not b e obtained (see Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the " Propagation of Missing Data" section below for details of the circumstances Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (47.61078pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [435] Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the first pixel in the region of the input grid which is to be included in Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the last pixel in the region of the input grid which is to b e included in the Overfull \hbox (84.08937pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 region of the input grid which is to be included in the rebined output array. This Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 region should lie wholly within the extent of the input grid (a s defined by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 " lbnd_in" and " ubnd_in" arrays). Regions of the input grid ly ing outside this Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid. The Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 rebined data values will be added into the original contents of this array. The Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 numerical type of this array should match that of the " in" arr ay, and the data Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 storage order should be such that the index of the first grid d imension varies Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 most rapidly and that of the final dimension least rapidly (i.e . Fortran array Overfull \hbox (36.58847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A pointer to an array with the same type and size as the " out" array. This pointer Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 will only be used if the AST__USEVAR or AST__GENVAR flag is set in which case Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 variance estimates for the rebined data values will be added in to the array. If Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 neither the AST__USEVAR flag nor the AST__GENVAR flag is set, n o output variance Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates will be calculated and this pointer will not be used. A NULL pointer Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of double, with one or two elements for eac h pixel in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output grid, depending on whether or not the AST__GENVAR flag h as been supplied Overfull \hbox (20.84232pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 via the " flags" parameter. If AST__GENVAR has not been specifi ed then the array Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should have one element for each output pixel, and it will be u sed to accumulate Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the weight associated with each output pixel. If AST__GENVAR ha s been specified Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 then the array should have two elements for each output pixel. The first half Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the array is again used to accumulate the weight associated with each output Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel, and the second half is used to accumulate the square of the weights. In Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 each half, the data storage order should be such that the index of the first grid Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 dimension varies most rapidly and that of the final dimension l east rapidly (i.e. Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A pointer to an int64_t containing the number of input data val ues that have been Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 added into the output array so far. The supplied value is incre mented on exit Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by the number of input values used. The value is initially set to zero if the Overfull \hbox (13.7145pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 To select the appropriate rebinning function, you should repl ace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 function name astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match [436] Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 For example, astRebinSeqD would be used to process " double" da ta, while astRebinSeqI Overfull \hbox (14.93054pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that, unlike astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/ n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 , the astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 set of functions does not yet Overfull \hbox (23.25832pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__REBININIT: Used to mark the first call in a sequence. It indicates that Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the supplied " out" , " out_var" and " weights" arrays should b e filled with zeros Overfull \hbox (26.09103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (thus over-writing any supplied values) before adding the rebin ned input data into Overfull \hbox (28.19052pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 them. This flag should be used when rebinning the first input a rray in a sequence. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__REBINEND: Used to mark the last call in a sequence. It causes each value Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the " out" and " out_var" arrays to be divided by a normalis ation factor before Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 being returned. The normalisation factor for each output data v alue is just the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 corresponding value from the weights array. The normalisation f actor for each Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output variance value is the square of the data value normalisa tion factor (see Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also AST__CONSERVEFLUX). It also causes output data values to b e set bad if the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 corresponding weight is less than the value supplied for parame ter " wlim" . It Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also causes any temporary values stored in the output variance array (see flag Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 AST__GENVAR below) to be converted into usable variance values. Note, this flag Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__USEVAR: Indicates that output variance estimates shoul d be created by rebinning Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the supplied input variance estimates. An error will be reporte d if both this Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__GENVAR: Indicates that output variance estimates shoul d be created based Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 on the spread of input data values contributing to each output pixel. An error Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 will be reported if both this flag and the AST__USEVAR flag are supplied. If Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the AST__GENVAR flag is specified, the supplied output variance array is first Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 used as a work array to accumulate the temporary values needed to generate the Overfull \hbox (29.24026pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output variances. When the sequence ends (as indicated by the A ST__REBINEND flag), Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the contents of the output variance array are converted into th e required variance Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates. If the generation of such output variances is requir ed, this flag Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should be used on every invocation of this function within a se quence, and any Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 supplied input variances will have no effect on the output vari ances (although Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input variances will still be used to weight the input data if the AST__VARWGT Overfull \hbox (52.8595pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 flag is also supplied). The statistical meaning of these output varianes is determined Overfull \hbox (43.93668pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__DISVAR: This flag is ignored unless the AST__GENVAR fl ag has also been specified. Overfull \hbox (58.10822pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 It determines the statistical meaning of the generated output v ariances. If AST__DISVAR Overfull \hbox (33.43924pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 is not specified, generated variances represent variances on th e output mean values. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 If AST__DISVAR is specified, the generated variances represent the variance of Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the distribution from which the input values were taken. Each o utput variance Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 created with AST__DISVAR will be larger than that created witho ut AST__DISVAR Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [437] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__VARWGT: Indicates that the input data should be weight ed by the reciprocal Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the input variances. Otherwise, all input data are given equ al weight. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 this flag is specified, the calculation of the output variances (if any) is modified Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to take account of the varying weights assigned to the input da ta values. See Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__PARWGT: Indicates that a constant weight should be use d when pasting each Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel of the supplied input array into the returned arrays. Thi s extra weight Overfull \hbox (52.33463pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value should be inserted at the start of the " params" array (w hich should consequently Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 be one element longer than specified in the " Pixel Spreading S chemes" section Overfull \hbox (6.57465pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the description of the astRebin$\OML/zplm/m/it/10 <$\T1/cmtt /m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 functions). If the AST__VARWGT f lag is Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also specified, the total weight for each pixel is the product of the reciprocal Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the pixel variance and the value supplied in the last elemen t of the " params" Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__NONORM: If the simple unnormalised sum of all input da ta falling in each Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output pixel is required, then this flag should be set on each call in the sequence Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and the AST__REBINEND should not be used on the last call. In t his case NULL Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pointers can be supplied for " weights" and " nused" . This fla g cannot be used Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__CONSERVEFLUX: Indicates that the normalized output pix el values generated Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by the AST__REBINEND flag should be scaled in such a way as to preserve the total Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 data value in a feature on the sky. Without this flag, each nor malised output Overfull \hbox (58.10822pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel value represents a weighted mean of the input data values around the corresponding Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input position. is appropriate if the input data represents the spatial density Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of some quantity (e.g. surface brightness in Janskys per square arc-second) because Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the output pixel values will have the same normalisation and un its as the input Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel values. However, if the input data values represent flux (or some other Overfull \hbox (1.94693pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 physical quantity) per pixel, then the AST__CONSERVEFLUX flag c ould be of use. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 It causes each output pixel value to be scaled by the ratio of the output pixel Overfull \hbox (18.0096pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This flag can only be used if the Mapping is successfully appro ximated by one or more Overfull \hbox (2.52588pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 linear transformations. Thus an error will be reported if it us ed when the " tol" Overfull \hbox (2.52588pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter is set to zero (which stops the use of linear approxi mations), or if the Overfull \hbox (4.1005pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Mapping is too non-linear to be approximated by a piece-wise li near transformation. Overfull \hbox (44.25319pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The ratio of output to input pixel size is evaluated once for e ach panel of the piece-wise Overfull \hbox (34.01819pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 linear approximation to the Mapping, and is assumed to be const ant for all output pixels Overfull \hbox (26.14511pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the panel. The scaling factors for adjacent panels will in g eneral differ slightly, Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and so the joints between panels may be visible when viewing th e output image at high Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 contrast. If this is a problem, reduce the value of the " tol" parameter until the Overfull \hbox (3.21706pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 This flag should normally be supplied on each invocation of a stRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/ m/n/10 within Overfull \hbox (2.26344pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note, this flag cannot be used in conjunction with the AST__N OSCALE flag (an error Overfull \hbox (28.76947pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Instances of missing data (bad pixels) in the output grid are identified by occurrences Overfull \hbox (39.2669pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [438] Overfull \hbox (7.51216pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 An input pixel is considered bad (and is consequently ignored ) if its data value is Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 In addition, associated output variance estimates (if calcula ted) may be declared bad Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array fo r similar reasons. [439] LaTeX Warning: Hyper reference `Region' on page 440 undefined on input line 267 91. LaTeX Warning: Hyper reference `Plot' on page 440 undefined on input line 26791 . [440] LaTeX Warning: Hyper reference `Mapping' on page 441 undefined on input line 26 870. LaTeX Warning: Hyper reference `Frame' on page 441 undefined on input line 2687 0. LaTeX Warning: Hyper reference `FrameSet' on page 441 undefined on input line 2 6870. LaTeX Warning: Hyper reference `Nframe' on page 441 undefined on input line 268 70. Overfull \hbox (0.10988pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 The index within the FrameSet of the Frame to be modified. This value should Overfull \hbox (16.11847pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 lie in the range from 1 to the number of Frames in the FrameSet (as given by its Overfull \hbox (21.36719pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 Pointer to a Mapping whose forward transformation converts coor dinate values from Overfull \hbox (10.86975pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 the original coordinate system described by the Frame to the ne w one, and whose Overfull \hbox (0.10988pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter Overfull \hbox (31.86462pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 The relationship between the selected Frame and any other F rame within the FrameSet Overfull \hbox (15.85603pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 will be modified by this function, but the relationship between all other Frames LaTeX Warning: Hyper reference `Nin' on page 441 undefined on input line 26870. LaTeX Warning: Hyper reference `Nout' on page 441 undefined on input line 26870 . Overfull \hbox (20.31744pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 The number of input coordinate values accepted by the Mappi ng (its Nin attribute) Overfull \hbox (5.62103pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 and the number of output coordinate values generated (its Nout attribute) must LaTeX Warning: Hyper reference `astPermAxes' on page 441 undefined on input lin e 26870. Overfull \hbox (10.60732pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 If a simple change of axis order is required, then the astP ermAxes function may Overfull \hbox (38.68796pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 provide a more straightforward method of making the required ch anges to the FrameSet. LaTeX Warning: Hyper reference `astAddFrame' on page 441 undefined on input lin e 26870. LaTeX Warning: Hyper reference `astRemoveFrame' on page 441 undefined on input line 26870. Overfull \hbox (23.99155pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 This function cannot be used to change the number of Frame axes. To achieve this, Overfull \hbox (37.11334pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 a new Frame must be added to the FrameSet (astAddFrame) and the original one removed LaTeX Warning: Hyper reference `Variant' on page 441 undefined on input line 26 870. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 Any variant Mappings associated with the remapped Frame (ex cept for the current Overfull \hbox (5.3586pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [441] LaTeX Warning: Hyper reference `Table' on page 442 undefined on input line 2689 9. Overfull \hbox (17.43065pt too wide) in paragraph at lines 26899--26899 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [442] LaTeX Warning: Hyper reference `Frame' on page 443 undefined on input line 2695 8. LaTeX Warning: Hyper reference `FrameSet' on page 443 undefined on input line 2 6958. LaTeX Warning: Hyper reference `Nframe' on page 443 undefined on input line 269 58. Overfull \hbox (15.85603pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 The index within the FrameSet of the Frame to be removed. This value should lie Overfull \hbox (31.86462pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 in the range from 1 to the number of Frames in the FrameSet (as given by its Nframe Overfull \hbox (10.60732pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 Removing a Frame from a FrameSet does not affect the relati onship between other Overfull \hbox (33.43924pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 Frames in the FrameSet, even if they originally depended on the Frame being removed. Overfull \hbox (31.86462pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 The number of Frames in a FrameSet cannot be reduced to zer o. An error will result Overfull \hbox (0.10988pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter LaTeX Warning: Hyper reference `Base' on page 443 undefined on input line 26958 . LaTeX Warning: Hyper reference `Current' on page 443 undefined on input line 26 958. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 If a FrameSet' s base or current Frame is removed, the Base or Current attribute Overfull \hbox (20.84232pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 (respectively) of the FrameSet will have its value cleared, so that another Frame Overfull \hbox (12.44437pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 If any other Frame is removed, the base and current Frames will remain the same. Overfull \hbox (28.97783pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [443] LaTeX Warning: Hyper reference `Table' on page 444 undefined on input line 2698 7. Overfull \hbox (33.1768pt too wide) in paragraph at lines 26987--26987 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [444] LaTeX Warning: Hyper reference `Mapping' on page 445 undefined on input line 27 070. LaTeX Warning: Hyper reference `CmpMap' on page 445 undefined on input line 270 70. LaTeX Warning: Hyper reference `Region' on page 445 undefined on input line 270 70. LaTeX Warning: Hyper reference `UnitMap' on page 445 undefined on input line 27 070. LaTeX Warning: Hyper reference `CmpFrame' on page 445 undefined on input line 2 7070. LaTeX Warning: Hyper reference `Frame' on page 445 undefined on input line 2707 0. Overfull \hbox (18.27203pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpFrame, any component Frames tha t are instances of the LaTeX Warning: Hyper reference `FrameSet' on page 445 undefined on input line 2 7070. Overfull \hbox (44.51563pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a FrameSet, the returned Mapping wil l be a copy of the supplied Overfull \hbox (2.52588pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 FrameSet in which Regions have been removed from all the inter- Frame Mappings, and Overfull \hbox (30.34409pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 any Frames which are instances of the Region class are repalced by the equivalent Frame. Overfull \hbox (25.09537pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a Region, the returned Mapping will be the equivalent Frame. LaTeX Warning: Hyper reference `astClone' on page 445 undefined on input line 2 7070. Overfull \hbox (1.94693pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 This function can safely be applied even to Mappings which contain no Regions. Overfull \hbox (10.60732pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If no Regions are found, it behaves exactly like astClone and r eturns a pointer LaTeX Warning: Hyper reference `astCopy' on page 445 undefined on input line 27 070. Overfull \hbox (26.6159pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 The Mapping returned by this function may not be independen t of the original (even Overfull \hbox (16.11847pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 if some Regions were removed), and modifying it may therefore r esult in indirect Overfull \hbox (2.99667pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 445 undefined on input line 270 70. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [445] LaTeX Warning: Hyper reference `Table' on page 446 undefined on input line 2709 8. [446] LaTeX Warning: Hyper reference `FitsChan' on page 447 undefined on input line 2 7126. Overfull \hbox (21.10475pt too wide) in paragraph at lines 27126--27126 \T1/cmtt/m/n/10 The key indicating which tables to exist. A single key or a com ma-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 27126--27126 \T1/cmtt/m/n/10 of keys can be supplied. If a blank string is supplied, all tab les are removed. Underfull \hbox (badness 10000) in paragraph at lines 27126--27126 [447] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. LaTeX Warning: Hyper reference `Mapping' on page 448 undefined on input line 27 957. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 448 undefined on input line 27957. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 448 undefined on in put line 27957. Overfull \hbox (3.69067pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 int astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, int ndim_in, const int lbnd_in[], const int Overfull \hbox (25.63916pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OM L/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n /10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int interp, void ($\OM S/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 finterp)( Overfull \hbox (0.5927pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 void ), const double params[], int flags, double tol, int maxpi x, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n /10 badval, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [448] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to a Mapping, whose inverse transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinates of pixels in the output grid into the coordinate sy stem of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 grid. This yields the positions which are used to obtain resamp led values by LaTeX Warning: Hyper reference `Nin' on page 449 undefined on input line 27957. LaTeX Warning: Hyper reference `Nout' on page 449 undefined on input line 27957 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its Nin attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates (Nout attrib ute) should match Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input data to be resampled. The numerical type of this arra y should match Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the 1- or 2-character type code appended to the function name ( e.g. if you are Overfull \hbox (15.85603pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array. If this array is supplied (together with the correspondi ng " out_var" Overfull \hbox (49.1854pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array), then estimates of the variance of the resampled output data will be calculated. Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no input variance estimates are being provided, a NULL poi nter should be given. Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for sub-pixel in terpolation within Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input grid. It may be used to select from a set of pre-defi ned schemes by Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 supplying one of the values described in the " Sub-Pixel Interp olation Schemes" Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 section below. If a value of zero is supplied, then the default linear interpolation Overfull \hbox (15.5936pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Alternatively, you may supply a value which indicates that yo u will provide your Overfull \hbox (43.93668pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 own function to perform sub-pixel interpolation by means of the " finterp " parameter. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If the value given for the " interp" parameter indicates that y ou will provide Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 your own function for sub-pixel interpolation, then a pointer t o that function Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 should be given here. For details of the interface which the fu nction should Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [449] Overfull \hbox (52.8595pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If the " interp" parameter has any other value, corresponding to one of the pre-defined Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation schemes, then this function will not be used and you may supply Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 parameter values required by the sub-pixel interpolation scheme . If such parameters Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 are required, this will be noted in the " Sub-Pixel Interpolati on Schemes" section Overfull \hbox (43.93668pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 below (you may also use this array to pass values to your own i nterpolation function). Overfull \hbox (31.60219pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 control over the resampling operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the inp ut grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the output grid being used). In this case, a first attempt t o approximate Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the Mapping by a linear transformation will be made over the en tire output region. Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If a smaller value is used, the output region will first be d ivided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Unless the AST__NOBAD flag is set via the " flags" parameter, this value is also Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 used to flag any output elements in the " out" (and " out_var" ) array(s) for Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which resampled values could not be obtained (see the " Propaga tion of Missing Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Data" section below for details of the circumstances under whic h this may occur). Overfull \hbox (16.80965pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 function return value indicates whether any such va lues have Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 been produced. If the AST__NOBAD flag is set. then output array elements for Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [450] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the first pixel in the region of the output grid for which a resampled value Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the last pixel in the region of the output grid for which a resampled value Overfull \hbox (84.08937pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 region of the output grid for which resampled values should be produced. This Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 region should lie wholly within the extent of the output grid ( as defined by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " lbnd_out" and " ubnd_out" arrays). Regions of the output grid lying outside Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid, into Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which the resampled data values will be returned. The numerical type of this Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array should match that of the " in" array, and the data storag e order should Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 be such that the index of the first grid dimension varies most rapidly and that Overfull \hbox (12.18193pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to an array with the same type and size as the " out" array. Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If given, this array will be used to return variance estimates for the resampled Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 data values. This array will only be used if the " in_var" arra y has also been Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The output variance values will be calculated on the assumpti on that errors on Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input data values are statistically independent and that th eir variance estimates Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may simply be summed (with appropriate weighting factors) when several input pixels Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 contribute to an output data value. If this assumption is not v alid, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output error estimates may be biased. In addition, note that th e statistical Overfull \hbox (36.0636pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 errors on neighbouring output data values (as well as the estim ates of those errors) Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may often be correlated, even if the above assumption about the input data is Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no output variance estimates are required, a NULL pointer should be given. Overfull \hbox (31.1314pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The number of output pixels for which no valid resampled value could be obtained. Thus, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the absence of any error, a returned value of zero indicates that all the required Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [451] Overfull \hbox (26.35347pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (18.96321pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 To select the appropriate resampling function, you should rep lace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/1 0 in the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function name astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 For example, astResampleD would be used to process " double" da ta, while astResampleS Overfull \hbox (10.13652pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 There is no such thing as a perfect sub-pixel interpolation s cheme and, in practice, Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 all resampling will result in some degradation of gridded data. A range of schemes Overfull \hbox (14.59793pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is therefore provided, from which you can choose the one which best suits your needs. Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 In general, a balance must be struck between schemes which te nd to degrade sharp features Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the data by smoothing them, and those which attempt to prese rve sharp features. The Overfull \hbox (44.51563pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 latter will often tend to introduce unwanted oscillations, typi cally visible as " ringing" Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 around sharp features and edges, especially if the data are und er-sampled (i.e. if Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the sharpest features are less than about two pixels across). I n practice, a good Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation scheme is likely to be a compromise and may exhib it some aspects of both Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 For under-sampled data, some interpolation schemes may appear to preserve data resolution Overfull \hbox (49.76434pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 because they transform single input pixels into single output p ixels, rather than spreading Overfull \hbox (5.15024pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 their data between several output pixels. While this may look b etter cosmetically, Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 it can result in a geometrical shift of sharp features in the d ata. You should beware Overfull \hbox (17.74716pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The following are two easy-to-use sub-pixel interpolation sch emes which are generally Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 applicable. They are selected by supplying the appropriate valu e (defined in the " Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 ast.h" header file) via the " interp" parameter. In these cases , the " finterp" and Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__NEAREST: This is the simplest possible scheme, in whic h the value of the Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 input pixel with the nearest centre to the interpolation point is used. This Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is very quick to execute and will preserve single-pixel feature s in the data, but Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may displace them by up to half their width along each dimensio n. It often gives Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [452] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__LINEAR: This is the default scheme, which uses linear interpolation between Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the nearest neighbouring pixels in the input grid (there are tw o neighbours in Overfull \hbox (28.19052pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 one dimension, four neighbours in two dimensions, eight in thre e dimensions, etc.). Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 It is superior to the nearest-pixel scheme (above) in not displ acing features Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the data, yet it still executes fairly rapidly. It is genera lly a safe choice Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 if you do not have any particular reason to favour another sche me, since it cannot Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 introduce oscillations. However, it does introduce some spatial smoothing which Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 varies according to the distance of the interpolation point fro m the neighbouring Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixels. This can degrade the shape of sharp features in the dat a in a position-dependent Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 way. It may also show in the output variance grid (if used) as a pattern of stripes Overfull \hbox (23.25832pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An alternative set of interpolation schemes is based on forming the interpolated value Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 from the weighted sum of a set of surrounding pixel values (not necessarily just the Overfull \hbox (26.14511pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 nearest neighbours). This approach has its origins in the theor y of digital filtering, Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in which interpolated values are obtained by conceptually passi ng the sampled data Overfull \hbox (7.24973pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (represented by a grid of delta functions) through a linear fil ter which implements Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a convolution. Because the convolution kernel is continuous, th e convolution yields Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a continuous function which may then be evaluated at fractional pixel positions. The Overfull \hbox (2.001pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (possibly multi-dimensional) kernel is usually regarded as " se parable" and formed Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 from the product of a set of identical 1-dimensional kernel fun ctions, evaluated along Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 each dimension. Different interpolation schemes are then distin guished by the choice Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of this 1-dimensional interpolation kernel. The number of surro unding pixels which Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 From a practical standpoint, it is useful to divide the weigh ted sum of pixel values Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 by the sum of the weights when determining the interpolated val ue. Strictly, this Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means that a true convolution is no longer being performed. How ever, the distinction Overfull \hbox (34.01819pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is rarely important in practice because (for slightly subtle re asons) the sum of weights Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is always approximately constant for good interpolation kernels . The advantage of Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 this technique, which is used here, is that it can easily accom modate missing data Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 In the following schemes, which are based on a 1-dimensional interpolation kernel, the Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 first element of the " params" array should be used to specify how many pixels are Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to contribute to the interpolated result on either side of the interpolation point Overfull \hbox (33.75575pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in each dimension (the nearest integer value is used). Executio n time increases rapidly Overfull \hbox (12.76088pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with this number. Typically, a value of 2 is appropriate and th e minimum value used Overfull \hbox (24.83293pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will be 1 (i.e. two pixels altogether, one on either side of th e interpolation point). Overfull \hbox (33.49332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 A value of zero or less may be given for " params[0]" to indica te that a suitable number Overfull \hbox (16.54083pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__GAUSS: This scheme uses a kernel of the form exp(-k$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), w ith k a positive Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 constant. The full-width at half-maximum (FWHM) is given by " p arams[1]" to zero Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will select the number of contributing pixels so as to utilise the width of the Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 kernel out to where the envelope declines to 1% of its maximum value). This kernel Overfull \hbox (21.57837pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINC: This scheme uses a sinc(pi$\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 x) kernel, where x is the pixel offset from Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the interpolation point and sinc(z)=sin(z)/z. This sometimes fe atures as an " Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 optimal" interpolation kernel in books on image processing. Its supposed optimality Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 depends on the assumption that the data are band-limited (i.e. have no spatial Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 frequencies above a certain value) and are adequately sampled. In practice, astronomical Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 data rarely meet these requirements. In addition, high spatial frequencies are Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 often present due (e.g.) to image defects and cosmic ray events . Consequently, Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 substantial ringing can be experienced with this kernel. The ke rnel also decays Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 slowly with distance, so that many surrounding pixels are requi red, leading to Overfull \hbox (29.24026pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 poor performance. Abruptly truncating it, by using only a few n eighbouring pixels, Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 improves performance and may reduce ringing (if " params[0]" is set to zero, then Overfull \hbox (23.99155pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 only two pixels will be used on either side). However, a more g radual truncation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [453] Overfull \hbox (56.1174pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCSINC: This scheme uses an improved kernel, of the form sinc(pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).sinc(k$\OMS/zplm/m/n/10 ^^ C$\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), Overfull \hbox (0.53224pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with k a constant, out to the point where sinc(k$\OMS/zplm/m/n/ 10 ^^C$\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and zero Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 beyond. The second sinc() factor provides an " envelope" which gradually rolls Overfull \hbox (5.83221pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 off the normal sinc(pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) kernel at large offsets. The width of this envelope Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is specified by giving the number of pixels offset at which it goes to zero by Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means of the " params[1]" value, which should be at least 1.0 ( in addition, setting Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to zero will select the number of contributing pix els so as to utilise Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the full width of the kernel, out to where it reaches zero). Th e case given by Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]=2, params[1]=2" is typically a good choice and is s ometimes known Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as the Lanczos kernel. This is a valuable general-purpose inter polation scheme, Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 intermediate in its visual effect on images between the AST__NE AREST and AST__LINEAR Overfull \hbox (52.8595pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 schemes. Although the kernel is slightly oscillatory, ringing i s adequately suppressed Overfull \hbox (16.75201pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCCOS: This scheme uses a kernel of the form sinc(pi $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).cos(k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (7.61801pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a constant, out to the point where cos(k$\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and z ero beyond. Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 As above, the cos() factor provides an envelope which gradually rolls off the Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 sinc() kernel at large offsets. The width of this envelope is s pecified by giving Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the number of pixels offset at which it goes to zero by means o f the " params[1]" Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 value, which should be at least 1.0 (in addition, setting " par ams[0]" to zero Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will select the number of contributing pixels so as to utilise the full width Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the kernel, out to where it reaches zero). This scheme gives similar results Overfull \hbox (27.24945pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCGAUSS: This scheme uses a kernel of the form sinc( pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).exp(-k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a positive constant. Here, the sinc() kernel is rolled off us ing a Gaussian Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 envelope which is specified by giving its full-width at half-ma ximum (FWHM) by Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means of the " params[1]" value, which should be at least 0.1 ( in addition, setting Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to zero will select the number of contributing pix els so as to utilise Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the width of the kernel out to where the envelope declines to 1 % of its maximum Overfull \hbox (10.34488pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 value). On astronomical images and spectra, good results are of ten obtained by Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 approximately matching the FWHM of the envelope function, given by " params[1]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 , to the point spread function of the input data. However, ther e does not seem Overfull \hbox (11.08093pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SOMB: This scheme uses a somb(pi$\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 x) kernel (a " sombrero" function), where Overfull \hbox (10.8185pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 x is the pixel offset from the interpolation point and somb(z)= 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 J1(z)/z (J1 is Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a Bessel function of the first kind of order 1). It is similar to the AST__SINC Overfull \hbox (16.75201pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SOMBCOS: This scheme uses a kernel of the form somb(pi $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).cos(k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (7.61801pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a constant, out to the point where cos(k$\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and z ero beyond. Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [454] Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__BLOCKAVE: This scheme simply takes an average of all t he pixels on the input Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 grid in a cube centred on the interpolation point. The number o f pixels in the Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 cube is determined by the value of the first element of the " p arams" array, which Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 gives the number of pixels in each dimension on either side of the central point. Overfull \hbox (26.82709pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Hence a block of (2 $\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 para ms[0])$[]$ndim_in pixels in the input grid will be examined Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to determine the value of the output pixel. If the variance is not being used Overfull \hbox (5.09616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (var_in or var_out = NULL) then all valid pixels in this cube w ill be averaged Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in to the result with equal weight. If variances are being used , then each input Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel will be weighted proportionally to the reciprocal of its variance; any pixel Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 without a valid variance will be discarded. This scheme is suit able where the Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output grid is much coarser than the input grid; if the ratio o f pixel sizes is Overfull \hbox (2.26344pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Finally, supplying the following values for " interp" allows yo u to implement your Overfull \hbox (12.76088pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 own sub-pixel interpolation scheme by means of your own functio n. You should supply LaTeX Warning: Hyper reference `astUkern1' on page 455 undefined on input line 27957. Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__UKERN1: In this scheme, you supply a function to evalu ate your own 1-dimensional Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation kernel, which is then used to perform sub-pixel i nterpolation (as Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 described above). The function you supply should have the same interface as the Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 fictitious astUkern1 function (q.v.). In addition, a value shou ld be given via Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to specify the number of neighbouring pixels which are to contribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to each interpolated value (in the same way as for the pre-defi ned interpolation Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 schemes described above). Other elements of the " params" array are available LaTeX Warning: Hyper reference `astUinterp' on page 455 undefined on input line 27957. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__UINTERP: This is a completely general scheme, in which your interpolation Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function has access to all of the input data. This allows you t o implement any Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation algorithm you choose, which could (for example) b e non-linear, or Overfull \hbox (38.06696pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 adaptive. In this case, the astResample$\OML/zplm/m/it/10 <$\T1 /cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 functions play no role in t he sub-pixel Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation process and simply handle the geometrical transfo rmation of coordinates Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and other housekeeping. The function you supply should have the same interface Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as the fictitious astUinterp function (q.v.). In this case, the " params" parameter Overfull \hbox (43.31567pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is not used by astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 , but is available to pass values to your interpolation Overfull \hbox (23.25832pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 additional control over the resampling process. Having selected a set of flags, you Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__NOBAD: Indicates that any output array elements for wh ich no resampled value Overfull \hbox (38.68796pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 could be obtained should be left set to the value they had on e ntry to this function. Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If this flag is not supplied, such output array elements are se t to the value Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 supplied for parameter " badval" . Note, this flag cannot be us ed in conjunction Overfull \hbox (54.17168pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with the AST__CONSERVEFLUX flag (an error will be reported if b oth flags are specified). Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__URESAMP1, 2, 3 & 4: A set of four flags which are rese rved for your own Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 use. They may be used to pass private information to any sub-pi xel interpolation Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function which you implement yourself. They are ignored by all the pre-defined Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [455] Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__CONSERVEFLUX: Indicates that the output pixel values s hould be scaled in Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 such a way as to preserve (approximately) the total data value in a feature on Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the sky. Without this flag, each output pixel value represents an instantaneous Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 sample of the input data values at the corresponding input posi tion. This is Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 appropriate if the input data represents the spatial density of some quantity Overfull \hbox (5.09616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (e.g. surface brightness in Janskys per square arc-second) beca use the output Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel values will have the same normalisation and units as the input pixel values. Overfull \hbox (25.56616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 However, if the input data values represent flux (or some other physical quantity) Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 per pixel, then the AST__CONSERVEFLUX flag could be used. This causes each output Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel value to be scaled by the ratio of the output pixel size to the input pixel Overfull \hbox (18.0096pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This flag can only be used if the Mapping is successfully appro ximated by one or more Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 linear transformations. Thus an error will be reported if it us ed when the " tol" Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 parameter is set to zero (which stops the use of linear approxi mations), or if the Overfull \hbox (4.1005pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Mapping is too non-linear to be approximated by a piece-wise li near transformation. Overfull \hbox (44.25319pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The ratio of output to input pixel size is evaluated once for e ach panel of the piece-wise Overfull \hbox (34.01819pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 linear approximation to the Mapping, and is assumed to be const ant for all output pixels Overfull \hbox (26.14511pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the panel. The scaling factors for adjacent panels will in g eneral differ slightly, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and so the joints between panels may be visible when viewing th e output image at high Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 contrast. If this is a problem, reduce the value of the " tol" parameter until the Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note, this flag cannot be used in conjunction with the AST__N OBAD flag (an error will Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Unless the AST__NOBAD flag is specified, instances of missing data (bad pixels) in Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the output grid are identified by occurrences of the " badval" value in the " out" Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The input position (the transformed position of the output pixel' s centre) lies Overfull \hbox (29.24026pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The input position lies inside the boundary of a bad input pixel. In this context, Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 an input pixel is considered bad if its data value is equal to " badval" and the Overfull \hbox (57.84578pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 AST__USEBAD flag is set via the " flags" parameter. (Positions which have half-integral Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinate values, and therefore lie on a pixel boundary, are r egarded as lying Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels (excluding those which are bad) is unsuitable Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 for calculating an interpolated value. Whether this is true may depend on the Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The interpolated value lies outside the range which can be represented using the Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 In addition, associated output variance estimates (if calculate d) may be declared bad Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array un der any of the following Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels which contributed to t he output data value Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 do not all have valid variance estimates associated with them. In this context, Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [456] Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels for which valid varian ce values are available Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is unsuitable for calculating an overall variance value. Whethe r this is true Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The variance value lies outside the range which can be repr esented using the data Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If the AST__NOBAD flag is specified via parameter " flags" , th en output array elements Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 that would otherwise be set to " badval" are instead left holdi ng the value they had Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 on entry to this function. The number of such array elements is returned as the function [457] Overfull \hbox (12.97206pt too wide) in paragraph at lines 28039--28039 []\T1/cmtt/m/n/10 void astResolve( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const double point1[], const double point2[], const LaTeX Warning: Hyper reference `Frame' on page 458 undefined on input line 2803 9. LaTeX Warning: Hyper reference `Naxes' on page 458 undefined on input line 2803 9. Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (17.69308pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28039--28039 [] \T1/cmtt/m/n/10 The address of a location at which to return the distance from point 1 to point Overfull \hbox (15.85603pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.86975pt too wide) in paragraph at lines 28039--28039 [] \T1/cmtt/m/n/10 The address of a location at which to return the distance from point 4 to point Overfull \hbox (16.11847pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 3 (that is, the length of the component perpendicular to the ba sis vector). The LaTeX Warning: Hyper reference `astDistance' on page 458 undefined on input lin e 28039. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28039--28039 [][]\T1/cmtt/m/n/10 Each vector used in this function is the path of shortest d istance between two Overfull \hbox (21.36719pt too wide) in paragraph at lines 28039--28039 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [458] LaTeX Warning: Hyper reference `FitsChan' on page 459 undefined on input line 2 8080. LaTeX Warning: Hyper reference `Object' on page 459 undefined on input line 280 80. LaTeX Warning: Hyper reference `astRead' on page 459 undefined on input line 28 080. LaTeX Warning: Hyper reference `Card' on page 459 undefined on input line 28080 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 28080--28080 [][]\T1/cmtt/m/n/10 This function returns without action if the FitsChan is ini tially positioned at Overfull \hbox (5.62103pt too wide) in paragraph at lines 28080--28080 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the Card attribute exceeds the numb er of cards in [459] LaTeX Warning: Hyper reference `Object' on page 460 undefined on input line 281 31. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28131--28131 [][]\T1/cmtt/m/n/10 Two independent Objects that happen to be identical are not considered to be the Overfull \hbox (10.60732pt too wide) in paragraph at lines 28131--28131 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [460] LaTeX Warning: Hyper reference `SelectorMap' on page 461 undefined on input lin e 28232. LaTeX Warning: Hyper reference `Mapping' on page 461 undefined on input line 28 232. LaTeX Warning: Hyper reference `Region' on page 461 undefined on input line 282 32. LaTeX Warning: Hyper reference `Frame' on page 461 undefined on input line 2823 2. LaTeX Warning: Hyper reference `Nin' on page 461 undefined on input line 28232. LaTeX Warning: Hyper reference `UnitMap' on page 461 undefined on input line 28 232. LaTeX Warning: Hyper reference `astSimplify' on page 461 undefined on input lin e 28232. Overfull \hbox (23.41824pt too wide) in paragraph at lines 28232--28232 []\T1/cmtt/m/n/10 AstSelectorMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSelec torMap( int nreg, AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 regs[], doubl e badval, const char Overfull \hbox (0.10988pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 An array of pointers to the Regions. All the supplied Regions m ust relate to Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 the same coordinate Frame. The number of axes in this coordinat e Frame defines Overfull \hbox (20.84232pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 The value to be returned by the forward transformation of the S electorMap for any LaTeX Warning: Hyper reference `astSet' on page 461 undefined on input line 282 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Se lectorMap. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 syntax used is identical to that for the astSet function and ma y include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [461] Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no LaTeX Warning: Hyper reference `Object' on page 462 undefined on input line 282 32. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [462] LaTeX Warning: Hyper reference `Object' on page 463 undefined on input line 283 38. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " LaTeX Warning: Hyper reference `Report' on page 463 undefined on input line 283 38. LaTeX Warning: Hyper reference `Zoom' on page 463 undefined on input line 28338 . Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the Report attribute for Object " map" to the value 1 a nd the Zoom LaTeX Warning: Hyper reference `Label(axis)' on page 463 undefined on input lin e 28338. Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the Label(axis) attribute for Object " frame" to a suit able string, where LaTeX Warning: Hyper reference `Title' on page 463 undefined on input line 2833 8. Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the Title attribute for Object " frame" to the contents of the string " Overfull \hbox (26.6159pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 White space may also surround attribute values, where it wi ll generally be ignored Overfull \hbox (5.09616pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [463] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 To include a literal comma in the value assigned to an attr ibute, the whole attribute Overfull \hbox (10.60732pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 value should be enclosed in quotation markes. Alternatively, yo u can use " %s" Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 format and supply the value as a separate additional argument t o astSet (or use Overfull \hbox (5.62103pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 The same procedure may be adopted if " %" signs are to be i ncluded and are not Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 to be interpreted as format specifiers (alternatively, the " pr intf" convention Overfull \hbox (33.43924pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [464] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. LaTeX Warning: Hyper reference `Object' on page 465 undefined on input line 284 10. Overfull \hbox (26.6159pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the na me of the attribute Overfull \hbox (1.06349pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 The value to be set for the attribute, in the data type corresp onding to $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (52.33463pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 (or, in the case of astSetC, a pointer to a null-terminated cha racter string containing Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 [] \T1/cmtt/m/n/10 Sets the Format(1) attribute value for Object " plot" to the character string Overfull \hbox (33.43924pt too wide) in paragraph at lines 28410--28410 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [465] LaTeX Warning: Hyper reference `Frame' on page 466 undefined on input line 2853 6. LaTeX Warning: Hyper reference `astFindFrame' on page 466 undefined on input li ne 28536. LaTeX Warning: Hyper reference `astConvert' on page 466 undefined on input line 28536. LaTeX Warning: Hyper reference `Mapping' on page 466 undefined on input line 28 536. LaTeX Warning: Hyper reference `FrameSet' on page 466 undefined on input line 2 8536. LaTeX Warning: Hyper reference `ZoomMap' on page 466 undefined on input line 28 536. LaTeX Warning: Hyper reference `Axis' on page 466 undefined on input line 28536 . LaTeX Warning: Hyper reference `SkyFrame' on page 466 undefined on input line 2 8536. Overfull \hbox (23.25832pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [466] LaTeX Warning: Hyper reference `SpecFrame' on page 467 undefined on input line 28536. Overfull \hbox (28.50703pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a SpecFrame is always 1 (any value supp lied using this function LaTeX Warning: Hyper reference `FluxFrame' on page 467 undefined on input line 28536. Overfull \hbox (28.50703pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a FluxFrame is always 1 (any value supp lied using this function LaTeX Warning: Hyper reference `CmpFrame' on page 467 undefined on input line 2 8536. Overfull \hbox (7.51216pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The default ActiveUnit flag for a CmpFrame is 1 if both of the component Frames are Overfull \hbox (7.7746pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 using active units, and zero otherwise. When a new value is set for the ActiveUnit Overfull \hbox (44.51563pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 flag, the flag value is propagated to the component Frames. Thi s change will be reflected Overfull \hbox (2.52588pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 through all references to the component Frames, not just those encapsulated within LaTeX Warning: Hyper reference `Region' on page 467 undefined on input line 285 36. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 467 undefined on input l ine 28536. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 467 undefined on input l ine 28536. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28536--28536 [][]\T1/cmtt/m/n/10 The ActiveUnit flag resembles a Frame attribute, except tha t it cannot be tested Overfull \hbox (23.27441pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 or cleared, and it cannot be accessed using the generic astGet$ \OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 and astSet$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ LaTeX Warning: Hyper reference `astGetActiveUnit' on page 467 undefined on inpu t line 28536. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28536--28536 [][]\T1/cmtt/m/n/10 The astGetActiveUnit function can be used to retrieve the c urrent value of the [467] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. LaTeX Warning: Hyper reference `FitsChan' on page 468 undefined on input line 2 8686. Overfull \hbox (14.82803pt too wide) in paragraph at lines 28686--28686 []\T1/cmtt/m/n/10 void astSetFits$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, $\OML/zplm/m/it/ 10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value, const ch ar Overfull \hbox (7.19565pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (31.33975pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 The keyword value to store with the named keyword. The data typ e of this parameter Overfull \hbox (5.3586pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 A pointer to a null terminated string holding a comment to asso ciated with the Overfull \hbox (37.11334pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 keyword. If a NULL pointer or a blank string is supplied, then any comment included Overfull \hbox (0.37231pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 in the string supplied for the " name" parameter is used instea d. If " name" Overfull \hbox (0.37231pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [468] LaTeX Warning: Hyper reference `Card' on page 469 undefined on input line 28686 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 If non-zero, the new card formed from the supplied keyword name , value and comment Overfull \hbox (21.10475pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 string over-writes the current card, and the current card is in cremented to refer Overfull \hbox (16.11847pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 to the next card (see the " Card" attribute). If zero, the new card is inserted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 in front of the current card and the current card is left uncha nged. In either Overfull \hbox (5.62103pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 case, if the current card on entry points to the " end-of-file" , the new card LaTeX Warning: Hyper reference `astSetFitsU' on page 469 undefined on input lin e 28686. Overfull \hbox (21.36719pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 The function astSetFitsU can be used to indicate that no va lue is associated with LaTeX Warning: Hyper reference `astSetFitsCM' on page 469 undefined on input li ne 28686. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 The function astSetFitsCM can be used to store a pure comme nt card (i.e. a card LaTeX Warning: Hyper reference `astFindFits' on page 469 undefined on input lin e 28686. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 To assign a new value for an existing keyword within a Fits Chan, first find the Overfull \hbox (43.31567pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 card describing the keyword using astFindFits, and then use one of the astSetFits$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (21.36719pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then Overfull \hbox (33.43924pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [469] LaTeX Warning: Hyper reference `FitsChan' on page 470 undefined on input line 2 8740. Overfull \hbox (10.60732pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 A pointer to a null terminated string holding the text of the c omment card. If Overfull \hbox (33.43924pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 a NULL pointer or a blank string is supplied, then a totally bl ank card is produced. LaTeX Warning: Hyper reference `Card' on page 470 undefined on input line 28740 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 If non-zero, the new card over-writes the current card, and the current card is Overfull \hbox (16.11847pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 incremented to refer to the next card (see the " Card" attribut e). If zero, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 new card is inserted in front of the current card and the curre nt card is left Overfull \hbox (42.36206pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 unchanged. In either case, if the current card on entry points to the " end-of-file" Overfull \hbox (21.36719pt too wide) in paragraph at lines 28740--28740 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [470] LaTeX Warning: Hyper reference `FitsChan' on page 471 undefined on input line 2 8812. Overfull \hbox (39.63802pt too wide) in paragraph at lines 28812--28812 []\T1/cmtt/m/n/10 void astSetFitsU( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 comment, int overwrite Overfull \hbox (7.19565pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (5.3586pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 A pointer to a null terminated string holding a comment to asso ciated with the Overfull \hbox (37.11334pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 keyword. If a NULL pointer or a blank string is supplied, then any comment included Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 in the string supplied for the " name" parameter is used instea d. If " name" Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written LaTeX Warning: Hyper reference `Card' on page 471 undefined on input line 28812 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 If non-zero, the new card formed from the supplied keyword name and comment string Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 over-writes the current card, and the current card is increment ed to refer to Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 the next card (see the " Card" attribute). If zero, the new car d is inserted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 in front of the current card and the current card is left uncha nged. In either Overfull \hbox (5.62103pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 case, if the current card on entry points to the " end-of-file" , the new card Overfull \hbox (21.36719pt too wide) in paragraph at lines 28812--28812 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then Overfull \hbox (33.43924pt too wide) in paragraph at lines 28812--28812 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [471] LaTeX Warning: Hyper reference `ast_link' on page 472 undefined on input line 2 8864. Overfull \hbox (5.3586pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 A Pointer to the function to be used to handle errors. The inte rface for this Overfull \hbox (10.60732pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 function is described below. Once a function has been provided, a NULL pointer Overfull \hbox (0.37231pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 can be supplied in a subsequent call to astSetPutErr to reset t he function to Overfull \hbox (37.95473pt too wide) in paragraph at lines 28864--28864 []\T1/cmtt/m/n/10 The supplied external function should deliver the supplied er ror message and (optionally) Overfull \hbox (23.52075pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 the supplied status value to the user or to some underlying err or system. It requires Overfull \hbox (37.11334pt too wide) in paragraph at lines 28864--28864 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [472] LaTeX Warning: Hyper reference `RefRA' on page 473 undefined on input line 2890 8. LaTeX Warning: Hyper reference `RefDec' on page 473 undefined on input line 289 08. LaTeX Warning: Hyper reference `SkyFrame' on page 473 undefined on input line 2 8908. LaTeX Warning: Hyper reference `SpecFrame' on page 473 undefined on input line 28908. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 Pointer to the SkyFrame which defines the celestial coordinate system in which Overfull \hbox (5.62103pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 the longitude and latitude values are supplied. If NULL is supp lied, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 supplied longitude and latitude values are assumed to be FK5 J2 000 RA and Dec Overfull \hbox (21.10475pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 28908--28908 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [473] LaTeX Warning: Hyper reference `astChannel' on page 474 undefined on input line 28946. LaTeX Warning: Hyper reference `astFitsChan' on page 474 undefined on input lin e 28946. LaTeX Warning: Hyper reference `astClearStatus' on page 474 undefined on input line 28946. Overfull \hbox (0.37231pt too wide) in paragraph at lines 28946--28946 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value, most AST functions will not Overfull \hbox (0.37231pt too wide) in paragraph at lines 28946--28946 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [474] LaTeX Warning: Hyper reference `Region' on page 475 undefined on input line 289 88. LaTeX Warning: Hyper reference `Box' on page 475 undefined on input line 28988. LaTeX Warning: Hyper reference `Circle' on page 475 undefined on input line 289 88. LaTeX Warning: Hyper reference `Ellipse' on page 475 undefined on input line 28 988. LaTeX Warning: Hyper reference `Prism' on page 475 undefined on input line 2898 8. Overfull \hbox (0.37231pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 Pointer to the new uncertainty Region. This must be of a class for which all Overfull \hbox (10.86975pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 instances are centro-symetric (e.g. Box, Circle, Ellipse, etc.) or be a Prism Overfull \hbox (21.36719pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 containing centro-symetric component Regions. A deep copy of th e supplied Region Overfull \hbox (21.10475pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [475] LaTeX Warning: Hyper reference `ShiftMap' on page 476 undefined on input line 2 9065. LaTeX Warning: Hyper reference `Mapping' on page 476 undefined on input line 29 065. Overfull \hbox (9.50914pt too wide) in paragraph at lines 29065--29065 []\T1/cmtt/m/n/10 AstShiftMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astShiftMap ( int ncoord, const double shift[], const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 options, ... Overfull \hbox (26.09103pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number Overfull \hbox (10.34488pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 An array containing the values to be added on to the input coor dinates in order Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 to create the output coordinates. A separate value should be su pplied for each LaTeX Warning: Hyper reference `astSet' on page 476 undefined on input line 290 65. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sh iftMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 476 undefined on input line 290 65. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29065--29065 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 29065--29065 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [476] LaTeX Warning: Hyper reference `Object' on page 477 undefined on input line 290 93. [477] LaTeX Warning: Hyper reference `FitsChan' on page 478 undefined on input line 2 9113. [478] LaTeX Warning: Hyper reference `Region' on page 479 undefined on input line 291 53. LaTeX Warning: Hyper reference `Frame' on page 479 undefined on input line 2915 3. LaTeX Warning: Hyper reference `MeshSize' on page 479 undefined on input line 2 9153. Overfull \hbox (42.09962pt too wide) in paragraph at lines 29153--29153 \T1/cmtt/m/n/10 A boolean value indicating if the displayed axis values should be formatted according Overfull \hbox (10.86975pt too wide) in paragraph at lines 29153--29153 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [479] LaTeX Warning: Hyper reference `Mapping' on page 480 undefined on input line 29 236. LaTeX Warning: Hyper reference `CmpMap' on page 480 undefined on input line 292 36. LaTeX Warning: Hyper reference `FrameSet' on page 480 undefined on input line 2 9236. LaTeX Warning: Hyper reference `Frame' on page 480 undefined on input line 2923 6. Overfull \hbox (44.51563pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 If the supplied Mapping is a FrameSet, the returned Mapping wil l be a copy of the supplied LaTeX Warning: Hyper reference `Ident' on page 480 undefined on input line 2923 6. Overfull \hbox (21.10475pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 Mappings that have a set value for their Ident attribute ar e left unchanged after Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 simplification. This is so that their individual identity is pr eserved. This LaTeX Warning: Hyper reference `astClone' on page 480 undefined on input line 2 9236. Overfull \hbox (12.44437pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 This function can safely be applied even to Mappings which cannot be simplified. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 If no simplification is possible, it behaves exactly like astCl one and returns LaTeX Warning: Hyper reference `astCopy' on page 480 undefined on input line 29 236. Overfull \hbox (26.6159pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 The Mapping returned by this function may not be independen t of the original (even Overfull \hbox (26.6159pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 if simplification was possible), and modifying it may therefore result in indirect Overfull \hbox (2.99667pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 480 undefined on input line 292 36. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [480] LaTeX Warning: Hyper reference `SkyFrame' on page 481 undefined on input line 2 9365. LaTeX Warning: Hyper reference `Frame' on page 481 undefined on input line 2936 5. LaTeX Warning: Hyper reference `System' on page 481 undefined on input line 293 65. LaTeX Warning: Hyper reference `Equinox' on page 481 undefined on input line 29 365. LaTeX Warning: Hyper reference `Epoch' on page 481 undefined on input line 2936 5. LaTeX Warning: Hyper reference `SkyRefIs' on page 481 undefined on input line 2 9365. LaTeX Warning: Hyper reference `astFormat' on page 481 undefined on input line 29365. LaTeX Warning: Hyper reference `astSet' on page 481 undefined on input line 293 65. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sk yFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the FK5 celestial coordinate system, with a Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 mean Equinox of J2005.0. Because especially accurate coordinate s will be used, Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 additional precision (10 digits) has been requested. This will be used when Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the old FK4 celestial coordin ate system. A Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [481] Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 system. The Epoch value, which specifies the date of observatio n, is obtained Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 Currently, the default celestial coordinate system is ICRS. However, this default Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 may change in future as new astrometric standards evolve. The i ntention is to Overfull \hbox (16.11847pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 track the most modern appropriate standard. For this reason, yo u should use the Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 default only if this is what you intend (and can tolerate any a ssociated slight Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 change in behaviour with future versions of this function). If you intend to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 use the ICRS system indefinitely, then you should specify it ex plicitly using LaTeX Warning: Hyper reference `astPermAxes' on page 482 undefined on input lin e 29365. Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 Whichever celestial coordinate system is represented, it wi ll have two axes. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 first of these will be the longitude axis and the second will b e the latitude LaTeX Warning: Hyper reference `astConvert' on page 482 undefined on input line 29365. LaTeX Warning: Hyper reference `AlignSystem' on page 482 undefined on input lin e 29365. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 When conversion between two SkyFrames is requested (as when supplying SkyFrames Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 to astConvert), account will be taken of the nature of the cele stial coordinate Overfull \hbox (23.99155pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 systems they represent, together with any qualifying mean Equin ox or Epoch values, Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 etc. The AlignSystem attribute will also be taken into account. The results Overfull \hbox (31.60219pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 will therefore fully reflect the relationship between positions on the sky measured LaTeX Warning: Hyper reference `Object' on page 482 undefined on input line 293 65. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [482] LaTeX Warning: Hyper reference `Mapping' on page 483 undefined on input line 29 408. LaTeX Warning: Hyper reference `System' on page 483 undefined on input line 294 08. LaTeX Warning: Hyper reference `SkyFrame' on page 483 undefined on input line 2 9408. LaTeX Warning: Hyper reference `SkyRefIs' on page 483 undefined on input line 2 9408. LaTeX Warning: Hyper reference `UnitMap' on page 483 undefined on input line 29 408. LaTeX Warning: Hyper reference `Object' on page 483 undefined on input line 294 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29408--29408 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [483] LaTeX Warning: Hyper reference `SlaMap' on page 484 undefined on input line 296 28. LaTeX Warning: Hyper reference `astSlaMap' on page 484 undefined on input line 29628. LaTeX Warning: Hyper reference `Mapping' on page 484 undefined on input line 29 628. LaTeX Warning: Hyper reference `Invert' on page 484 undefined on input line 296 28. Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the celestial coordinate Overfull \hbox (15.85603pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 conversion to be added to the SlaMap. See the " SLALIB Conversi ons" section for Overfull \hbox (21.10475pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 An array containing argument values for the celestial coordinat e conversion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 number of arguments required, and hence the number of array ele ments used, depends Overfull \hbox (15.85603pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 on the conversion specified (see the " SLALIB Conversions" sect ion). This array Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 All coordinate values processed by an SlaMap are in radians . The first coordinate Overfull \hbox (7.19565pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 is the celestial longitude and the second coordinate is the cel estial latitude. LaTeX Warning: Hyper reference `astSimplify' on page 484 undefined on input lin e 29628. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 the most economical conversion path. For example, converting to the standard Overfull \hbox (10.86975pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 FK5 coordinate system as an intermediate stage is often sensibl e in formulating Overfull \hbox (5.62103pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 the problem, but may introduce unnecessary extra conversion ste ps. A solution Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to this is to include all the steps which are (logically) neces sary, but then Overfull \hbox (16.11847pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to use astSimplify to simplify the resulting SlaMap. The simpli fication process Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [484] Overfull \hbox (49.23947pt too wide) in paragraph at lines 29628--29628 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to indicate which celestial coordinate conversion is to be adde d to the SlaMap. Each Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 string is derived from the name of the SLALIB routine that perf orms the conversion Overfull \hbox (39.2669pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 and the relevant documentation (SUN/67) should be consulted for details. Where arguments Overfull \hbox (39.2669pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 are needed by the conversion, they are listed in parentheses. V alues for these arguments Overfull \hbox (7.7746pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 should be given, via the " args" array, in the order indicated. The argument names Overfull \hbox (28.76947pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 match the corresponding SLALIB routine arguments and their valu es should be given using Overfull \hbox (12.44437pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " PREBN" (BEP0,BEP1): Apply Bessel-Newcomb pre-IAU 1976 (FK 4) precession model. Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 For example, to use the " ADDET" conversion, which takes a sing le argument EQ, you Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 should consult the documentation for the SLALIB routine SLA_ADD ET. This describes the Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 conversion in detail and shows that EQ is the Besselian epoch o f the mean equator and Overfull \hbox (13.02332pt too wide) in paragraph at lines 29628--29628 []\T1/cmtt/m/n/10 In addition the following strings may be supplied for more co mplex conversions which Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 do not correspond to any one single SLALIB routine (DIURAB is t he magnitude of the Overfull \hbox (23.52075pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 diurnal aberration vector in units of " day/(2.PI)" , DATE is t he Modified Julian Date Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 of the observation, and (OBSX,OBSY,OBZ) are the Heliocentric-Ar ies-Ecliptic cartesian Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " HPCEQ" (DATE,OBSX,OBSY,OBSZ): Convert Helioprojective-Car tesian coordinates Overfull \hbox (117.41873pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " EQHPC" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Cartesian. Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " HPREQ" (DATE,OBSX,OBSY,OBSZ): Convert Helioprojective-Rad ial coordinates to Overfull \hbox (101.67258pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [485] Overfull \hbox (28.76947pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 Note, the " H2E" and " E2H" conversions convert between topocen tric horizon coordinates Overfull \hbox (29.81921pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 (azimuth,elevation), and apparent local equatorial coordinates (hour angle,declination). Overfull \hbox (18.0096pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [486] LaTeX Warning: Hyper reference `SlaMap' on page 487 undefined on input line 297 08. LaTeX Warning: Hyper reference `Mapping' on page 487 undefined on input line 29 708. LaTeX Warning: Hyper reference `astSlaAdd' on page 487 undefined on input line 29708. Overfull \hbox (10.60732pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to LaTeX Warning: Hyper reference `astSet' on page 487 undefined on input line 297 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sl aMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 29708--29708 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Nin' on page 487 undefined on input line 29708. LaTeX Warning: Hyper reference `Nout' on page 487 undefined on input line 29708 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 29708--29708 [][]\T1/cmtt/m/n/10 The Nin and Nout attributes (number of input and output coo rdinates) for an SlaMap Overfull \hbox (0.37231pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 are both equal to 2. The first coordinate is the celestial long itude and the Overfull \hbox (28.19052pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 second coordinate is the celestial latitude. All coordinate val ues are in radians. LaTeX Warning: Hyper reference `Object' on page 487 undefined on input line 297 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29708--29708 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [487] LaTeX Warning: Hyper reference `SpecMap' on page 488 undefined on input line 29 989. LaTeX Warning: Hyper reference `astSpecMap' on page 488 undefined on input line 29989. LaTeX Warning: Hyper reference `Mapping' on page 488 undefined on input line 29 989. LaTeX Warning: Hyper reference `Invert' on page 488 undefined on input line 299 89. Overfull \hbox (6.88478pt too wide) in paragraph at lines 29989--29989 []\T1/cmtt/m/n/10 void astSpecAdd( AstSpecMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 cvt, int narg, cons t double args[] ) Overfull \hbox (52.8595pt too wide) in paragraph at lines 29989--29989 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the spectral coordinate conversion Overfull \hbox (21.36719pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to be added to the SpecMap. See the " Available Conversions" se ction for details Overfull \hbox (15.85603pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 An array containing argument values for the spectral coordinate conversion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 number of arguments required, and hence the number of array ele ments used, depends Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 on the conversion specified (see the " Available Conversions" s ection). This Overfull \hbox (7.19565pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 array is ignored and a NULL pointer may be supplied if no argum ents are needed. Underfull \hbox (badness 10000) in paragraph at lines 29989--29989 LaTeX Warning: Hyper reference `astSimplify' on page 488 undefined on input lin e 29989. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 the most economical conversion path. For example, when converti ng between reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 frames, converting first to the heliographic reference frame as an intermediate Overfull \hbox (21.10475pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 stage is often sensible in formulating the problem, but may int roduce unnecessary Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 extra conversion steps. A solution to this is to include all th e steps which Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 are (logically) necessary, but then to use astSimplify to simpl ify the resulting Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 SpecMap. The simplification process will eliminate any steps wh ich turn out not Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions Overfull \hbox (49.23947pt too wide) in paragraph at lines 29989--29989 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (23.52075pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to indicate which spectral coordinate conversion is to be added to the SpecMap. Where Overfull \hbox (7.51216pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 arguments are needed by the conversion, they are listed in pare ntheses. Values for Overfull \hbox (23.52075pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [488] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " USF2HL" (VOFF,RA,DEC): Convert frequency from a user-defi ned reference frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2US" (VOFF,RA,DEC): Convert frequency from heliocentri c reference frame to Overfull \hbox (21.36719pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " TPF2HL" (OBSLON,OBSLAT,OBSALT,EPOCH,RA,DEC): Convert freq uency from topocentric Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2TP" (OBSLON,OBSLAT,OBSALT,EPOCH,RA,DEC): Convert freq uency from heliocentric Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " GEF2HL" (EPOCH,RA,DEC): Convert frequency from geocentric reference frame to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2GE" (EPOCH,RA,DEC): Convert frequency from heliocentr ic reference frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " BYF2HL" (EPOCH,RA,DEC): Convert frequency from barycentri c reference frame to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2BY" (EPOCH,RA,DEC): Convert frequency from heliocentr ic reference frame Overfull \hbox (59.68283pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LKF2HL" (RA,DEC): Convert frequency from kinematic LSR re ference frame to heliocentric. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LK" (RA,DEC): Convert frequency from heliocentric ref erence frame to kinematic Overfull \hbox (59.68283pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LDF2HL" (RA,DEC): Convert frequency from dynamical LSR re ference frame to heliocentric. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LD" (RA,DEC): Convert frequency from heliocentric ref erence frame to dynamical Overfull \hbox (49.1854pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LGF2HL" (RA,DEC): Convert frequency from local group refe rence frame to heliocentric. Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [489] Overfull \hbox (33.43924pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " GLF2HL" (RA,DEC): Convert frequency from galactic referen ce frame to heliocentric. Overfull \hbox (33.43924pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2GL" (RA,DEC): Convert frequency from heliocentric ref erence frame to galactic. Overfull \hbox (43.93668pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 all velocities: metres per second (positive if the source r eceeds from the observer). LaTeX Warning: Hyper reference `Epoch' on page 490 undefined on input line 2998 9. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 VOFF: Velocity of the user-defined reference frame, towards the position given Overfull \hbox (18.27203pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 If the SpecMap is 3-dimensional, source positions are provided by the values supplied Overfull \hbox (15.64767pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to inputs 2 and 3 of the SpecMap (which are simply copied to ou tputs 2 and 3). Note, Overfull \hbox (13.02332pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 usable values are still required for the RA and DEC arguments i n order to define the Overfull \hbox (7.7746pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [490] LaTeX Warning: Hyper reference `SpecFluxFrame' on page 491 undefined on input l ine 30074. LaTeX Warning: Hyper reference `SpecFrame' on page 491 undefined on input line 30074. LaTeX Warning: Hyper reference `FluxFrame' on page 491 undefined on input line 30074. LaTeX Warning: Hyper reference `Frame' on page 491 undefined on input line 3007 4. LaTeX Warning: Hyper reference `Plot' on page 491 undefined on input line 30074 . Overfull \hbox (18.64314pt too wide) in paragraph at lines 30074--30074 []\T1/cmtt/m/n/10 AstSpecFluxFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSpe cFluxFrame( AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame1, AstFluxF rame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame2, const Overfull \hbox (22.9418pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to the SpecFrame. This will form the first axis in the new SpecFluxFrame. LaTeX Warning: Hyper reference `SpecVal' on page 491 undefined on input line 30 074. Overfull \hbox (28.19052pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to the FluxFrame. This will form the second axis in the new SpecFluxFrame. Overfull \hbox (21.10475pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 The " SpecVal" attribute of this FluxFrame is not used by the S pecFluxFrame class LaTeX Warning: Hyper reference `astSet' on page 491 undefined on input line 300 74. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (16.11847pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecFluxFrame. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 syntax used is identical to that for the astSet function and ma y include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (21.36719pt too wide) in paragraph at lines 30074--30074 [][]\T1/cmtt/m/n/10 The supplied Frame pointers are stored directly, rather tha n being used to create Overfull \hbox (16.11847pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 deep copies of the supplied Frames. This means that any subsequ ent changes made Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 to the Frames via the supplied pointers will result in equivale nt changes being LaTeX Warning: Hyper reference `Object' on page 491 undefined on input line 300 74. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30074--30074 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 30074--30074 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [491] LaTeX Warning: Hyper reference `SpecFrame' on page 492 undefined on input line 30174. LaTeX Warning: Hyper reference `Frame' on page 492 undefined on input line 3017 4. LaTeX Warning: Hyper reference `System' on page 492 undefined on input line 301 74. LaTeX Warning: Hyper reference `SpecOrigin' on page 492 undefined on input line 30174. LaTeX Warning: Hyper reference `astSet' on page 492 undefined on input line 301 74. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `RestFreq' on page 492 undefined on input line 3 0174. Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 system. The RestFreq attribute (rest frequency) is unspecified, so it will Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 not be possible to align this SpecFrame with another SpecFrame on the basis of Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 a velocity-based system. The standard of rest is also unspecifi ed. This means Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 that alignment will be possible with other SpecFrames, but no c orrection will be LaTeX Warning: Hyper reference `StdOfRest' on page 492 undefined on input line 30174. LaTeX Warning: Hyper reference `RefRA' on page 492 undefined on input line 3017 4. LaTeX Warning: Hyper reference `RefDec' on page 492 undefined on input line 301 74. Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 rest frequency 1.0E15 Hz (about 3000 Angstroms), measured in th e kinematic Local Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 Standard of Rest (" LSRK" ). Since the source position has not been specified Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 (using attributes RefRA and RefDec), it will only be possible t o align this Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [492] LaTeX Warning: Hyper reference `astConvert' on page 493 undefined on input line 30174. LaTeX Warning: Hyper reference `AlignSystem' on page 493 undefined on input lin e 30174. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 493 undefined on input line 30174. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30174--30174 [][]\T1/cmtt/m/n/10 When conversion between two SpecFrames is requested (as whe n supplying SpecFrames Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 to astConvert), account will be taken of the nature of the spec tral coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 systems they represent, together with any qualifying rest frequ ency, standard Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of rest, epoch values, etc. The AlignSystem and AlignStdOfRest attributes will Overfull \hbox (47.61078pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 also be taken into account. The results will therefore fully re flect the relationship Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 between positions measured in the two systems. In addition, any difference in LaTeX Warning: Hyper reference `Object' on page 493 undefined on input line 301 74. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [493] LaTeX Warning: Hyper reference `SpecMap' on page 494 undefined on input line 30 290. LaTeX Warning: Hyper reference `Mapping' on page 494 undefined on input line 30 290. LaTeX Warning: Hyper reference `astSpecAdd' on page 494 undefined on input line 30290. Overfull \hbox (17.43065pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 The number of inputs to the Mapping (this will also equal the n umber of outputs). Overfull \hbox (0.10988pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 This value must be either 1 or 3. In either case, the first inp ut and output Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 correspoindis the spectral axis. For a 3-axis SpecMap, the seco nd and third axes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 give the RA and DEC (J2000 FK5) of the source. This positional information is Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 used by conversions which transform between standards of rest, and replaces the Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 " RA" and " DEC" arguments for the individual conversions liste d in description Overfull \hbox (10.60732pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to LaTeX Warning: Hyper reference `astSet' on page 494 undefined on input line 302 90. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [494] Overfull \hbox (12.44437pt too wide) in paragraph at lines 30290--30290 [][]\T1/cmtt/m/n/10 The nature and units of the coordinate values supplied for the first input (i.e. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 the spectral input) of a SpecMap must be appropriate to the fir st conversion step Overfull \hbox (16.11847pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 applied by the SpecMap. For instance, if the first conversion s tep is " FRTOVL" Overfull \hbox (5.09616pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 (frequency to relativistic velocity), then the coordinate value s for the first Overfull \hbox (0.37231pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 input should be frequency in units of Hz. Similarly, the nature and units of Overfull \hbox (42.36206pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 the coordinate values returned by a SpecMap will be determined by the last conversion Overfull \hbox (37.11334pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 step applied by the SpecMap. For instance, if the last conversi on step is " VLTOVO" Overfull \hbox (10.34488pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 (relativistic velocity to optical velocity), then the coordinat e values for the Overfull \hbox (0.37231pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 first output will be optical velocity in units of metres per se cond. See the Overfull \hbox (0.10988pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 description of the astSpecAdd function for the units expected a nd returned by LaTeX Warning: Hyper reference `Object' on page 495 undefined on input line 302 90. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [495] LaTeX Warning: Hyper reference `SphMap' on page 496 undefined on input line 303 88. LaTeX Warning: Hyper reference `Mapping' on page 496 undefined on input line 30 388. LaTeX Warning: Hyper reference `astSet' on page 496 undefined on input line 303 88. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp hMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 30388--30388 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (0.37231pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 The spherical coordinates are longitude (positive anti-cloc kwise looking from Overfull \hbox (44.98642pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the positive latitude pole) and latitude. The Cartesian coordin ates are right-handed, Overfull \hbox (0.10988pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 with the x axis (axis 1) at zero longitude and latitude, and th e z axis (axis LaTeX Warning: Hyper reference `PolarLong' on page 496 undefined on input line 30388. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 If the Cartesian coordinates are all zero, then the longitu de and latitude are LaTeX Warning: Hyper reference `Object' on page 496 undefined on input line 303 88. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [496] [497] LaTeX Warning: Hyper reference `astClearStatus' on page 498 undefined on input line 30417. Overfull \hbox (42.36206pt too wide) in paragraph at lines 30417--30417 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (26.35347pt too wide) in paragraph at lines 30417--30417 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [498] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 499 undefined on input line 30507. LaTeX Warning: Hyper reference `Stc' on page 499 undefined on input line 30507. Overfull \hbox (26.30504pt too wide) in paragraph at lines 30507--30507 []\T1/cmtt/m/n/10 AstStcCatalogEntryLocation $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 astStcCatalogEntryLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, int ncoords, LaTeX Warning: Hyper reference `Region' on page 499 undefined on input line 305 07. LaTeX Warning: Hyper reference `KeyMap' on page 499 undefined on input line 305 07. Overfull \hbox (18.74283pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied KeyMap describes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 499 undefined on input line 305 07. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (38.68796pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cCatalogEntryLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 The syntax used is identical to that for the astSet function an d may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30507--30507 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect LaTeX Warning: Hyper reference `Object' on page 499 undefined on input line 305 07. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30507--30507 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [499] [500] LaTeX Warning: Hyper reference `StcObsDataLocation' on page 501 undefined on in put line 30597. LaTeX Warning: Hyper reference `Stc' on page 501 undefined on input line 30597. Overfull \hbox (28.9294pt too wide) in paragraph at lines 30597--30597 []\T1/cmtt/m/n/10 AstStcObsDataLocation $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcObsDataLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, i nt ncoords, AstKeyMap LaTeX Warning: Hyper reference `Region' on page 501 undefined on input line 305 97. LaTeX Warning: Hyper reference `KeyMap' on page 501 undefined on input line 305 97. Overfull \hbox (18.74283pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied KeyMap describes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 501 undefined on input line 305 97. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cObsDataLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 The syntax used is identical to that for the astSet function an d may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30597--30597 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect LaTeX Warning: Hyper reference `Object' on page 501 undefined on input line 305 97. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30597--30597 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [501] [502] LaTeX Warning: Hyper reference `StcResourceProfile' on page 503 undefined on in put line 30695. LaTeX Warning: Hyper reference `Stc' on page 503 undefined on input line 30695. Overfull \hbox (28.9294pt too wide) in paragraph at lines 30695--30695 []\T1/cmtt/m/n/10 AstStcResourceProfile $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcResourceProfile( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, i nt ncoords, AstKeyMap LaTeX Warning: Hyper reference `Region' on page 503 undefined on input line 306 95. LaTeX Warning: Hyper reference `KeyMap' on page 503 undefined on input line 306 95. Overfull \hbox (18.74283pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied KeyMap describes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 503 undefined on input line 306 95. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cResourceProfile. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 The syntax used is identical to that for the astSet function an d may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30695--30695 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect LaTeX Warning: Hyper reference `Object' on page 503 undefined on input line 306 95. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30695--30695 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [503] Overfull \hbox (2.26344pt too wide) in paragraph at lines 30695--30695 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [504] LaTeX Warning: Hyper reference `StcSearchLocation' on page 505 undefined on inp ut line 30793. LaTeX Warning: Hyper reference `Stc' on page 505 undefined on input line 30793. Overfull \hbox (23.68068pt too wide) in paragraph at lines 30793--30793 []\T1/cmtt/m/n/10 AstStcResourceProfile $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcSearchLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, in t ncoords, AstKeyMap LaTeX Warning: Hyper reference `Region' on page 505 undefined on input line 307 93. LaTeX Warning: Hyper reference `KeyMap' on page 505 undefined on input line 307 93. Overfull \hbox (18.74283pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied KeyMap describes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 505 undefined on input line 307 93. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (7.19565pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cSearchLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 The syntax used is identical to that for the astSet function an d may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30793--30793 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect LaTeX Warning: Hyper reference `Object' on page 505 undefined on input line 307 93. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30793--30793 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [505] Overfull \hbox (2.26344pt too wide) in paragraph at lines 30793--30793 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [506] LaTeX Warning: Hyper reference `StcsChan' on page 507 undefined on input line 3 0896. LaTeX Warning: Hyper reference `Channel' on page 507 undefined on input line 30 896. LaTeX Warning: Hyper reference `Object' on page 507 undefined on input line 308 96. LaTeX Warning: Hyper reference `astWrite' on page 507 undefined on input line 3 0896. LaTeX Warning: Hyper reference `XmlChan' on page 507 undefined on input line 30 896. LaTeX Warning: Hyper reference `SinkFile' on page 507 undefined on input line 3 0896. LaTeX Warning: Hyper reference `SourceFile' on page 507 undefined on input line 30896. Overfull \hbox (8.09445pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 AstStcsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astStcsChan ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/ cmtt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink) ( const char Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 this function will be used by the StcsChan to obtain lines of i nput text. On Overfull \hbox (21.36719pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 each invocation, it should return a pointer to the next input l ine read from some Overfull \hbox (16.11847pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 this function will be used by the StcsChan to deliver lines of output text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the LaTeX Warning: Hyper reference `astSet' on page 507 undefined on input line 308 96. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St csChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [507] Overfull \hbox (8.24539pt too wide) in paragraph at lines 30896--30896 [][]\T1/cmtt/m/n/10 If the external data source or sink uses a character encodi ng other than ASCII, Overfull \hbox (47.34834pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [508] LaTeX Warning: Hyper reference `astEscapes' on page 509 undefined on input line 30937. LaTeX Warning: Hyper reference `Plot' on page 509 undefined on input line 30937 . LaTeX Warning: Hyper reference `Escape' on page 509 undefined on input line 309 37. Overfull \hbox (2.52588pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 Pointer to the modified string. If no escape sequences were fou nd in the supplied Overfull \hbox (18.27203pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 string, then a copy of the supplied pointer is returned. Otherw ise, the pointer will Overfull \hbox (7.7746pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 point to a static buffer holding the modified text. This text w ill be over-written Overfull \hbox (28.76947pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 by subsequent invocations of this function. If the astEscapes f unction has been called Overfull \hbox (13.02332pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [509] LaTeX Warning: Hyper reference `SwitchMap' on page 510 undefined on input line 31096. LaTeX Warning: Hyper reference `Mapping' on page 510 undefined on input line 31 096. LaTeX Warning: Hyper reference `Nin' on page 510 undefined on input line 31096. LaTeX Warning: Hyper reference `Nout' on page 510 undefined on input line 31096 . LaTeX Warning: Hyper reference `SelectorMap' on page 510 undefined on input lin e 31096. LaTeX Warning: Hyper reference `UnitMap' on page 510 undefined on input line 31 096. LaTeX Warning: Hyper reference `astSimplify' on page 510 undefined on input lin e 31096. Overfull \hbox (34.3893pt too wide) in paragraph at lines 31096--31096 []\T1/cmtt/m/n/10 AstSwitchMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSwitchM ap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 fsmap, AstMapping $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 ismap, int nroute, AstMapping [510] Overfull \hbox (65.9813pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to the forward selector Mapping. This must have a defin ed forward transformation, Overfull \hbox (21.36719pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 but need not have a defined inverse transformation. It must hav e one output, and Overfull \hbox (26.6159pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 the number of inputs must match the number of inputs of each of the supplied route Overfull \hbox (31.86462pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Mappings. NULL may be supplied, in which case the SwitchMap wil l have an undefined Overfull \hbox (65.9813pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to the inverse selector Mapping. This must have a defin ed inverse transformation, Overfull \hbox (16.11847pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 but need not have a defined forward transformation. It must hav e one input, and Overfull \hbox (5.62103pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 the number of outputs must match the number of outputs of each of the supplied Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 route Mappings. NULL may be supplied, in which case the SwitchM ap will have an Overfull \hbox (21.10475pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 An array of pointers to the route Mappings. All the supplied ro ute Mappings must Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 have common values for the Nin and Nout attributes, and these v alues define the LaTeX Warning: Hyper reference `astSet' on page 511 undefined on input line 310 96. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sw itchMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `astCopy' on page 511 undefined on input line 31 096. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31096--31096 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astSwitchMap (the Overfull \hbox (16.11847pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 new SwitchMap simply retains a reference to them). They may con tinue to be used Overfull \hbox (15.85603pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 for other purposes, but should not be deleted. If a SwitchMap c ontaining a copy Overfull \hbox (0.37231pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of its component Mappings is required, then a copy of the Switc hMap should be LaTeX Warning: Hyper reference `Object' on page 511 undefined on input line 310 96. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31096--31096 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [511] LaTeX Warning: Hyper reference `Table' on page 512 undefined on input line 3118 6. LaTeX Warning: Hyper reference `KeyMap' on page 512 undefined on input line 311 86. LaTeX Warning: Hyper reference `astAddColumn' on page 512 undefined on input li ne 31186. LaTeX Warning: Hyper reference `astAddParameter' on page 512 undefined on input line 31186. LaTeX Warning: Hyper reference `astSet' on page 512 undefined on input line 311 86. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ta ble. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 31186--31186 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 512 undefined on input line 311 86. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31186--31186 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 31186--31186 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [512] LaTeX Warning: Hyper reference `FitsChan' on page 513 undefined on input line 3 1266. LaTeX Warning: Hyper reference `astRead' on page 513 undefined on input line 31 266. LaTeX Warning: Hyper reference `FrameSet' on page 513 undefined on input line 3 1266. LaTeX Warning: Hyper reference `TabOK' on page 513 undefined on input line 3126 6. LaTeX Warning: Hyper reference `astPutTables' on page 513 undefined on input li ne 31266. LaTeX Warning: Hyper reference `astPutTable' on page 513 undefined on input lin e 31266. Overfull \hbox (18.3807pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 void astTableSource( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cm tt/m/n/10 this, void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 tabsource)( AstFit sChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 , const char Overfull \hbox (21.36719pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 Pointer to the table source function to use. It takes five argu ments - the first Overfull \hbox (21.36719pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 is a pointer to the FitsChan, the second is a string holding th e name of the FITS Overfull \hbox (5.62103pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 extension containing the required binary table (" EXTNAME" ), t he third is the Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 integer FITS " EXTVER" header value for the required extension, the fourth is Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 the integer FITS " EXTLEVEL" header value for the required exte nsion, and the LaTeX Warning: Hyper reference `FitsTable' on page 513 undefined on input line 31266. Overfull \hbox (31.60219pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 The call-back should read the entire contents (header and dat a) of the binary table Overfull \hbox (21.10475pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 in the named extension of the external FITS file, storing the c ontents in a newly Overfull \hbox (5.62103pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 created FitsTable object. It should then store this FitsTable i n the FitsChan Overfull \hbox (10.60732pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 using the astPutTables or astPutTable method, and finally annul l its local copy Overfull \hbox (15.85603pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 of the FitsTable pointer. If the table cannot be read for any r eason, or if any Overfull \hbox (31.86462pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 other error occurs, it should return zero for the final (third) argument (otherwise Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 If " tabsource" is NULL, any registered call-back function wi ll be removed. LaTeX Warning: Hyper reference `astPutChannelData' on page 513 undefined on inp ut line 31266. LaTeX Warning: Hyper reference `astChannelData' on page 513 undefined on input line 31266. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31266--31266 [][]\T1/cmtt/m/n/10 Application code can pass arbitrary data (such as file desc riptors, etc) to the Overfull \hbox (16.11847pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 table source function using the astPutChannelData function. The source function [513] LaTeX Warning: Hyper reference `Object' on page 514 undefined on input line 313 24. Overfull \hbox (26.6159pt too wide) in paragraph at lines 31324--31324 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the na me of the attribute Overfull \hbox (18.27203pt too wide) in paragraph at lines 31324--31324 \T1/cmtt/m/n/10 One if a value has previously been explicitly set for the attri bute (and hasn' t been Overfull \hbox (10.60732pt too wide) in paragraph at lines 31324--31324 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (26.35347pt too wide) in paragraph at lines 31324--31324 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [514] LaTeX Warning: Hyper reference `FitsChan' on page 515 undefined on input line 3 1404. Overfull \hbox (7.19565pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (39.7377pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 from it. No more than 80 characters are read from this string. If NULL is supplied, Overfull \hbox (37.11334pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 Pointer to an integer which will be returned holding a non-zero value if the keyword Overfull \hbox (21.10475pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 was found in the header, and zero otherwise. This parameter all ows a distinction Overfull \hbox (5.62103pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 to be made between the case where a keyword is not present, and the case where Overfull \hbox (21.36719pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 a keyword is present but has no associated value. A NULL pointe r may be supplied Overfull \hbox (2.26344pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 A value of zero is returned if the keyword was not found in the FitsChan or has no Overfull \hbox (26.6159pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 The card following the current card is checked first. If th is is not the required Overfull \hbox (0.37231pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 card, then the rest of the FitsChan is searched, starting with the first card Overfull \hbox (16.11847pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 added to the FitsChan. Therefore cards should be accessed in th e order they are Overfull \hbox (31.86462pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 stored in the FitsChan (if possible) as this will minimise the time spent searching Overfull \hbox (33.43924pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [515] LaTeX Warning: Hyper reference `Plot' on page 516 undefined on input line 31493 . Overfull \hbox (10.55888pt too wide) in paragraph at lines 31493--31493 []\T1/cmtt/m/n/10 void astText( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, const double pos[], const float up[], Overfull \hbox (1.94693pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the te xt to be drawn. Overfull \hbox (42.09962pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates LaTeX Warning: Hyper reference `Plot3D' on page 516 undefined on input line 314 93. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31493--31493 [] \T1/cmtt/m/n/10 An array holding the components of a vector in the " up" direction of the text Overfull \hbox (55.48386pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (in graphical coordinates). For example, to get horizontal text , the vector {0.0f,1.0f} Overfull \hbox (23.99155pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 should be supplied. For a basic Plot, 2 values should be suppli ed. For a Plot3D, Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 3 values should be supplied, and the actual up vector used is t he projection of Overfull \hbox (16.11847pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 the supplied up vector onto the text plane specified by the cur rent value of the Overfull \hbox (0.37231pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 Pointer to a null-terminated character string identifying the r eference point Overfull \hbox (47.61078pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 for the text being drawn. The first character in this string id entifies the reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 position in the " up" direction and may be " B" (baseline), " C " (centre), " T" Overfull \hbox (31.33975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (top) or " M" (bottom). The second character identifies the sid e-to-side reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 position and may be " L" (left), " C" (centre) or " R" (right ) . The string is Overfull \hbox (42.36206pt too wide) in paragraph at lines 31493--31493 []\T1/cmtt/m/n/10 For example, a value of " BL" means that the left end of the baseline of the original Overfull \hbox (26.6159pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 The Plot3D class currently does not interpret graphical esc ape sequences contained Overfull \hbox (37.11334pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 Text is not drawn at positions which have any coordinate eq ual to the value AST__BAD Overfull \hbox (41.83719pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (or where the transformation into graphical coordinates yields coordinates containing LaTeX Warning: Hyper reference `astClip' on page 516 undefined on input line 31 493. LaTeX Warning: Hyper reference `Frame' on page 516 undefined on input line 3149 3. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 An error results if the base Frame of the Plot is not 2-dim ensional or (for a LaTeX Warning: Hyper reference `TranInverse' on page 516 undefined on input lin e 31493. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [516] LaTeX Warning: Hyper reference `Object' on page 517 undefined on input line 315 87. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31587--31587 [] \T1/cmtt/m/n/10 If non-zero, returns information about the supplied Objec t pointer, rather than LaTeX Warning: Hyper reference `astUnlock' on page 517 undefined on input line 31587. LaTeX Warning: Hyper reference `astLock' on page 517 undefined on input line 31 587. Overfull \hbox (18.0096pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 A value of AST__UNLOCKED is returned if the Object (or pointer) is currently unlocked Overfull \hbox (8.82434pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 (i.e. has been unlocked using astUnlock but has not yet been lo cked using astLock). Overfull \hbox (2.26344pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 A value of AST__RUNNING is returned if the Object (or pointer) is currently locked Overfull \hbox (11.97357pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 by the running thread. A value of AST__OTHER is returned if the Object (or pointer) Overfull \hbox (0.37231pt too wide) in paragraph at lines 31587--31587 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the global error status is set, but Overfull \hbox (54.43411pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 no further error report will be made if it subsequently fails u nder these circumstances. Overfull \hbox (31.86462pt too wide) in paragraph at lines 31587--31587 [][]\T1/cmtt/m/n/10 This function always returns AST__RUNNING if the AST librar y has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when LaTeX Warning: Hyper reference `astClone' on page 517 undefined on input line 3 1587. Overfull \hbox (7.51216pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 At any one time, an AST Object can have several distinct poin ters, any one of which Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 can be used to access the Object structure. For instance, the a stClone function will Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 produce a new distinct pointer for a given Object. In fact, an AST " pointer" is not Overfull \hbox (23.52075pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 a real pointer at all - it is an identifier for a " handle" str ucture, encoded to make Overfull \hbox (28.50703pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 it look like a pointer. Each handle contains (amongst othere th ings) a " real" pointer Overfull \hbox (23.52075pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to the Object structure. This allows more than one handle to re fer to the same Object Overfull \hbox (7.51216pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 structure. So when you call astClone (for instance) you get bac k an identifier for LaTeX Warning: Hyper reference `astAnnul' on page 517 undefined on input line 3 1587. Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 In order to use an Object for anything useful, it must be loc ked for use by the running Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 thread (either implicitly at creation or explicitly using astLo ck). The identity of Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 the thread is stored in both the Object structure, and in the h andle that was passed Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to astLock (or returned by the constructor function). Thus it i s possible for a thread Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to have active pointers for Objects that are currently locked b y another thread. In Overfull \hbox (55.01306pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 general, if such a pointer is passed to an AST function an erro r will be reported indicating Overfull \hbox (2.52588pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 that the Object is currently locked by another thread. The two exceptions to this Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 is that astAnnul can be used to annull such a pointer, and this function can be used LaTeX Warning: Hyper reference `astEnd' on page 517 undefined on input line 315 87. Overfull \hbox (44.25319pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 The other practical consequence of this is that when astEnd i s called, all active pointers Overfull \hbox (34.01819pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [517] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 If the " ptr" parameter is zero, then the returned value desc ribes the Object structure Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [518] LaTeX Warning: Hyper reference `TimeMap' on page 519 undefined on input line 31 827. LaTeX Warning: Hyper reference `astTimeMap' on page 519 undefined on input line 31827. LaTeX Warning: Hyper reference `Mapping' on page 519 undefined on input line 31 827. LaTeX Warning: Hyper reference `Invert' on page 519 undefined on input line 318 27. Overfull \hbox (6.88478pt too wide) in paragraph at lines 31827--31827 []\T1/cmtt/m/n/10 void astTimeAdd( AstTimeMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 cvt, int narg, cons t double args[] ) Overfull \hbox (31.86462pt too wide) in paragraph at lines 31827--31827 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the time coordinate conversion Overfull \hbox (21.36719pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 to be added to the TimeMap. See the " Available Conversions" se ction for details Overfull \hbox (31.33975pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 An array containing argument values for the time coordinate con version. The number Overfull \hbox (5.62103pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 of arguments required, and hence the number of array elements u sed, depends on Overfull \hbox (15.85603pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the conversion specified (see the " Available Conversions" sect ion). This array LaTeX Warning: Hyper reference `astSimplify' on page 519 undefined on input lin e 31827. Overfull \hbox (37.11334pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (5.62103pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the most economical conversion path. A solution to this is to i nclude all the Overfull \hbox (5.3586pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 steps which are (logically) necessary, but then to use astSimpl ify to simplify Overfull \hbox (21.36719pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the resulting TimeMap. The simplification process will eliminat e any steps which Overfull \hbox (26.6159pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions Overfull \hbox (49.23947pt too wide) in paragraph at lines 31827--31827 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (2.52588pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 to indicate which time coordinate conversion is to be added to the TimeMap. Where Overfull \hbox (7.51216pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 arguments are needed by the conversion, they are listed in pare ntheses. Values for Overfull \hbox (23.52075pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units Overfull \hbox (2.52588pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [519] Overfull \hbox (33.75575pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 The arguments used in the above conversions are the zero-points used by the astTransform Overfull \hbox (23.52075pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [520] Overfull \hbox (43.93668pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 DTAI: The value of TAI-UTC (the value returned by astDat is used if DTAI is AST__BAD). Overfull \hbox (10.86975pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [521] LaTeX Warning: Hyper reference `TimeFrame' on page 522 undefined on input line 31917. LaTeX Warning: Hyper reference `Frame' on page 522 undefined on input line 3191 7. LaTeX Warning: Hyper reference `System' on page 522 undefined on input line 319 17. LaTeX Warning: Hyper reference `TimeOrigin' on page 522 undefined on input line 31917. LaTeX Warning: Hyper reference `TimeScale' on page 522 undefined on input line 31917. LaTeX Warning: Hyper reference `astSet' on page 522 undefined on input line 319 17. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ti meFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 31917--31917 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `astConvert' on page 522 undefined on input line 31917. LaTeX Warning: Hyper reference `AlignSystem' on page 522 undefined on input lin e 31917. LaTeX Warning: Hyper reference `AlignTimeScale' on page 522 undefined on input line 31917. Overfull \hbox (21.36719pt too wide) in paragraph at lines 31917--31917 [][]\T1/cmtt/m/n/10 When conversion between two TimeFrames is requested (as whe n supplying TimeFrames Overfull \hbox (26.6159pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 to astConvert), account will be taken of the nature of the time coordinate systems Overfull \hbox (16.11847pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 they represent, together with any qualifying time scale, offset , unit, etc. The LaTeX Warning: Hyper reference `Object' on page 522 undefined on input line 319 17. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31917--31917 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [522] [523] LaTeX Warning: Hyper reference `TimeMap' on page 524 undefined on input line 31 999. LaTeX Warning: Hyper reference `Mapping' on page 524 undefined on input line 31 999. LaTeX Warning: Hyper reference `astTimeAdd' on page 524 undefined on input line 31999. Overfull \hbox (10.60732pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to LaTeX Warning: Hyper reference `astSet' on page 524 undefined on input line 319 99. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ti meMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 31999--31999 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (12.44437pt too wide) in paragraph at lines 31999--31999 [][]\T1/cmtt/m/n/10 The nature and units of the coordinate values supplied for the first input (i.e. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 the time input) of a TimeMap must be appropriate to the first c onversion step Overfull \hbox (26.6159pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 applied by the TimeMap. For instance, if the first conversion s tep is " MJDTOBEP" Overfull \hbox (26.09103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 (Modified Julian Date to Besselian epoch) then the coordinate v alues for the first Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 input should be date in units of days. Similarly, the nature an d units of the Overfull \hbox (21.36719pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 coordinate values returned by a TimeMap will be determined by t he last conversion LaTeX Warning: Hyper reference `Object' on page 524 undefined on input line 319 99. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [524] LaTeX Warning: Hyper reference `Object' on page 525 undefined on input line 320 29. LaTeX Warning: Hyper reference `astFromString' on page 525 undefined on input l ine 32029. LaTeX Warning: Hyper reference `astFree' on page 525 undefined on input line 32 029. Overfull \hbox (23.25832pt too wide) in paragraph at lines 32029--32029 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [525] LaTeX Warning: Hyper reference `Mapping' on page 526 undefined on input line 32 083. Overfull \hbox (12.97206pt too wide) in paragraph at lines 32083--32083 []\T1/cmtt/m/n/10 void astTran1( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, const double xin[], int forward, double Overfull \hbox (15.85603pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (62.04475pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the coordinates o f the output (transformed) LaTeX Warning: Hyper reference `Nin' on page 526 undefined on input line 32083. LaTeX Warning: Hyper reference `Nout' on page 526 undefined on input line 32083 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 32083--32083 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 1 for both its Nin and Nout attributes. [526] LaTeX Warning: Hyper reference `Mapping' on page 527 undefined on input line 32 150. Overfull \hbox (10.3477pt too wide) in paragraph at lines 32150--32150 []\T1/cmtt/m/n/10 void astTran2( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, const double xin[], const double yin[], Overfull \hbox (6.93321pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array of " npoint" X-coordinate values for the input (untran sformed) points. Overfull \hbox (6.93321pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array of " npoint" Y-coordinate values for the input (untran sformed) points. Overfull \hbox (15.85603pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (0.10988pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the X-coordinates of the output Overfull \hbox (0.10988pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the Y-coordinates of the output LaTeX Warning: Hyper reference `Nin' on page 527 undefined on input line 32150. LaTeX Warning: Hyper reference `Nout' on page 527 undefined on input line 32150 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 32150--32150 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 2 for both its Nin and Nout attributes. [527] LaTeX Warning: Hyper reference `Mapping' on page 528 undefined on input line 32 306. Overfull \hbox (20.84514pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 void astTranGrid( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int ncoord_in, const int lbnd[], const int ubnd[], Overfull \hbox (5.09616pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of coordinates being supplied for each box corner (i .e. the number Overfull \hbox (52.8595pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ncoord_in" elements, co ntaining the coordinates Overfull \hbox (52.8595pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ncoord_in" elements, co ntaining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (5.3586pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 This should be expressed as a displacement within the output co ordinate system Overfull \hbox (17.69308pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 in adjacent panel will be higher. If this is a problem, reduce the tolerance Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in input grid po ints) for the adaptive Overfull \hbox (54.43411pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 algorithm which approximates non-linear Mappings with piece-wis e linear transformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (15.85603pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [528] Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (13.23167pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 100 grid points can also be employed as a safeguard in general- purpose software, Overfull \hbox (63.35693pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (15.85603pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " out" array (which will Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 contain the output coordinates). The value given should not be less than the Overfull \hbox (68.34322pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (12.44437pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 , into which the coordinates of the output (transformed) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output Overfull \hbox (21.36719pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 point number " point" will be found in element " out[coord][poi nt]" . The points Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 are ordered such that the first axis of the input grid changes most rapidly. For Overfull \hbox (21.36719pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 example, if the input grid is 2-dimensional and extends from (2 ,-1) to (3,1), the Overfull \hbox (8.24539pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 output points will be stored in the order (2,-1), (3, -1), (2,0 ), (3,0), (2,1), LaTeX Warning: Hyper reference `Nin' on page 529 undefined on input line 32306. LaTeX Warning: Hyper reference `Nout' on page 529 undefined on input line 32306 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its Nin attribute and t he value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these [529] LaTeX Warning: Hyper reference `TranMap' on page 530 undefined on input line 32 408. LaTeX Warning: Hyper reference `Mapping' on page 530 undefined on input line 32 408. Overfull \hbox (9.9315pt too wide) in paragraph at lines 32408--32408 []\T1/cmtt/m/n/10 AstTranMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astTranMap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map1, AstMapping $\OMS/zplm/m/ n/10 ^^C$\T1/cmtt/m/n/10 map2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... Overfull \hbox (17.69308pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to the first component Mapping, which defines the forwa rd transformation. Overfull \hbox (22.9418pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to the second component Mapping, which defines the inve rse transformation. LaTeX Warning: Hyper reference `astSet' on page 530 undefined on input line 324 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Tr anMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Nout' on page 530 undefined on input line 32408 . LaTeX Warning: Hyper reference `Nin' on page 530 undefined on input line 32408. Overfull \hbox (41.31232pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 The number of output coordinates generated by the two Mappi ngs (their Nout attribute) Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 must be equal, as must the number of input coordinates accepted by each Mapping LaTeX Warning: Hyper reference `astCopy' on page 530 undefined on input line 32 408. Overfull \hbox (10.60732pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astTranMap (the new Overfull \hbox (5.09616pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 TranMap simply retains a reference to them). They may continue to be used for Overfull \hbox (0.37231pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a TranMap contain ing a copy of Overfull \hbox (0.37231pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the TranMap should be made LaTeX Warning: Hyper reference `Object' on page 530 undefined on input line 324 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [530] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32408--32408 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] LaTeX Warning: Hyper reference `Mapping' on page 532 undefined on input line 32 514. LaTeX Warning: Hyper reference `astTranP' on page 532 undefined on input line 3 2514. Overfull \hbox (7.72334pt too wide) in paragraph at lines 32514--32514 []\T1/cmtt/m/n/10 void astTranN( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, int ncoord_in, int indim, const double Overfull \hbox (10.34488pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point ( i.e. the number Overfull \hbox (36.8509pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (0.37231pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 the input coordinates). This value is required so that the coor dinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (58.10822pt too wide) in paragraph at lines 32514--32514 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord_in][indim]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 , containing the coordinates of the input (untransformed) point s. These should Overfull \hbox (26.35347pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 be stored such that the value of coordinate number " coord" for input point number Overfull \hbox (15.85603pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (21.10475pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " out" array (which will Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 contain the output coordinates). This value is required so that the coordinate Overfull \hbox (10.60732pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 values can be correctly located if they will not entirely fill this array. The Overfull \hbox (68.34322pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (12.44437pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 , into which the coordinates of the output (transformed) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [532] LaTeX Warning: Hyper reference `Nin' on page 533 undefined on input line 32514. LaTeX Warning: Hyper reference `Nout' on page 533 undefined on input line 32514 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its Nin attribute and t he value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these [533] LaTeX Warning: Hyper reference `Mapping' on page 534 undefined on input line 32 609. LaTeX Warning: Hyper reference `astTranN' on page 534 undefined on input line 3 2609. Overfull \hbox (5.31017pt too wide) in paragraph at lines 32609--32609 []\T1/cmtt/m/n/10 void astTranP( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, int ncoord_in, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 ptr_in[], Overfull \hbox (10.34488pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point ( i.e. the number Overfull \hbox (42.09962pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 An array of pointers to double, with " ncoord_in" elements. Ele ment " ptr_in[coord]" Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 should point at the first element of an array of double (with " npoint" elements) Overfull \hbox (41.04988pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 which contain the values of coordinate number " coord" for each input (untransformed) Overfull \hbox (10.86975pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 point. The value of coordinate number " coord" for input point number " point" Overfull \hbox (38.68796pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 is therefore given by " ptr_in[coord][point]" (assuming both in dices are zero-based). Overfull \hbox (15.85603pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (52.59706pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 An array of pointers to double, with " ncoord_out" elements. El ement " ptr_out[coord]" Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 should point at the first element of an array of double (with " npoint" elements) Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 into which the values of coordinate number " coord" for each ou tput (transformed) Overfull \hbox (16.11847pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 point will be written. The value of coordinate number " coord" for output point LaTeX Warning: Hyper reference `Nin' on page 534 undefined on input line 32609. LaTeX Warning: Hyper reference `Nout' on page 534 undefined on input line 32609 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 32609--32609 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its Nin attribute and t he value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these [534] [535] LaTeX Warning: Hyper reference `astTuneC' on page 536 undefined on input line 3 2691. Overfull \hbox (0.10988pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 The new value for the tuning parameter. If this is AST__TUNULL, the existing Overfull \hbox (7.51216pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 The original value of the tuning parameter. A default value wil l be returned if no Overfull \hbox (8.24539pt too wide) in paragraph at lines 32691--32691 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Underfull \hbox (badness 10000) in paragraph at lines 32691--32691 LaTeX Warning: Hyper reference `Object' on page 536 undefined on input line 326 91. LaTeX Warning: Hyper reference `astDelete' on page 536 undefined on input line 32691. Overfull \hbox (2.001pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 A boolean flag which indicates what should happen to the memory occupied by an AST Overfull \hbox (2.26344pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 Object when the Object is deleted (i.e. when its reference coun t falls to zero or Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 it is deleted using astDelete). If this is zero, the memory is simply freed using Overfull \hbox (7.7746pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 the systems " free" function. If it is non-zero, the memory is not freed. Instead Overfull \hbox (18.27203pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 a pointer to it is stored in a pool of such pointers, all of wh ich refer to allocated Overfull \hbox (18.27203pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 but currently unused blocks of memory. This allows AST to speed up subsequent Object Overfull \hbox (2.26344pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 creation by re-using previously allocated memory blocks rather than allocating new Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 memory using the systems malloc function. The default value for this parameter is Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 zero. Setting it to a non-zero value will result in Object memo ry being cached in Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 future. Setting it back to zero causes any memory blocks curren tly in the pool to Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 be freed. Note, this tuning parameter only controls the caching of memory used to Overfull \hbox (14.59793pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 store AST Objects. To cache other memory blocks allocated by AS T, use MemoryCaching. Overfull \hbox (17.74716pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 A boolean flag similar to ObjectCaching except that it controls caching of all memory Overfull \hbox (20.8964pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [536] LaTeX Warning: Hyper reference `astTune' on page 537 undefined on input line 32 804. Overfull \hbox (5.3586pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 The new value for the tuning parameter. If this is NULL, the ex isting current Overfull \hbox (17.43065pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A character string in which to return the original value of the tuning parameter. Overfull \hbox (20.84232pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 An error will be reported if the buffer is too small to hold th e value. NULL may Overfull \hbox (8.24539pt too wide) in paragraph at lines 32804--32804 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Underfull \hbox (badness 10000) in paragraph at lines 32804--32804 Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the hours field in a formatted s ky axis value when " Overfull \hbox (39.2669pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 g" format is in use (see the Format attribute). This string may include escape sequences Overfull \hbox (13.02332pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 to produce super-scripts, etc. (see the Escapes attribute for d etails of the escape Overfull \hbox (53.81912pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 sequences allowed). The default value is " %-%$[]$50$\OT1/zplm/ m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 h%$\OT1/zplm/m /n/10 +$\T1/cmtt/m/n/10 " which produces a super-script Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the minutes field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$50$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 m%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the seconds field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$50$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 s%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the degrees field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$53$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s60$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 o%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (2.26344pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the arc-minutes field in a forma tted sky axis value Overfull \hbox (22.06438pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 when " g" format is in use. The default value is " %-%$[]$20$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 %s85$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 ' %$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces [537] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the arc-seconds field in a forma tted sky axis value Overfull \hbox (27.52428pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 when " g" format is in use. The default value is " %-%$[]$20$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 %s85$\OT1/zplm/m/n/10 +$$\OMS/zplm/m/n/10 n$\T 1/cmtt/m/n/10 " %$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces Overfull \hbox (14.3355pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn to introduce the exponent in a value when " g" format is in use. Overfull \hbox (18.96321pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 The default value is " 10%-%$[]$50$\OT1/zplm/m/n/10 +$\T1/cmtt/ m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces " 10" followed by the exponent [538] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 539 undefined on in put line 33012. Overfull \hbox (24.21193pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 void astUinterp( int ndim_in, const int lbnd_in[], const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ Overfull \hbox (3.69067pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zpl m/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int npoint, const int offset[], const do uble $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 const Overfull \hbox (21.13287pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 coords[], const double params[], int flags, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, $\OML/zplm /m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 out[], $\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape , size and coordinate Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (1.32593pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the input data. This will be the same array as was passed to as tResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (10.60732pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 via the " in" parameter. The numerical type of this array shoul d match that of Overfull \hbox (28.19052pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an optional second array with the same size and type as the " in" array. Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 If given, this will contain the set of variance values associat ed with the input Overfull \hbox (27.56952pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 data and will be the same array as was passed to astResample$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 via th e " in_var" Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 The number of points at which the input grid is to be interpola ted. This will Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers with " npoint" elements. For ea ch interpolation Overfull \hbox (46.56104pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 point, this will contain the zero-based index in the " out" (an d " out_var" ) array(s) Overfull \hbox (17.69308pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 at which the interpolated value (and its variance, if required) should be stored. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 For example, the interpolated value for point number " point" s hould be stored Overfull \hbox (31.60219pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 An array of pointers to double, with " ndim_in" elements. Eleme nt " coords[coord]" Overfull \hbox (9.55757pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 will point at the first element of an array of double (with " n point" elements) Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 which contains the values of coordinate number " coord" for eac h interpolation Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 point. The value of coordinate number " coord" for interpolatio n point number Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [539] Overfull \hbox (21.36719pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 If any interpolation point has any of its coordinates equal t o the value AST__BAD Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 (as defined in the " ast.h" header file), then the correspondin g output data (and Overfull \hbox (28.97783pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 variance) should either be set to the value given by " badval" , or left unchanged, Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be a pointer to the same array as was given via the " params" parameter Overfull \hbox (1.32593pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/ m/it/10 >$\T1/cmtt/m/n/10 . You may use this to pass any additional parameter v alues Overfull \hbox (49.87657pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be the same value as was given via the " flags" param eter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\ T1/cmtt/m/n/10 . Overfull \hbox (15.5936pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 You may test this value to provide additional control over the operation of your Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 resampling algorithm. Note that the special flag values AST__UR ESAMP1, 2, 3 & Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 4 are reserved for you to use for your own purposes and will no t clash with other Overfull \hbox (56.17503pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be the same value as was given via the " badval" para meter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 , Overfull \hbox (37.11334pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 and will have the same numerical type as the data being process ed (i.e. as elements Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 of the " in" array). It should be used to test for bad pixels i n the input grid Overfull \hbox (15.5936pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 (but only if the AST__USEBAD flag is set via the " flags" param eter) and (unless Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the AST__NOBAD flag is set in " flags" ) for identifying bad ou tput values in Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array with the same numerical type as the " in" a rray, into which Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the interpolated data values should be returned. Note that deta ils of the storage Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 order and number of dimensions of this array are not required, since the " offset" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 array contains all necessary information about where each retur ned value should Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 In general, not all elements of this array (or the " out_var" array below) may Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 be used in any particular invocation of the function. Those whi ch are not used Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an optional array with the same type and size as the " out" array, into Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 which variance estimates for the resampled values should be ret urned. This array Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 If given, it is addressed in exactly the same way (via the " offset" array) as Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the " out" array. The values returned should be estimates of th e statistical Overfull \hbox (15.85603pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 variance of the corresponding values in the " out" array, on th e assumption that Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 all errors in input data values are statistically independent a nd that their variance Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an int in which to return the number of interpolatio n points at which Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 no valid interpolated value could be obtained. The maximum valu e that should Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [540] Overfull \hbox (14.44772pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 The data type $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 indicates the numerical type of the data bei ng processed, Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 This function will typically be invoked more than once for each invocation of LaTeX Warning: Hyper reference `astSetStatus' on page 541 undefined on input li ne 33012. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 If an error occurs within this function, it should use astS etStatus to set the Overfull \hbox (0.10988pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 AST error status to an error value. This will cause an immediat e return from Overfull \hbox (11.82336pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/i t/10 >$\T1/cmtt/m/n/10 . The error value AST__UINER is available for this purpo se, but Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [541] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 542 undefined on in put line 33103. Overfull \hbox (5.3586pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be the offset of the pixel from the interpolation poi nt, measured in Overfull \hbox (42.36206pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 pixels. This value may be positive or negative, but for most pr actical interpolation Overfull \hbox (20.84232pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be a pointer to the same array as was given via the " params" parameter Overfull \hbox (1.32593pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/ m/it/10 >$\T1/cmtt/m/n/10 . You may use this to pass any additional parameter v alues Overfull \hbox (10.86975pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 required by your kernel, but note that " params[0]" will alread y have been used Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 to specify the number of neighbouring pixels which contribute t o the interpolated Overfull \hbox (49.87657pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be the same value as was given via the " flags" param eter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\ T1/cmtt/m/n/10 . Overfull \hbox (15.5936pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 You may test this value to provide additional control over the operation of your Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 function. Note that the special flag values AST__URESAMP1, 2, 3 & 4 are reserved Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 for you to use for your own purposes and will not clash with ot her pre-defined Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 Pointer to a double to receive the calculated kernel value, whi ch may be positive Overfull \hbox (26.6159pt too wide) in paragraph at lines 33103--33103 [][]\T1/cmtt/m/n/10 Not all functions make good interpolation kernels. In gener al, acceptable kernels Overfull \hbox (0.37231pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 tend to be symmetrical about zero, to have a positive peak (usu ally unity) at Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 zero, and to evaluate to zero whenever the pixel offset has any other integral Overfull \hbox (17.43065pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 value (this ensures that the interpolated values pass through t he original data). Overfull \hbox (5.3586pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 An interpolation kernel may or may not have regions with negati ve values. You LaTeX Warning: Hyper reference `astSetStatus' on page 542 undefined on input li ne 33103. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 [][]\T1/cmtt/m/n/10 If an error occurs within this function, it should use astS etStatus to set the Overfull \hbox (0.10988pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 AST error status to an error value. This will cause an immediat e return from Overfull \hbox (11.82336pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/i t/10 >$\T1/cmtt/m/n/10 . The error value AST__UK1ER is available for this purpo se, but Overfull \hbox (10.86975pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [542] [543] LaTeX Warning: Hyper reference `Frame' on page 544 undefined on input line 3340 1. LaTeX Warning: Hyper reference `astFormat' on page 544 undefined on input line 33401. Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The number of the Frame axis for which a coordinate value is to be read (axis Overfull \hbox (21.36719pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the fo rmatted coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value. This string may contain additional information following the value to Overfull \hbox (52.8595pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 be read, in which case reading stops at the first character whi ch cannot be interpreted Overfull \hbox (1.94693pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 as part of the value. Any white space before or after the value is discarded. Overfull \hbox (17.74716pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 This function applies to all Frames. See the " Frame Input Form at" section below for LaTeX Warning: Hyper reference `SkyFrame' on page 544 undefined on input line 3 3401. Overfull \hbox (18.0096pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The SkyFrame class re-defines the input format to be suitable f or representing angles Overfull \hbox (28.76947pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 and times, with the resulting coordinate value returned in radi ans. See the " SkyFrame LaTeX Warning: Hyper reference `FrameSet' on page 544 undefined on input line 3 3401. LaTeX Warning: Hyper reference `Current' on page 544 undefined on input line 33 401. Overfull \hbox (44.25319pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The input formats accepted by a FrameSet are determined by its current Frame (as specified Overfull \hbox (19.58421pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The number of characters read from the string in order to obtai n the coordinate value. Overfull \hbox (29.24026pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A function value of zero (and no coordinate value) will be returned, without error, Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Beware that it is possible for a formatting error part-way through an input string Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 to terminate input before it has been completely read, but to y ield a coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value that appears valid. For example, if a user types " 1.5r6" instead of " Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 1.5e6" , the " r" will terminate input, giving an incorrect coo rdinate value of Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [544] Overfull \hbox (18.74283pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 An error will result if a value is read which appears to ha ve the correct format, Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 but which cannot be converted into a valid coordinate value (fo r instance, because Overfull \hbox (27.56952pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The string " $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/ zplm/m/it/10 >$\T1/cmtt/m/n/10 " is recognised as a special case and will yield the coordinate Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value AST__BAD without error. The test for this string is case- insensitive and Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A function result of zero will be returned and no coordinat e value will be returned Overfull \hbox (5.3586pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 via the " value" pointer if this function is invoked with the A ST error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A sequence of one or more digits possibly containing a deci mal point, followed Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The exponent field, if present, consists of " E" or " e" fo llowed by a possibly Overfull \hbox (5.3586pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 An optional sign, followed by between one and three fields representing either Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 degrees, arc-minutes, arc-seconds or hours, minutes, seconds (e .g. " -12 42 03" Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Each field should consist of a sequence of one or more digi ts, which may include Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 leading zeros. At most one field may contain a decimal point, i n which case it Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 is taken to be the final field (e.g. decimal degrees might be g iven as " 124.707" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The first field given may take any value, allowing angles a nd times outside the Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 conventional ranges to be represented. However, subsequent fiel ds must have values Overfull \hbox (47.34834pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Fields may be separated by white space or by " :" (colon), but the choice of separator Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 must be used consistently throughout the value. Additional whit e space may be Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The following field identification characters may be used a s separators to replace Overfull \hbox (31.60219pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 either of those above (or may be appended to the final field), in order to identify Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 the field to which they are appended: " d" ---degrees; " h" --- hours; " m" ---minutes Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 of arc or time; " s" ---seconds of arc or time; " ' " (single q uote)---minutes of Overfull \hbox (0.37231pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 arc; " " " (double quote)---seconds of arc. Either lower or upp er case may be Overfull \hbox (0.37231pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [545] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The presence of any of the field identification characters " d" , " ' " (single Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 quote) or " " " (double quote) indicates that the value is to b e interpreted as Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 an angle. Conversely, the presence of " h" indicates that it is to be interpreted Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 as a time (with 24 hours corresponding to 360 degrees). Incompa tible angle/time Overfull \hbox (1.94693pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 identification characters may not be mixed (e.g. " 10h14' 3" " is not valid). Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The remaining field identification characters and separators do not specify a Overfull \hbox (8.24539pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 If no preference for an angle or a time is expressed anywhe re within the value, Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 it is interpreted as an angle if the Format attribute string as sociated with the Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 SkyFrame axis generates an angle and as a time otherwise. This ensures that values Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Fields may be omitted, in which case they default to zero. The remaining fields Overfull \hbox (25.56616pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 may be identified by using appropriate field identification cha racters (see above) Overfull \hbox (42.36206pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 and/or by adding extra colon separators (e.g. " -05m13s" is equ ivalent to " -:05:13" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 ). If a field is not identified explicitly, it is assumed that adjacent fields Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 have been given, after taking account of any extra separator ch aracters (e.g. " Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 14:25.4s" specifies minutes and seconds, while " 14::25.4s" spe cifies degrees Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 If fields are omitted in such a way that the remaining ones cannot be identified Overfull \hbox (37.11334pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 uniquely (e.g. " 01:02" ), then the first field (either given e xplicitly or implied Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 by an extra leading colon separator) is taken to be the most si gnificant field Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 that astFormat would produce when formatting a value (using the Format attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 associated with the SkyFrame axis). By default, this means that the first field Overfull \hbox (31.60219pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 will normally be interpreted as degrees or hours. However, if t his does not result Overfull \hbox (15.85603pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 in consistent field identification, then the last field (either given explicitly Overfull \hbox (58.10822pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 or implied by an extra trailing colon separator) is taken to to be the least significant Overfull \hbox (12.76088pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 This final convention is intended to ensure that values formatt ed by astFormat which Overfull \hbox (52.3887pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 contain less than three fields will be correctly interpreted if read back using astUnformat, Overfull \hbox (1.47614pt too wide) in paragraph at lines 33401--33401 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [546] LaTeX Warning: Hyper reference `Format(axis)' on page 547 undefined on input li ne 33401. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [547] LaTeX Warning: Hyper reference `UnitMap' on page 548 undefined on input line 33 462. LaTeX Warning: Hyper reference `Mapping' on page 548 undefined on input line 33 462. Overfull \hbox (0.10988pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 The number of input and output coordinates (these numbers are n ecessarily the LaTeX Warning: Hyper reference `astSet' on page 548 undefined on input line 334 62. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Un itMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 33462--33462 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 548 undefined on input line 334 62. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33462--33462 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [548] LaTeX Warning: Hyper reference `UnitNormMap' on page 549 undefined on input lin e 33565. LaTeX Warning: Hyper reference `Nin' on page 549 undefined on input line 33565. Overfull \hbox (26.30504pt too wide) in paragraph at lines 33565--33565 []\T1/cmtt/m/n/10 AstUnitNormMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astUnitN ormMap( int ncoord, const double centre[], const char $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 options, Overfull \hbox (26.09103pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (21.36719pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Ou tput will include Overfull \hbox (21.10475pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 An array containing the values to be subtracted from the input coordinates before Overfull \hbox (49.1854pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 computing unit vector and norm. A separate value must be suppli ed for each coordinate. LaTeX Warning: Hyper reference `astSet' on page 549 undefined on input line 335 65. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.62103pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Un itNormMap. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 syntax used is identical to that for the astSet function and ma y include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33565--33565 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [549] LaTeX Warning: Hyper reference `Object' on page 550 undefined on input line 335 65. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33565--33565 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 33565--33565 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [550] LaTeX Warning: Hyper reference `Object' on page 551 undefined on input line 336 27. LaTeX Warning: Hyper reference `astLock' on page 551 undefined on input line 33 627. Overfull \hbox (47.61078pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 If non-zero, an error will be reported if the supplied Object, or any Object contained Overfull \hbox (5.3586pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 within the supplied Object, is not currently locked by the runn ing thread. If Overfull \hbox (0.37231pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the global error status is set, but Overfull \hbox (54.43411pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 no further error report will be made if it subsequently fails u nder these circumstances. Overfull \hbox (37.11334pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 All unlocked Objects are excluded from AST context handling until they are re-locked Overfull \hbox (0.10988pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function returns without action if the Object is not c urrently locked by Overfull \hbox (0.37231pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 any thread. If it is locked by the running thread, it is unlock ed. If it is Overfull \hbox (5.62103pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function returns without action if the AST library has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [551] LaTeX Warning: Hyper reference `Object' on page 552 undefined on input line 336 62. Overfull \hbox (12.76088pt too wide) in paragraph at lines 33662--33662 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [552] LaTeX Warning: Hyper reference `KeyMap' on page 553 undefined on input line 337 64. LaTeX Warning: Hyper reference `astRead' on page 553 undefined on input line 33 764. LaTeX Warning: Hyper reference `astWrite' on page 553 undefined on input line 3 3764. LaTeX Warning: Hyper reference `Channel' on page 553 undefined on input line 33 764. LaTeX Warning: Hyper reference `Strict' on page 553 undefined on input line 337 64. LaTeX Warning: Hyper reference `Object' on page 553 undefined on input line 337 64. Overfull \hbox (44.25319pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 The basic Channel class generates a warning when ever an un-rec ognised item is encountered Overfull \hbox (31.1314pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 whilst reading an Object from an external data source. If Stric t is zero (the default), Overfull \hbox (18.27203pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 then unexpected items in the Object description are simply igno red, and any remaining Overfull \hbox (23.52075pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 items are used to construct the returned Object. If Strict is n on-zero, an error will Overfull \hbox (25.09537pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 be reported and a NULL Object pointer returned if any unexpecte d items are encountered. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33764--33764 []\T1/cmtt/m/n/10 As AST continues to be developed, new attributes are added oc casionally to selected Overfull \hbox (39.2669pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 classes. If an older version of AST is used to read external Ob ject descriptions created Overfull \hbox (13.02332pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 by a more recent version of AST, then the Channel class will, b y default, ignore the Overfull \hbox (33.75575pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 new attributes, using the remaining attributes to construct the Object. This is usually Overfull \hbox (13.02332pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 a good thing. However, since external Object descriptions are o ften stored in plain Overfull \hbox (44.25319pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 text, it is possible to edit them using a text editor. This giv es rise to the possibility Overfull \hbox (56.58768pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 of genuine errors in the description due to finger-slips, typos , or simple mis-understanding. Overfull \hbox (7.7746pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 Such inappropriate attributes will be ignored if Strict is left at its default zero Overfull \hbox (59.73691pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 value. This will cause the mis-spelled attribute to revert to i ts default value, potentially Overfull \hbox (7.7746pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 causing subtle changes in the behaviour of application software . If such an effect Overfull \hbox (2.52588pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 is suspected, the Strict attribute can be set non-zero, resulti ng in the erroneous LaTeX Warning: Hyper reference `FitsChan' on page 553 undefined on input line 3 3764. LaTeX Warning: Hyper reference `Warnings' on page 553 undefined on input line 3 3764. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 The returned KeyMap will contain warnings for all conditions li sted in the Warnings LaTeX Warning: Hyper reference `XmlChan' on page 553 undefined on input line 33 764. Overfull \hbox (33.75575pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [553] Overfull \hbox (10.60732pt too wide) in paragraph at lines 33764--33764 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [554] LaTeX Warning: Hyper reference `astOK' on page 555 undefined on input line 3381 7. LaTeX Warning: Hyper reference `astStatus' on page 555 undefined on input line 33817. LaTeX Warning: Hyper reference `astClearStatus' on page 555 undefined on input line 33817. Overfull \hbox (0.37231pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 Pointer to an int whose value is to be used subsequently as the AST inherited Overfull \hbox (26.6159pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 status value. If a NULL pointer is supplied, the AST library wi ll revert to using Overfull \hbox (39.00447pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 Address of the previous error status variable. This may later b e passed back to astWatch Overfull \hbox (18.27203pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 to restore the previous behaviour of the library. (Note that on the first invocation Overfull \hbox (43.46588pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 of astWatch the returned value will be the address of the inter nal error status variable.) Overfull \hbox (1.94693pt too wide) in paragraph at lines 33817--33817 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [555] LaTeX Warning: Hyper reference `WcsMap' on page 556 undefined on input line 340 01. LaTeX Warning: Hyper reference `Mapping' on page 556 undefined on input line 34 001. LaTeX Warning: Hyper reference `WcsType' on page 556 undefined on input line 34 001. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 556 undefined on input line 34001. LaTeX Warning: Hyper reference `PVi_m' on page 556 undefined on input line 3400 1. Overfull \hbox (21.05632pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 AstWcsMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astWcsMap( in t ncoord, int type, int lonax, int latax, const char $\OMS/zplm/m/n/10 ^^C$\T1/ cmtt/m/n/10 options, Overfull \hbox (26.09103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.37231pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th is must be at Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The type of FITS-WCS projection to apply. This should be given using a macro Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 value such as AST__TAN (for a tangent plane projection), where the characters Overfull \hbox (16.11847pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 following the double underscore give the projection type code ( in upper case) as Overfull \hbox (5.3586pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 used in the FITS-WCS " CTYPEi" keyword. You should consult the FITS-WCS paper Overfull \hbox (0.37231pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 for a list of the available projections. The additional code of AST__TPN can Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 be supplied which represents a TAN projection with polynomial c orrection terms Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [556] Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The index of the latitude axis. This should lie in the range 1 to " ncoord" and LaTeX Warning: Hyper reference `astSet' on page 557 undefined on input line 340 01. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Wc sMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 If the sky projection to be implemented requires projection p arameter values to Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 be set, then this should normally be done here via the PVi_m at tribute (see the Overfull \hbox (10.60732pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 " Examples" section). Setting values for these parameters is ma ndatory if they Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 Creates a WcsMap that implements a FITS-WCS Mercator project ion on pairs of Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 coordinates, with coordinates 1 and 2 representing the longitud e and latitude Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 respectively. Note that the FITS-WCS Mercator projection does n ot require any LaTeX Warning: Hyper reference `Projection' on page 557 undefined on input line 34001. Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 Creates a WcsMap that implements a FITS-WCS conical equal ar ea projection. The Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 WcsMap acts on points in a 3-dimensional space; coordinates 2 a nd 3 represent Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 longitude and latitude respectively, while the values of coordi nate 1 are Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 copied unchanged. Projection parameter 1 associatyed with the l atitude axis Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 (corresponding to FITS keyword " PV3_1" ) is required and has n o default, so Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 is set explicitly to 40.0 degrees. Projection parameter 2 (corr esponding to Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 FITS keyword " PV3_2" ) is required but has a default of zero, so need not be LaTeX Warning: Hyper reference `astInvert' on page 557 undefined on input line 34001. LaTeX Warning: Hyper reference `Invert' on page 557 undefined on input line 340 01. Overfull \hbox (37.11334pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 The forward transformation of a WcsMap converts between FIT S-WCS " native spherical" Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 and " relative physical" coordinates, while the inverse transfo rmation converts Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 in the opposite direction. This arrangement may be reversed, if required, by Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 If any set of coordinates cannot be transformed (for exampl e, many projections Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 do not cover the entire celestial sphere), then a WcsMap will y ield coordinate Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 The validity of any projection parameters given via the PVi _m parameter in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 " options" string is not checked by this function. However, the ir validity is Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 checked when the resulting WcsMap is used to transform coordina tes, and an error Overfull \hbox (36.8509pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [557] LaTeX Warning: Hyper reference `Object' on page 558 undefined on input line 340 01. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [558] LaTeX Warning: Hyper reference `WinMap' on page 559 undefined on input line 341 07. LaTeX Warning: Hyper reference `Mapping' on page 559 undefined on input line 34 107. Overfull \hbox (23.4695pt too wide) in paragraph at lines 34107--34107 []\T1/cmtt/m/n/10 AstWinMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astWinMap( in t ncoord, const double ina[], const double inb[], const double Overfull \hbox (26.09103pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner A of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner B of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner A of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner B of th e window in the LaTeX Warning: Hyper reference `astSet' on page 559 undefined on input line 341 07. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Wi nMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34107--34107 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 559 undefined on input line 341 07. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34107--34107 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [559] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34107--34107 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [560] LaTeX Warning: Hyper reference `Object' on page 561 undefined on input line 341 70. LaTeX Warning: Hyper reference `Channel' on page 561 undefined on input line 34 170. LaTeX Warning: Hyper reference `FitsChan' on page 561 undefined on input line 3 4170. Overfull \hbox (7.51216pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 If the FitsChan uses a foreign encoding (e.g. FITS-WCS) rather than the native AST Overfull \hbox (28.76947pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 encoding, then storing values in the FitsChan for keywords NAXI S1, NAXIS2, etc., before Overfull \hbox (20.63396pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 The number of Objects written to the Channel by this invocation of astWrite (normally, Overfull \hbox (10.60732pt too wide) in paragraph at lines 34170--34170 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (10.86975pt too wide) in paragraph at lines 34170--34170 [][]\T1/cmtt/m/n/10 Invoking this function will usually cause the sink function associated with the Overfull \hbox (10.86975pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 channel to be called in order to transfer a textual description of the supplied Overfull \hbox (38.68796pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 object to some external data store. However, the FitsChan class behaves differently. Overfull \hbox (0.37231pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 Invoking this function on a FitsChan causes new FITS header car ds to be added Overfull \hbox (21.36719pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [561] LaTeX Warning: Hyper reference `FitsChan' on page 562 undefined on input line 3 4207. LaTeX Warning: Hyper reference `SinkFile' on page 562 undefined on input line 3 4207. LaTeX Warning: Hyper reference `astEmptyFits' on page 562 undefined on input li ne 34207. Overfull \hbox (10.60732pt too wide) in paragraph at lines 34207--34207 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [562] LaTeX Warning: Hyper reference `XmlChan' on page 563 undefined on input line 34 308. LaTeX Warning: Hyper reference `Channel' on page 563 undefined on input line 34 308. LaTeX Warning: Hyper reference `Object' on page 563 undefined on input line 343 08. LaTeX Warning: Hyper reference `astWrite' on page 563 undefined on input line 3 4308. LaTeX Warning: Hyper reference `SinkFile' on page 563 undefined on input line 3 4308. LaTeX Warning: Hyper reference `SourceFile' on page 563 undefined on input line 34308. Overfull \hbox (8.56807pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 AstXmlChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astXmlChan( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/cm tt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink)( const char $\OMS/zplm/m/n/10 ^^C$ Overfull \hbox (0.37231pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (21.36719pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 this function will be used by the XmlChan to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 invocation, it should return a pointer to the next input line r ead from some external Overfull \hbox (16.11847pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 this function will be used by the XmlChan to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the LaTeX Warning: Hyper reference `astSet' on page 563 undefined on input line 343 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Xm lChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34308--34308 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (8.24539pt too wide) in paragraph at lines 34308--34308 [][]\T1/cmtt/m/n/10 If the external data source or sink uses a character encodi ng other than ASCII, Overfull \hbox (47.34834pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [563] Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [564] LaTeX Warning: Hyper reference `ZoomMap' on page 565 undefined on input line 34 389. LaTeX Warning: Hyper reference `Mapping' on page 565 undefined on input line 34 389. Overfull \hbox (26.09103pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number LaTeX Warning: Hyper reference `Zoom' on page 565 undefined on input line 34389 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 Initial scale factor by which coordinate values should be multi plied (by the forward Overfull \hbox (63.0945pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 transformation) or divided (by the inverse transformation). Thi s factor may subsequently Overfull \hbox (2.99667pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 be changed via the ZoomMap' s Zoom attribute. It may be positiv e or negative, LaTeX Warning: Hyper reference `astSet' on page 565 undefined on input line 343 89. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Zo omMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34389--34389 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for LaTeX Warning: Hyper reference `Object' on page 565 undefined on input line 343 89. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34389--34389 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 34389--34389 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [565] [566] [567] LaTeX Warning: Hyper reference `astGrid' on page 568 undefined on input line 34 433. LaTeX Warning: Hyper reference `Plot' on page 568 undefined on input line 34433 . [568] LaTeX Warning: Hyper reference `Region' on page 569 undefined on input line 344 94. LaTeX Warning: Hyper reference `System' on page 569 undefined on input line 344 94. LaTeX Warning: Hyper reference `Mapping' on page 569 undefined on input line 34 494. LaTeX Warning: Hyper reference `Epoch' on page 569 undefined on input line 3449 4. [569] LaTeX Warning: Hyper reference `SkyFrame' on page 570 undefined on input line 3 4527. LaTeX Warning: Hyper reference `astFindFrame' on page 570 undefined on input li ne 34527. LaTeX Warning: Hyper reference `astConvert' on page 570 undefined on input line 34527. LaTeX Warning: Hyper reference `SkyRefIs' on page 570 undefined on input line 3 4527. LaTeX Warning: Hyper reference `UnitMap' on page 570 undefined on input line 34 527. LaTeX Warning: Hyper reference `AlignSystem' on page 570 undefined on input lin e 34527. [570] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 571 undefined on input li ne 34595. LaTeX Warning: Hyper reference `astFindFrame' on page 571 undefined on input li ne 34595. LaTeX Warning: Hyper reference `astConvert' on page 571 undefined on input line 34595. LaTeX Warning: Hyper reference `SideBand' on page 571 undefined on input line 3 4595. LaTeX Warning: Hyper reference `Mapping' on page 571 undefined on input line 34 595. LaTeX Warning: Hyper reference `SpecFrame' on page 571 undefined on input line 34595. LaTeX Warning: Hyper reference `System' on page 571 undefined on input line 345 95. LaTeX Warning: Hyper reference `StdOfRest' on page 571 undefined on input line 34595. [571] LaTeX Warning: Hyper reference `SpecFrame' on page 572 undefined on input line 34625. LaTeX Warning: Hyper reference `astFindFrame' on page 572 undefined on input li ne 34625. LaTeX Warning: Hyper reference `astConvert' on page 572 undefined on input line 34625. [572] LaTeX Warning: Hyper reference `SpecFrame' on page 573 undefined on input line 34680. LaTeX Warning: Hyper reference `astFindFrame' on page 573 undefined on input li ne 34680. LaTeX Warning: Hyper reference `astConvert' on page 573 undefined on input line 34680. LaTeX Warning: Hyper reference `StdOfRest' on page 573 undefined on input line 34680. LaTeX Warning: Hyper reference `Mapping' on page 573 undefined on input line 34 680. LaTeX Warning: Hyper reference `AlignSystem' on page 573 undefined on input lin e 34680. LaTeX Warning: Hyper reference `Epoch' on page 573 undefined on input line 3468 0. LaTeX Warning: Hyper reference `ObsLat' on page 573 undefined on input line 346 80. LaTeX Warning: Hyper reference `ObsLon' on page 573 undefined on input line 346 80. LaTeX Warning: Hyper reference `ObsAlt' on page 573 undefined on input line 346 80. LaTeX Warning: Hyper reference `RefDec' on page 573 undefined on input line 346 80. LaTeX Warning: Hyper reference `RefRA' on page 573 undefined on input line 3468 0. [573] LaTeX Warning: Hyper reference `Frame' on page 574 undefined on input line 3474 5. LaTeX Warning: Hyper reference `astFindFrame' on page 574 undefined on input li ne 34745. LaTeX Warning: Hyper reference `astConvert' on page 574 undefined on input line 34745. LaTeX Warning: Hyper reference `System' on page 574 undefined on input line 347 45. LaTeX Warning: Hyper reference `Mapping' on page 574 undefined on input line 34 745. LaTeX Warning: Hyper reference `CmpFrame' on page 574 undefined on input line 3 4745. LaTeX Warning: Hyper reference `FrameSet' on page 574 undefined on input line 3 4745. LaTeX Warning: Hyper reference `Current' on page 574 undefined on input line 34 745. LaTeX Warning: Hyper reference `SkyFrame' on page 574 undefined on input line 3 4745. LaTeX Warning: Hyper reference `SpecFrame' on page 574 undefined on input line 34745. LaTeX Warning: Hyper reference `TimeFrame' on page 574 undefined on input line 34745. [574] LaTeX Warning: Hyper reference `TimeFrame' on page 575 undefined on input line 34796. LaTeX Warning: Hyper reference `astFindFrame' on page 575 undefined on input li ne 34796. LaTeX Warning: Hyper reference `astConvert' on page 575 undefined on input line 34796. LaTeX Warning: Hyper reference `TimeScale' on page 575 undefined on input line 34796. LaTeX Warning: Hyper reference `Mapping' on page 575 undefined on input line 34 796. LaTeX Warning: Hyper reference `AlignSystem' on page 575 undefined on input lin e 34796. [575] LaTeX Warning: Hyper reference `Frame' on page 576 undefined on input line 3481 9. LaTeX Warning: Hyper reference `Variant' on page 576 undefined on input line 34 819. LaTeX Warning: Hyper reference `Domain' on page 576 undefined on input line 348 19. LaTeX Warning: Hyper reference `FrameSet' on page 576 undefined on input line 3 4819. [576] LaTeX Warning: Hyper reference `Warnings' on page 577 undefined on input line 3 4953. LaTeX Warning: Hyper reference `FitsChan' on page 577 undefined on input line 3 4953. LaTeX Warning: Hyper reference `FrameSet' on page 577 undefined on input line 3 4953. LaTeX Warning: Hyper reference `PVi_m' on page 577 undefined on input line 3495 3. LaTeX Warning: Hyper reference `astRead' on page 577 undefined on input line 34 953. [577] [578] LaTeX Warning: Hyper reference `astFormat' on page 579 undefined on input line 35002. LaTeX Warning: Hyper reference `SkyFrame' on page 579 undefined on input line 3 5002. LaTeX Warning: Hyper reference `System' on page 579 undefined on input line 350 02. LaTeX Warning: Hyper reference `Format(axis)' on page 579 undefined on input li ne 35002. LaTeX Warning: Hyper reference `Unit(axis)' on page 579 undefined on input line 35002. [579] LaTeX Warning: Hyper reference `Frame' on page 580 undefined on input line 3504 0. LaTeX Warning: Hyper reference `FrameSet' on page 580 undefined on input line 3 5040. LaTeX Warning: Hyper reference `Domain' on page 580 undefined on input line 350 40. LaTeX Warning: Hyper reference `Invert' on page 580 undefined on input line 350 40. LaTeX Warning: Hyper reference `astInvert' on page 580 undefined on input line 35040. LaTeX Warning: Hyper reference `Current' on page 580 undefined on input line 35 040. [580] LaTeX Warning: Hyper reference `astGrid' on page 581 undefined on input line 35 071. LaTeX Warning: Hyper reference `Plot' on page 581 undefined on input line 35071 . LaTeX Warning: Hyper reference `astBorder' on page 581 undefined on input line 35071. LaTeX Warning: Hyper reference `Labelling' on page 581 undefined on input line 35071. [581] LaTeX Warning: Hyper reference `astGrid' on page 582 undefined on input line 35 108. LaTeX Warning: Hyper reference `Frame' on page 582 undefined on input line 3510 8. LaTeX Warning: Hyper reference `SkyFrame' on page 582 undefined on input line 3 5108. [582] LaTeX Warning: Hyper reference `Region' on page 583 undefined on input line 351 29. [583] LaTeX Warning: Hyper reference `FitsChan' on page 584 undefined on input line 3 5178. LaTeX Warning: Hyper reference `FrameSet' on page 584 undefined on input line 3 5178. LaTeX Warning: Hyper reference `Encoding' on page 584 undefined on input line 3 5178. [584] LaTeX Warning: Hyper reference `FrameSet' on page 585 undefined on input line 3 5215. LaTeX Warning: Hyper reference `Mapping' on page 585 undefined on input line 35 215. LaTeX Warning: Hyper reference `FitsChan' on page 585 undefined on input line 3 5215. [585] LaTeX Warning: Hyper reference `FitsChan' on page 586 undefined on input line 3 5252. LaTeX Warning: Hyper reference `astDelFits' on page 586 undefined on input line 35252. LaTeX Warning: Hyper reference `astFindFits' on page 586 undefined on input lin e 35252. LaTeX Warning: Hyper reference `astPutFits' on page 586 undefined on input line 35252. LaTeX Warning: Hyper reference `astClear' on page 586 undefined on input line 3 5252. LaTeX Warning: Hyper reference `Ncard' on page 586 undefined on input line 3525 2. [586] LaTeX Warning: Hyper reference `FitsChan' on page 587 undefined on input line 3 5272. [587] LaTeX Warning: Hyper reference `FitsChan' on page 588 undefined on input line 3 5292. [588] LaTeX Warning: Hyper reference `FitsChan' on page 589 undefined on input line 3 5315. Overfull \hbox (37.49187pt too wide) in paragraph at lines 35315--35315 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [589] LaTeX Warning: Hyper reference `Object' on page 590 undefined on input line 353 35. [590] LaTeX Warning: Hyper reference `FitsChan' on page 591 undefined on input line 3 5368. LaTeX Warning: Hyper reference `astRead' on page 591 undefined on input line 35 368. LaTeX Warning: Hyper reference `Object' on page 591 undefined on input line 353 68. [591] LaTeX Warning: Hyper reference `Plot' on page 592 undefined on input line 35401 . LaTeX Warning: Hyper reference `astClip' on page 592 undefined on input line 35 401. [592] LaTeX Warning: Hyper reference `Plot' on page 593 undefined on input line 35436 . LaTeX Warning: Hyper reference `astClip' on page 593 undefined on input line 35 436. LaTeX Warning: Hyper reference `Frame' on page 593 undefined on input line 3543 6. [593] LaTeX Warning: Hyper reference `Region' on page 594 undefined on input line 354 81. LaTeX Warning: Hyper reference `PointList' on page 594 undefined on input line 35481. LaTeX Warning: Hyper reference `CmpRegion' on page 594 undefined on input line 35481. LaTeX Warning: Hyper reference `Stc' on page 594 undefined on input line 35481. [594] LaTeX Warning: Hyper reference `Plot' on page 595 undefined on input line 35526 . [595] LaTeX Warning: Hyper reference `Table' on page 596 undefined on input line 3556 1. [596] LaTeX Warning: Hyper reference `Table' on page 597 undefined on input line 3558 4. [597] LaTeX Warning: Hyper reference `Table' on page 598 undefined on input line 3560 8. [598] LaTeX Warning: Hyper reference `Table' on page 599 undefined on input line 3564 4. LaTeX Warning: Hyper reference `astAddColumn' on page 599 undefined on input li ne 35644. LaTeX Warning: Hyper reference `Object' on page 599 undefined on input line 356 44. LaTeX Warning: Hyper reference `astMapPutU' on page 599 undefined on input line 35644. [599] LaTeX Warning: Hyper reference `Channel' on page 600 undefined on input line 35 679. LaTeX Warning: Hyper reference `FitsChan' on page 600 undefined on input line 3 5679. LaTeX Warning: Hyper reference `XmlChan' on page 600 undefined on input line 35 679. [600] LaTeX Warning: Hyper reference `Frame' on page 601 undefined on input line 3571 7. LaTeX Warning: Hyper reference `FrameSet' on page 601 undefined on input line 3 5717. LaTeX Warning: Hyper reference `Nframe' on page 601 undefined on input line 357 17. LaTeX Warning: Hyper reference `Domain' on page 601 undefined on input line 357 17. LaTeX Warning: Hyper reference `Invert' on page 601 undefined on input line 357 17. LaTeX Warning: Hyper reference `astInvert' on page 601 undefined on input line 35717. LaTeX Warning: Hyper reference `Base' on page 601 undefined on input line 35717 . [601] LaTeX Warning: Hyper reference `IF' on page 602 undefined on input line 35771. LaTeX Warning: Hyper reference `SpecFrame' on page 602 undefined on input line 35771. LaTeX Warning: Hyper reference `System' on page 602 undefined on input line 357 71. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 602 undefined on input li ne 35771. LaTeX Warning: Hyper reference `StdOfRest' on page 602 undefined on input line 35771. LaTeX Warning: Hyper reference `ObsLon' on page 602 undefined on input line 357 71. LaTeX Warning: Hyper reference `ObsLat' on page 602 undefined on input line 357 71. LaTeX Warning: Hyper reference `ObsAlt' on page 602 undefined on input line 357 71. LaTeX Warning: Hyper reference `Epoch' on page 602 undefined on input line 3577 1. LaTeX Warning: Hyper reference `RefRA' on page 602 undefined on input line 3577 1. LaTeX Warning: Hyper reference `RefDec' on page 602 undefined on input line 357 71. LaTeX Warning: Hyper reference `RestFreq' on page 602 undefined on input line 3 5771. [602] LaTeX Warning: Hyper reference `FrameSet' on page 603 undefined on input line 3 5798. LaTeX Warning: Hyper reference `FitsChan' on page 603 undefined on input line 3 5798. LaTeX Warning: Hyper reference `Encoding' on page 603 undefined on input line 3 5798. [603] LaTeX Warning: Hyper reference `Frame' on page 604 undefined on input line 3585 1. LaTeX Warning: Hyper reference `astFormat' on page 604 undefined on input line 35851. LaTeX Warning: Hyper reference `FrameSet' on page 604 undefined on input line 3 5851. LaTeX Warning: Hyper reference `Current' on page 604 undefined on input line 35 851. LaTeX Warning: Hyper reference `Plot' on page 604 undefined on input line 35851 . LaTeX Warning: Hyper reference `TimeFrame' on page 604 undefined on input line 35851. [604] LaTeX Warning: Hyper reference `Frame' on page 605 undefined on input line 3591 6. LaTeX Warning: Hyper reference `SkyFrame' on page 605 undefined on input line 3 5916. LaTeX Warning: Hyper reference `FrameSet' on page 605 undefined on input line 3 5916. LaTeX Warning: Hyper reference `Current' on page 605 undefined on input line 35 916. LaTeX Warning: Hyper reference `Plot' on page 605 undefined on input line 35916 . [605] LaTeX Warning: Hyper reference `PcdMap' on page 606 undefined on input line 359 55. LaTeX Warning: Hyper reference `astInvert' on page 606 undefined on input line 35955. LaTeX Warning: Hyper reference `CmpMap' on page 606 undefined on input line 359 55. LaTeX Warning: Hyper reference `FrameSet' on page 606 undefined on input line 3 5955. LaTeX Warning: Hyper reference `astClone' on page 606 undefined on input line 3 5955. [606] LaTeX Warning: Hyper reference `Frame' on page 607 undefined on input line 3604 3. LaTeX Warning: Hyper reference `astFindFrame' on page 607 undefined on input li ne 36043. LaTeX Warning: Hyper reference `SkyFrame' on page 607 undefined on input line 3 6043. LaTeX Warning: Hyper reference `CmpFrame' on page 607 undefined on input line 3 6043. LaTeX Warning: Hyper reference `FrameSet' on page 607 undefined on input line 3 6043. LaTeX Warning: Hyper reference `Current' on page 607 undefined on input line 36 043. LaTeX Warning: Hyper reference `SpecFrame' on page 607 undefined on input line 36043. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 607 undefined on input li ne 36043. LaTeX Warning: Hyper reference `FluxFrame' on page 607 undefined on input line 36043. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 607 undefined on input l ine 36043. LaTeX Warning: Hyper reference `TimeFrame' on page 607 undefined on input line 36043. [607] LaTeX Warning: Hyper reference `astGrid' on page 608 undefined on input line 36 096. LaTeX Warning: Hyper reference `Plot' on page 608 undefined on input line 36096 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 608 undefined on input l ine 36096. LaTeX Warning: Hyper reference `Axis' on page 608 undefined on input line 36096 . LaTeX Warning: Hyper reference `Grid' on page 608 undefined on input line 36096 . LaTeX Warning: Hyper reference `Labelling' on page 608 undefined on input line 36096. [608] LaTeX Warning: Hyper reference `astGrid' on page 609 undefined on input line 36 138. LaTeX Warning: Hyper reference `Plot' on page 609 undefined on input line 36138 . LaTeX Warning: Hyper reference `Plot3D' on page 609 undefined on input line 361 38. LaTeX Warning: Hyper reference `Title' on page 609 undefined on input line 3613 8. LaTeX Warning: Hyper reference `TitleGap' on page 609 undefined on input line 3 6138. [609] LaTeX Warning: Hyper reference `Frame' on page 610 undefined on input line 3616 5. LaTeX Warning: Hyper reference `Epoch' on page 610 undefined on input line 3616 5. [610] LaTeX Warning: Hyper reference `SkyFrame' on page 611 undefined on input line 3 6201. LaTeX Warning: Hyper reference `Epoch' on page 611 undefined on input line 3620 1. LaTeX Warning: Hyper reference `Frame' on page 611 undefined on input line 3620 1. [611] LaTeX Warning: Hyper reference `astGrid' on page 612 undefined on input line 36 253. LaTeX Warning: Hyper reference `Plot' on page 612 undefined on input line 36253 . LaTeX Warning: Hyper reference `Labelling' on page 612 undefined on input line 36253. LaTeX Warning: Hyper reference `Plot3D' on page 612 undefined on input line 362 53. LaTeX Warning: Hyper reference `RootCorner' on page 612 undefined on input line 36253. [612] LaTeX Warning: Hyper reference `FitsChan' on page 613 undefined on input line 3 6876. LaTeX Warning: Hyper reference `astWrite' on page 613 undefined on input line 3 6876. LaTeX Warning: Hyper reference `astRead' on page 613 undefined on input line 36 876. LaTeX Warning: Hyper reference `Object' on page 613 undefined on input line 368 76. LaTeX Warning: Hyper reference `Channel' on page 613 undefined on input line 36 876. [613] [614] LaTeX Warning: Hyper reference `FrameSet' on page 615 undefined on input line 3 6876. LaTeX Warning: Hyper reference `Mapping' on page 615 undefined on input line 36 876. LaTeX Warning: Hyper reference `DssMap' on page 615 undefined on input line 368 76. LaTeX Warning: Hyper reference `WcsMap' on page 615 undefined on input line 368 76. LaTeX Warning: Hyper reference `Card' on page 615 undefined on input line 36876 . LaTeX Warning: Hyper reference `Frame' on page 615 undefined on input line 3687 6. LaTeX Warning: Hyper reference `SkyFrame' on page 615 undefined on input line 3 6876. [615] LaTeX Warning: Hyper reference `CDMatrix' on page 616 undefined on input line 3 6876. LaTeX Warning: Hyper reference `PVi_m' on page 616 undefined on input line 3687 6. LaTeX Warning: Hyper reference `SkyRefIs' on page 616 undefined on input line 3 6876. LaTeX Warning: Hyper reference `System' on page 616 undefined on input line 368 76. [616] [617] LaTeX Warning: Hyper reference `SpecFrame' on page 618 undefined on input line 36876. LaTeX Warning: Hyper reference `ObsLat' on page 618 undefined on input line 368 76. LaTeX Warning: Hyper reference `ObsLon' on page 618 undefined on input line 368 76. LaTeX Warning: Hyper reference `ObsAlt' on page 618 undefined on input line 368 76. [618] LaTeX Warning: Hyper reference `SourceVel' on page 619 undefined on input line 36876. LaTeX Warning: Hyper reference `SourceVRF' on page 619 undefined on input line 36876. LaTeX Warning: Hyper reference `Class' on page 619 undefined on input line 3687 6. LaTeX Warning: Hyper reference `ID' on page 619 undefined on input line 36876. [619] LaTeX Warning: Hyper reference `Frame' on page 620 undefined on input line 3702 4. LaTeX Warning: Hyper reference `System' on page 620 undefined on input line 370 24. LaTeX Warning: Hyper reference `CmpFrame' on page 620 undefined on input line 3 7024. LaTeX Warning: Hyper reference `FrameSet' on page 620 undefined on input line 3 7024. LaTeX Warning: Hyper reference `Current' on page 620 undefined on input line 37 024. LaTeX Warning: Hyper reference `SkyFrame' on page 620 undefined on input line 3 7024. LaTeX Warning: Hyper reference `Equinox' on page 620 undefined on input line 37 024. LaTeX Warning: Hyper reference `TimeFrame' on page 620 undefined on input line 37024. LaTeX Warning: Hyper reference `TimeOrigin' on page 620 undefined on input line 37024. [620] [621] LaTeX Warning: Hyper reference `SkyFrame' on page 622 undefined on input line 3 7091. LaTeX Warning: Hyper reference `Epoch' on page 622 undefined on input line 3709 1. LaTeX Warning: Hyper reference `System' on page 622 undefined on input line 370 91. [622] LaTeX Warning: Hyper reference `astGrid' on page 623 undefined on input line 37 198. LaTeX Warning: Hyper reference `Plot' on page 623 undefined on input line 37198 . LaTeX Warning: Hyper reference `astText' on page 623 undefined on input line 37 198. LaTeX Warning: Hyper reference `Plot3D' on page 623 undefined on input line 371 98. LaTeX Warning: Hyper reference `astEscapes' on page 623 undefined on input line 37198. [623] [624] LaTeX Warning: Hyper reference `Region' on page 625 undefined on input line 372 41. LaTeX Warning: Hyper reference `CmpRegion' on page 625 undefined on input line 37241. LaTeX Warning: Hyper reference `Prism' on page 625 undefined on input line 3724 1. LaTeX Warning: Hyper reference `Stc' on page 625 undefined on input line 37241. [625] LaTeX Warning: Hyper reference `astWrite' on page 626 undefined on input line 3 7284. LaTeX Warning: Hyper reference `Frame' on page 626 undefined on input line 3728 4. LaTeX Warning: Hyper reference `FrameSet' on page 626 undefined on input line 3 7284. LaTeX Warning: Hyper reference `FitsChan' on page 626 undefined on input line 3 7284. [626] LaTeX Warning: Hyper reference `FitsChan' on page 627 undefined on input line 3 7326. LaTeX Warning: Hyper reference `astFindFits' on page 627 undefined on input lin e 37326. [627] LaTeX Warning: Hyper reference `FrameSet' on page 628 undefined on input line 3 7355. LaTeX Warning: Hyper reference `FitsChan' on page 628 undefined on input line 3 7355. LaTeX Warning: Hyper reference `Mapping' on page 628 undefined on input line 37 355. [628] LaTeX Warning: Hyper reference `Plot' on page 629 undefined on input line 37399 . [629] LaTeX Warning: Hyper reference `Frame' on page 630 undefined on input line 3759 6. LaTeX Warning: Hyper reference `astFormat' on page 630 undefined on input line 37596. LaTeX Warning: Hyper reference `astSet' on page 630 undefined on input line 375 96. LaTeX Warning: Hyper reference `SkyFrame' on page 630 undefined on input line 3 7596. LaTeX Warning: Hyper reference `FrameSet' on page 630 undefined on input line 3 7596. LaTeX Warning: Hyper reference `Current' on page 630 undefined on input line 37 596. LaTeX Warning: Hyper reference `TimeFrame' on page 630 undefined on input line 37596. [630] LaTeX Warning: Hyper reference `Plot' on page 631 undefined on input line 37596 . LaTeX Warning: Hyper reference `TimeOrigin' on page 631 undefined on input line 37596. [631] [632] LaTeX Warning: Hyper reference `Channel' on page 633 undefined on input line 37 648. LaTeX Warning: Hyper reference `Object' on page 633 undefined on input line 376 48. LaTeX Warning: Hyper reference `FitsChan' on page 633 undefined on input line 3 7648. LaTeX Warning: Hyper reference `XmlChan' on page 633 undefined on input line 37 648. LaTeX Warning: Hyper reference `StcsChan' on page 633 undefined on input line 3 7648. [633] LaTeX Warning: Hyper reference `astGrid' on page 634 undefined on input line 37 700. LaTeX Warning: Hyper reference `Plot' on page 634 undefined on input line 37700 . LaTeX Warning: Hyper reference `Format(axis)' on page 634 undefined on input li ne 37700. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 634 undefined on i nput line 37700. [634] LaTeX Warning: Hyper reference `Plot' on page 635 undefined on input line 37743 . LaTeX Warning: Hyper reference `ast_link' on page 635 undefined on input line 3 7743. LaTeX Warning: Hyper reference `astGrfSet' on page 635 undefined on input line 37743. LaTeX Warning: Hyper reference `Plot3D' on page 635 undefined on input line 377 43. LaTeX Warning: Hyper reference `Channel' on page 635 undefined on input line 37 743. LaTeX Warning: Hyper reference `astRead' on page 635 undefined on input line 37 743. [635] LaTeX Warning: Hyper reference `astGrid' on page 636 undefined on input line 37 779. LaTeX Warning: Hyper reference `Plot' on page 636 undefined on input line 37779 . LaTeX Warning: Hyper reference `Gap(axis)' on page 636 undefined on input line 37779. [636] LaTeX Warning: Hyper reference `GrismMap' on page 637 undefined on input line 3 7806. LaTeX Warning: Hyper reference `CmpMap' on page 637 undefined on input line 378 06. LaTeX Warning: Hyper reference `FrameSet' on page 637 undefined on input line 3 7806. LaTeX Warning: Hyper reference `astClone' on page 637 undefined on input line 3 7806. [637] LaTeX Warning: Hyper reference `GrismMap' on page 638 undefined on input line 3 7835. LaTeX Warning: Hyper reference `CmpMap' on page 638 undefined on input line 378 35. LaTeX Warning: Hyper reference `FrameSet' on page 638 undefined on input line 3 7835. LaTeX Warning: Hyper reference `astClone' on page 638 undefined on input line 3 7835. [638] LaTeX Warning: Hyper reference `GrismWaveR' on page 639 undefined on input line 37864. LaTeX Warning: Hyper reference `GrismNRP' on page 639 undefined on input line 3 7864. LaTeX Warning: Hyper reference `GrismMap' on page 639 undefined on input line 3 7864. LaTeX Warning: Hyper reference `CmpMap' on page 639 undefined on input line 378 64. LaTeX Warning: Hyper reference `FrameSet' on page 639 undefined on input line 3 7864. LaTeX Warning: Hyper reference `astClone' on page 639 undefined on input line 3 7864. [639] LaTeX Warning: Hyper reference `GrismMap' on page 640 undefined on input line 3 7891. LaTeX Warning: Hyper reference `CmpMap' on page 640 undefined on input line 378 91. LaTeX Warning: Hyper reference `FrameSet' on page 640 undefined on input line 3 7891. LaTeX Warning: Hyper reference `astClone' on page 640 undefined on input line 3 7891. [640] LaTeX Warning: Hyper reference `GrismWaveR' on page 641 undefined on input line 37919. LaTeX Warning: Hyper reference `GrismMap' on page 641 undefined on input line 3 7919. LaTeX Warning: Hyper reference `CmpMap' on page 641 undefined on input line 379 19. LaTeX Warning: Hyper reference `FrameSet' on page 641 undefined on input line 3 7919. LaTeX Warning: Hyper reference `astClone' on page 641 undefined on input line 3 7919. [641] LaTeX Warning: Hyper reference `GrismWaveR' on page 642 undefined on input line 37950. LaTeX Warning: Hyper reference `GrismG' on page 642 undefined on input line 379 50. LaTeX Warning: Hyper reference `GrismMap' on page 642 undefined on input line 3 7950. LaTeX Warning: Hyper reference `CmpMap' on page 642 undefined on input line 379 50. LaTeX Warning: Hyper reference `FrameSet' on page 642 undefined on input line 3 7950. LaTeX Warning: Hyper reference `astClone' on page 642 undefined on input line 3 7950. [642] LaTeX Warning: Hyper reference `GrismWaveR' on page 643 undefined on input line 37980. LaTeX Warning: Hyper reference `GrismMap' on page 643 undefined on input line 3 7980. LaTeX Warning: Hyper reference `CmpMap' on page 643 undefined on input line 379 80. LaTeX Warning: Hyper reference `FrameSet' on page 643 undefined on input line 3 7980. LaTeX Warning: Hyper reference `astClone' on page 643 undefined on input line 3 7980. [643] LaTeX Warning: Hyper reference `GrismNRP' on page 644 undefined on input line 3 8008. LaTeX Warning: Hyper reference `GrismG' on page 644 undefined on input line 380 08. LaTeX Warning: Hyper reference `GrismMap' on page 644 undefined on input line 3 8008. LaTeX Warning: Hyper reference `CmpMap' on page 644 undefined on input line 380 08. LaTeX Warning: Hyper reference `FrameSet' on page 644 undefined on input line 3 8008. LaTeX Warning: Hyper reference `astClone' on page 644 undefined on input line 3 8008. [644] LaTeX Warning: Hyper reference `Object' on page 645 undefined on input line 380 51. LaTeX Warning: Hyper reference `astWrite' on page 645 undefined on input line 3 8051. LaTeX Warning: Hyper reference `astRead' on page 645 undefined on input line 38 051. LaTeX Warning: Hyper reference `astShow' on page 645 undefined on input line 38 051. [645] LaTeX Warning: Hyper reference `DSBCentre' on page 646 undefined on input line 38092. LaTeX Warning: Hyper reference `SideBand' on page 646 undefined on input line 3 8092. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 646 undefined on input li ne 38092. [646] LaTeX Warning: Hyper reference `ID' on page 647 undefined on input line 38114. LaTeX Warning: Hyper reference `Object' on page 647 undefined on input line 381 14. [647] LaTeX Warning: Hyper reference `RestFreq' on page 648 undefined on input line 3 8145. LaTeX Warning: Hyper reference `SourceVel' on page 648 undefined on input line 38145. LaTeX Warning: Hyper reference `SourceVRF' on page 648 undefined on input line 38145. LaTeX Warning: Hyper reference `DSBCentre' on page 648 undefined on input line 38145. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 648 undefined on input li ne 38145. [648] LaTeX Warning: Hyper reference `astWrite' on page 649 undefined on input line 3 8216. LaTeX Warning: Hyper reference `Channel' on page 649 undefined on input line 38 216. LaTeX Warning: Hyper reference `FitsChan' on page 649 undefined on input line 3 8216. LaTeX Warning: Hyper reference `StcsChan' on page 649 undefined on input line 3 8216. LaTeX Warning: Hyper reference `StcsLength' on page 649 undefined on input line 38216. LaTeX Warning: Hyper reference `XmlChan' on page 649 undefined on input line 38 216. [649] LaTeX Warning: Hyper reference `Frame' on page 650 undefined on input line 3825 2. LaTeX Warning: Hyper reference `SkyFrame' on page 650 undefined on input line 3 8252. [650] LaTeX Warning: Hyper reference `IntraMap' on page 651 undefined on input line 3 8294. LaTeX Warning: Hyper reference `UnitMap' on page 651 undefined on input line 38 294. LaTeX Warning: Hyper reference `astSimplify' on page 651 undefined on input lin e 38294. [651] LaTeX Warning: Hyper reference `Mapping' on page 652 undefined on input line 38 343. LaTeX Warning: Hyper reference `Nin' on page 652 undefined on input line 38343. LaTeX Warning: Hyper reference `Nout' on page 652 undefined on input line 38343 . LaTeX Warning: Hyper reference `TranForward' on page 652 undefined on input lin e 38343. LaTeX Warning: Hyper reference `TranInverse' on page 652 undefined on input lin e 38343. LaTeX Warning: Hyper reference `astInvert' on page 652 undefined on input line 38343. LaTeX Warning: Hyper reference `UnitMap' on page 652 undefined on input line 38 343. LaTeX Warning: Hyper reference `FrameSet' on page 652 undefined on input line 3 8343. LaTeX Warning: Hyper reference `Base' on page 652 undefined on input line 38343 . LaTeX Warning: Hyper reference `Current' on page 652 undefined on input line 38 343. LaTeX Warning: Hyper reference `Naxes' on page 652 undefined on input line 3834 3. LaTeX Warning: Hyper reference `Frame' on page 652 undefined on input line 3834 3. [652] LaTeX Warning: Hyper reference `Plot' on page 653 undefined on input line 38373 . LaTeX Warning: Hyper reference `astBoundingBox' on page 653 undefined on input line 38373. [653] LaTeX Warning: Hyper reference `SkyFrame' on page 654 undefined on input line 3 8403. [654] LaTeX Warning: Hyper reference `Mapping' on page 655 undefined on input line 38 450. LaTeX Warning: Hyper reference `MathMap' on page 655 undefined on input line 38 450. LaTeX Warning: Hyper reference `astLinearApprox' on page 655 undefined on input line 38450. LaTeX Warning: Hyper reference `CmpMap' on page 655 undefined on input line 384 50. LaTeX Warning: Hyper reference `ZoomMap' on page 655 undefined on input line 38 450. LaTeX Warning: Hyper reference `ShiftMap' on page 655 undefined on input line 3 8450. LaTeX Warning: Hyper reference `Frame' on page 655 undefined on input line 3845 0. LaTeX Warning: Hyper reference `UnitMap' on page 655 undefined on input line 38 450. LaTeX Warning: Hyper reference `FrameSet' on page 655 undefined on input line 3 8450. [655] LaTeX Warning: Hyper reference `SkyFrame' on page 656 undefined on input line 3 8480. [656] LaTeX Warning: Hyper reference `Mapping' on page 657 undefined on input line 38 518. LaTeX Warning: Hyper reference `astSimplify' on page 657 undefined on input lin e 38518. LaTeX Warning: Hyper reference `Frame' on page 657 undefined on input line 3851 8. [657] LaTeX Warning: Hyper reference `PolyMap' on page 658 undefined on input line 38 598. LaTeX Warning: Hyper reference `NiterInverse' on page 658 undefined on input li ne 38598. LaTeX Warning: Hyper reference `TolInverse' on page 658 undefined on input line 38598. LaTeX Warning: Hyper reference `ChebyMap' on page 658 undefined on input line 3 8598. LaTeX Warning: Hyper reference `Nin' on page 658 undefined on input line 38598. LaTeX Warning: Hyper reference `Nout' on page 658 undefined on input line 38598 . [658] LaTeX Warning: Hyper reference `FrameSet' on page 659 undefined on input line 3 8633. LaTeX Warning: Hyper reference `FitsChan' on page 659 undefined on input line 3 8633. LaTeX Warning: Hyper reference `astRead' on page 659 undefined on input line 38 633. LaTeX Warning: Hyper reference `Domain' on page 659 undefined on input line 386 33. [659] LaTeX Warning: Hyper reference `KeyMap' on page 660 undefined on input line 386 67. LaTeX Warning: Hyper reference `Table' on page 660 undefined on input line 3866 7. [660] LaTeX Warning: Hyper reference `KeyMap' on page 661 undefined on input line 387 04. [661] LaTeX Warning: Hyper reference `TimeFrame' on page 662 undefined on input line 38726. [662] LaTeX Warning: Hyper reference `Frame' on page 663 undefined on input line 3878 3. LaTeX Warning: Hyper reference `Axis' on page 663 undefined on input line 38783 . LaTeX Warning: Hyper reference `SkyFrame' on page 663 undefined on input line 3 8783. LaTeX Warning: Hyper reference `TimeFrame' on page 663 undefined on input line 38783. LaTeX Warning: Hyper reference `FrameSet' on page 663 undefined on input line 3 8783. LaTeX Warning: Hyper reference `Current' on page 663 undefined on input line 38 783. [663] LaTeX Warning: Hyper reference `astGrid' on page 664 undefined on input line 38 842. LaTeX Warning: Hyper reference `Plot' on page 664 undefined on input line 38842 . LaTeX Warning: Hyper reference `Labelling' on page 664 undefined on input line 38842. [664] LaTeX Warning: Hyper reference `astGrid' on page 665 undefined on input line 38 895. LaTeX Warning: Hyper reference `Plot' on page 665 undefined on input line 38895 . LaTeX Warning: Hyper reference `Frame' on page 665 undefined on input line 3889 5. LaTeX Warning: Hyper reference `SkyFrame' on page 665 undefined on input line 3 8895. LaTeX Warning: Hyper reference `Unit(axis)' on page 665 undefined on input line 38895. [665] LaTeX Warning: Hyper reference `astGrid' on page 666 undefined on input line 38 946. LaTeX Warning: Hyper reference `Plot' on page 666 undefined on input line 38946 . LaTeX Warning: Hyper reference `Labelling' on page 666 undefined on input line 38946. [666] LaTeX Warning: Hyper reference `astGrid' on page 667 undefined on input line 38 982. LaTeX Warning: Hyper reference `Plot' on page 667 undefined on input line 38982 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 667 undefined on input l ine 38982. [667] LaTeX Warning: Hyper reference `SkyFrame' on page 668 undefined on input line 3 9003. [668] LaTeX Warning: Hyper reference `PointList' on page 669 undefined on input line 39023. [669] LaTeX Warning: Hyper reference `astGrid' on page 670 undefined on input line 39 072. LaTeX Warning: Hyper reference `Plot' on page 670 undefined on input line 39072 . [670] LaTeX Warning: Hyper reference `astGrid' on page 671 undefined on input line 39 113. LaTeX Warning: Hyper reference `Escape' on page 671 undefined on input line 391 13. LaTeX Warning: Hyper reference `Plot' on page 671 undefined on input line 39113 . [671] LaTeX Warning: Hyper reference `Plot' on page 672 undefined on input line 39171 . LaTeX Warning: Hyper reference `Frame' on page 672 undefined on input line 3917 1. LaTeX Warning: Hyper reference `FrameSet' on page 672 undefined on input line 3 9171. [672] LaTeX Warning: Hyper reference `astGrid' on page 673 undefined on input line 39 230. LaTeX Warning: Hyper reference `Plot' on page 673 undefined on input line 39230 . [673] LaTeX Warning: Hyper reference `SkyFrame' on page 674 undefined on input line 3 9251. [674] LaTeX Warning: Hyper reference `LutMap' on page 675 undefined on input line 392 86. LaTeX Warning: Hyper reference `WinMap' on page 675 undefined on input line 392 86. LaTeX Warning: Hyper reference `Mapping' on page 675 undefined on input line 39 286. LaTeX Warning: Hyper reference `CmpMap' on page 675 undefined on input line 392 86. LaTeX Warning: Hyper reference `FrameSet' on page 675 undefined on input line 3 9286. LaTeX Warning: Hyper reference `astClone' on page 675 undefined on input line 3 9286. [675] LaTeX Warning: Hyper reference `LutMap' on page 676 undefined on input line 393 21. LaTeX Warning: Hyper reference `CmpMap' on page 676 undefined on input line 393 21. LaTeX Warning: Hyper reference `FrameSet' on page 676 undefined on input line 3 9321. LaTeX Warning: Hyper reference `astClone' on page 676 undefined on input line 3 9321. [676] LaTeX Warning: Hyper reference `astGrid' on page 677 undefined on input line 39 367. LaTeX Warning: Hyper reference `Plot' on page 677 undefined on input line 39367 . LaTeX Warning: Hyper reference `Grid' on page 677 undefined on input line 39367 . [677] LaTeX Warning: Hyper reference `KeyMap' on page 678 undefined on input line 394 05. [678] LaTeX Warning: Hyper reference `Frame' on page 679 undefined on input line 3944 2. LaTeX Warning: Hyper reference `astFindFrame' on page 679 undefined on input li ne 39442. LaTeX Warning: Hyper reference `FrameSet' on page 679 undefined on input line 3 9442. LaTeX Warning: Hyper reference `Current' on page 679 undefined on input line 39 442. [679] LaTeX Warning: Hyper reference `Frame' on page 680 undefined on input line 3950 6. LaTeX Warning: Hyper reference `astFindFrame' on page 680 undefined on input li ne 39506. LaTeX Warning: Hyper reference `Naxes' on page 680 undefined on input line 3950 6. LaTeX Warning: Hyper reference `CmpFrame' on page 680 undefined on input line 3 9506. LaTeX Warning: Hyper reference `MinAxes' on page 680 undefined on input line 39 506. LaTeX Warning: Hyper reference `FrameSet' on page 680 undefined on input line 3 9506. LaTeX Warning: Hyper reference `Current' on page 680 undefined on input line 39 506. LaTeX Warning: Hyper reference `MatchEnd' on page 680 undefined on input line 3 9506. [680] LaTeX Warning: Hyper reference `Region' on page 681 undefined on input line 395 51. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 681 undefined on inpu t line 39551. LaTeX Warning: Hyper reference `CmpRegion' on page 681 undefined on input line 39551. LaTeX Warning: Hyper reference `Stc' on page 681 undefined on input line 39551. [681] LaTeX Warning: Hyper reference `Frame' on page 682 undefined on input line 3961 3. LaTeX Warning: Hyper reference `astFindFrame' on page 682 undefined on input li ne 39613. LaTeX Warning: Hyper reference `Naxes' on page 682 undefined on input line 3961 3. LaTeX Warning: Hyper reference `CmpFrame' on page 682 undefined on input line 3 9613. LaTeX Warning: Hyper reference `MaxAxes' on page 682 undefined on input line 39 613. LaTeX Warning: Hyper reference `FrameSet' on page 682 undefined on input line 3 9613. LaTeX Warning: Hyper reference `Current' on page 682 undefined on input line 39 613. LaTeX Warning: Hyper reference `MatchEnd' on page 682 undefined on input line 3 9613. [682] LaTeX Warning: Hyper reference `astGrid' on page 683 undefined on input line 39 654. LaTeX Warning: Hyper reference `Plot' on page 683 undefined on input line 39654 . [683] LaTeX Warning: Hyper reference `astGrid' on page 684 undefined on input line 39 701. LaTeX Warning: Hyper reference `Plot' on page 684 undefined on input line 39701 . LaTeX Warning: Hyper reference `MinTick(axis)' on page 684 undefined on input l ine 39701. [684] LaTeX Warning: Hyper reference `WcsMap' on page 685 undefined on input line 397 47. LaTeX Warning: Hyper reference `NatLon' on page 685 undefined on input line 397 47. [685] LaTeX Warning: Hyper reference `WcsMap' on page 686 undefined on input line 397 72. LaTeX Warning: Hyper reference `NatLat' on page 686 undefined on input line 397 72. [686] LaTeX Warning: Hyper reference `Frame' on page 687 undefined on input line 3980 6. LaTeX Warning: Hyper reference `FrameSet' on page 687 undefined on input line 3 9806. LaTeX Warning: Hyper reference `Current' on page 687 undefined on input line 39 806. LaTeX Warning: Hyper reference `CmpFrame' on page 687 undefined on input line 3 9806. [687] LaTeX Warning: Hyper reference `FitsChan' on page 688 undefined on input line 3 9827. [688] LaTeX Warning: Hyper reference `astAddColumn' on page 689 undefined on input li ne 39849. LaTeX Warning: Hyper reference `astRemoveColumn' on page 689 undefined on input line 39849. LaTeX Warning: Hyper reference `Table' on page 689 undefined on input line 3984 9. [689] LaTeX Warning: Hyper reference `astNorm' on page 690 undefined on input line 39 878. LaTeX Warning: Hyper reference `SkyRefIs' on page 690 undefined on input line 3 9878. LaTeX Warning: Hyper reference `SkyFrame' on page 690 undefined on input line 3 9878. [690] LaTeX Warning: Hyper reference `Region' on page 691 undefined on input line 399 09. LaTeX Warning: Hyper reference `astNegate' on page 691 undefined on input line 39909. LaTeX Warning: Hyper reference `Closed' on page 691 undefined on input line 399 09. [691] LaTeX Warning: Hyper reference `FrameSet' on page 692 undefined on input line 3 9930. [692] LaTeX Warning: Hyper reference `Mapping' on page 693 undefined on input line 39 979. LaTeX Warning: Hyper reference `CmpMap' on page 693 undefined on input line 399 79. LaTeX Warning: Hyper reference `Nout' on page 693 undefined on input line 39979 . LaTeX Warning: Hyper reference `Invert' on page 693 undefined on input line 399 79. LaTeX Warning: Hyper reference `Frame' on page 693 undefined on input line 3997 9. LaTeX Warning: Hyper reference `Naxes' on page 693 undefined on input line 3997 9. LaTeX Warning: Hyper reference `FrameSet' on page 693 undefined on input line 3 9979. LaTeX Warning: Hyper reference `Base' on page 693 undefined on input line 39979 . [693] LaTeX Warning: Hyper reference `IterInverse' on page 694 undefined on input lin e 40003. LaTeX Warning: Hyper reference `TolInverse' on page 694 undefined on input line 40003. LaTeX Warning: Hyper reference `PolyMap' on page 694 undefined on input line 40 003. [694] LaTeX Warning: Hyper reference `FitsChan' on page 695 undefined on input line 4 0027. LaTeX Warning: Hyper reference `Ncard' on page 695 undefined on input line 4002 7. [695] LaTeX Warning: Hyper reference `Object' on page 696 undefined on input line 400 53. [696] LaTeX Warning: Hyper reference `Plot3D' on page 697 undefined on input line 400 88. LaTeX Warning: Hyper reference `astText' on page 697 undefined on input line 40 088. LaTeX Warning: Hyper reference `astMark' on page 697 undefined on input line 40 088. LaTeX Warning: Hyper reference `Plot' on page 697 undefined on input line 40088 . [697] LaTeX Warning: Hyper reference `Frame' on page 698 undefined on input line 4012 1. [698] LaTeX Warning: Hyper reference `Mapping' on page 699 undefined on input line 40 171. LaTeX Warning: Hyper reference `CmpMap' on page 699 undefined on input line 401 71. LaTeX Warning: Hyper reference `Nin' on page 699 undefined on input line 40171. LaTeX Warning: Hyper reference `Invert' on page 699 undefined on input line 401 71. LaTeX Warning: Hyper reference `Frame' on page 699 undefined on input line 4017 1. LaTeX Warning: Hyper reference `Naxes' on page 699 undefined on input line 4017 1. LaTeX Warning: Hyper reference `FrameSet' on page 699 undefined on input line 4 0171. LaTeX Warning: Hyper reference `Current' on page 699 undefined on input line 40 171. [699] LaTeX Warning: Hyper reference `astAddParameter' on page 700 undefined on input line 40193. LaTeX Warning: Hyper reference `astRemoveParameter' on page 700 undefined on in put line 40193. LaTeX Warning: Hyper reference `Table' on page 700 undefined on input line 4019 3. [700] LaTeX Warning: Hyper reference `Table' on page 701 undefined on input line 4021 6. [701] LaTeX Warning: Hyper reference `astGrid' on page 702 undefined on input line 40 260. LaTeX Warning: Hyper reference `Plot' on page 702 undefined on input line 40260 . LaTeX Warning: Hyper reference `TextLab(axis)' on page 702 undefined on input l ine 40260. [702] LaTeX Warning: Hyper reference `astGrid' on page 703 undefined on input line 40 305. LaTeX Warning: Hyper reference `Plot' on page 703 undefined on input line 40305 . [703] LaTeX Warning: Hyper reference `Object' on page 704 undefined on input line 403 26. [704] LaTeX Warning: Hyper reference `Frame' on page 705 undefined on input line 4036 5. LaTeX Warning: Hyper reference `SpecFrame' on page 705 undefined on input line 40365. LaTeX Warning: Hyper reference `SkyFrame' on page 705 undefined on input line 4 0365. LaTeX Warning: Hyper reference `TimeFrame' on page 705 undefined on input line 40365. LaTeX Warning: Hyper reference `ObsLon' on page 705 undefined on input line 403 65. LaTeX Warning: Hyper reference `Epoch' on page 705 undefined on input line 4036 5. LaTeX Warning: Hyper reference `RefRA' on page 705 undefined on input line 4036 5. LaTeX Warning: Hyper reference `RefDec' on page 705 undefined on input line 403 65. [705] LaTeX Warning: Hyper reference `Frame' on page 706 undefined on input line 4041 2. LaTeX Warning: Hyper reference `SpecFrame' on page 706 undefined on input line 40412. LaTeX Warning: Hyper reference `SkyFrame' on page 706 undefined on input line 4 0412. LaTeX Warning: Hyper reference `TimeFrame' on page 706 undefined on input line 40412. LaTeX Warning: Hyper reference `ObsLon' on page 706 undefined on input line 404 12. LaTeX Warning: Hyper reference `Epoch' on page 706 undefined on input line 4041 2. LaTeX Warning: Hyper reference `RefRA' on page 706 undefined on input line 4041 2. LaTeX Warning: Hyper reference `RefDec' on page 706 undefined on input line 404 12. [706] LaTeX Warning: Hyper reference `ObsLat' on page 707 undefined on input line 404 61. LaTeX Warning: Hyper reference `Frame' on page 707 undefined on input line 4046 1. LaTeX Warning: Hyper reference `SpecFrame' on page 707 undefined on input line 40461. LaTeX Warning: Hyper reference `SkyFrame' on page 707 undefined on input line 4 0461. LaTeX Warning: Hyper reference `TimeFrame' on page 707 undefined on input line 40461. LaTeX Warning: Hyper reference `Epoch' on page 707 undefined on input line 4046 1. LaTeX Warning: Hyper reference `RefRA' on page 707 undefined on input line 4046 1. LaTeX Warning: Hyper reference `RefDec' on page 707 undefined on input line 404 61. [707] LaTeX Warning: Hyper reference `WcsMap' on page 708 undefined on input line 404 87. LaTeX Warning: Hyper reference `PVi_m' on page 708 undefined on input line 4048 7. LaTeX Warning: Hyper reference `astWcsMap' on page 708 undefined on input line 40487. [708] LaTeX Warning: Hyper reference `WcsMap' on page 709 undefined on input line 405 70. LaTeX Warning: Hyper reference `WcsType' on page 709 undefined on input line 40 570. LaTeX Warning: Hyper reference `astWcsMap' on page 709 undefined on input line 40570. LaTeX Warning: Hyper reference `CmpMap' on page 709 undefined on input line 405 70. LaTeX Warning: Hyper reference `FrameSet' on page 709 undefined on input line 4 0570. LaTeX Warning: Hyper reference `astClone' on page 709 undefined on input line 4 0570. [709] LaTeX Warning: Hyper reference `PcdMap' on page 710 undefined on input line 406 13. Overfull \hbox (59.49594pt too wide) in paragraph at lines 40613--40613 \T1/ppl/m/n/10 (-20) takes a sep-a-rate value for each axis of the PcdMap so th at, for in-stance, the set-tings \T1/cmtt/m/n/10 " \T1/ppl/m/n/10 (-20) PcdCen( 1)=345.0,PcdCen(2)=- LaTeX Warning: Hyper reference `CmpMap' on page 710 undefined on input line 406 13. LaTeX Warning: Hyper reference `FrameSet' on page 710 undefined on input line 4 0613. LaTeX Warning: Hyper reference `astClone' on page 710 undefined on input line 4 0613. [710] LaTeX Warning: Hyper reference `Frame' on page 711 undefined on input line 4065 8. LaTeX Warning: Hyper reference `astFindFrame' on page 711 undefined on input li ne 40658. LaTeX Warning: Hyper reference `SkyFrame' on page 711 undefined on input line 4 0658. LaTeX Warning: Hyper reference `FrameSet' on page 711 undefined on input line 4 0658. LaTeX Warning: Hyper reference `Current' on page 711 undefined on input line 40 658. [711] LaTeX Warning: Hyper reference `SphMap' on page 712 undefined on input line 406 87. LaTeX Warning: Hyper reference `CmpMap' on page 712 undefined on input line 406 87. LaTeX Warning: Hyper reference `FrameSet' on page 712 undefined on input line 4 0687. LaTeX Warning: Hyper reference `astClone' on page 712 undefined on input line 4 0687. [712] LaTeX Warning: Hyper reference `FrameSet' on page 713 undefined on input line 4 0730. LaTeX Warning: Hyper reference `PVi_m' on page 713 undefined on input line 4073 0. LaTeX Warning: Hyper reference `FitsChan' on page 713 undefined on input line 4 0730. [713] LaTeX Warning: Hyper reference `Frame' on page 714 undefined on input line 4076 7. LaTeX Warning: Hyper reference `astFindFrame' on page 714 undefined on input li ne 40767. LaTeX Warning: Hyper reference `FrameSet' on page 714 undefined on input line 4 0767. LaTeX Warning: Hyper reference `Current' on page 714 undefined on input line 40 767. [714] LaTeX Warning: Hyper reference `WcsMap' on page 715 undefined on input line 408 02. LaTeX Warning: Hyper reference `CmpMap' on page 715 undefined on input line 408 02. LaTeX Warning: Hyper reference `FrameSet' on page 715 undefined on input line 4 0802. LaTeX Warning: Hyper reference `astClone' on page 715 undefined on input line 4 0802. [715] LaTeX Warning: Hyper reference `SkyFrame' on page 716 undefined on input line 4 0833. LaTeX Warning: Hyper reference `Title' on page 716 undefined on input line 4083 3. [716] LaTeX Warning: Hyper reference `Object' on page 717 undefined on input line 408 58. LaTeX Warning: Hyper reference `astClone' on page 717 undefined on input line 4 0858. LaTeX Warning: Hyper reference `astAnnul' on page 717 undefined on input line 4 0858. LaTeX Warning: Hyper reference `astEnd' on page 717 undefined on input line 408 58. [717] LaTeX Warning: Hyper reference `RefRA' on page 718 undefined on input line 4087 9. LaTeX Warning: Hyper reference `SpecFrame' on page 718 undefined on input line 40879. [718] LaTeX Warning: Hyper reference `RefDec' on page 719 undefined on input line 409 28. LaTeX Warning: Hyper reference `astFindFrame' on page 719 undefined on input li ne 40928. LaTeX Warning: Hyper reference `astConvert' on page 719 undefined on input line 40928. LaTeX Warning: Hyper reference `SpecFrame' on page 719 undefined on input line 40928. LaTeX Warning: Hyper reference `CmpFrame' on page 719 undefined on input line 4 0928. LaTeX Warning: Hyper reference `astSetRefPos' on page 719 undefined on input li ne 40928. LaTeX Warning: Hyper reference `astGetRefPos' on page 719 undefined on input li ne 40928. [719] LaTeX Warning: Hyper reference `Region' on page 720 undefined on input line 409 49. LaTeX Warning: Hyper reference `Stc' on page 720 undefined on input line 40949. [720] LaTeX Warning: Hyper reference `Mapping' on page 721 undefined on input line 41 013. LaTeX Warning: Hyper reference `CmpMap' on page 721 undefined on input line 410 13. LaTeX Warning: Hyper reference `Frame' on page 721 undefined on input line 4101 3. LaTeX Warning: Hyper reference `astFormat' on page 721 undefined on input line 41013. LaTeX Warning: Hyper reference `FrameSet' on page 721 undefined on input line 4 1013. LaTeX Warning: Hyper reference `astWrite' on page 721 undefined on input line 4 1013. [721] LaTeX Warning: Hyper reference `Object' on page 722 undefined on input line 410 68. LaTeX Warning: Hyper reference `Strict' on page 722 undefined on input line 410 68. LaTeX Warning: Hyper reference `Report' on page 722 undefined on input line 410 68. LaTeX Warning: Hyper reference `Channel' on page 722 undefined on input line 41 068. LaTeX Warning: Hyper reference `FitsChan' on page 722 undefined on input line 4 1068. LaTeX Warning: Hyper reference `Warnings' on page 722 undefined on input line 4 1068. [722] LaTeX Warning: Hyper reference `SpecFrame' on page 723 undefined on input line 41109. [723] LaTeX Warning: Hyper reference `astGrid' on page 724 undefined on input line 41 151. LaTeX Warning: Hyper reference `astPlot3D' on page 724 undefined on input line 41151. LaTeX Warning: Hyper reference `Plot3D' on page 724 undefined on input line 411 51. LaTeX Warning: Hyper reference `Axis' on page 724 undefined on input line 41151 . [724] LaTeX Warning: Hyper reference `MathMap' on page 725 undefined on input line 41 184. [725] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 726 undefined on input li ne 41214. LaTeX Warning: Hyper reference `DSBCentre' on page 726 undefined on input line 41214. LaTeX Warning: Hyper reference `IF' on page 726 undefined on input line 41214. [726] LaTeX Warning: Hyper reference `MathMap' on page 727 undefined on input line 41 270. LaTeX Warning: Hyper reference `Mapping' on page 727 undefined on input line 41 270. LaTeX Warning: Hyper reference `UnitMap' on page 727 undefined on input line 41 270. LaTeX Warning: Hyper reference `astSimplify' on page 727 undefined on input lin e 41270. LaTeX Warning: Hyper reference `SimpIF' on page 727 undefined on input line 412 70. LaTeX Warning: Hyper reference `Invert' on page 727 undefined on input line 412 70. [727] LaTeX Warning: Hyper reference `MathMap' on page 728 undefined on input line 41 326. LaTeX Warning: Hyper reference `Mapping' on page 728 undefined on input line 41 326. LaTeX Warning: Hyper reference `UnitMap' on page 728 undefined on input line 41 326. LaTeX Warning: Hyper reference `astSimplify' on page 728 undefined on input lin e 41326. LaTeX Warning: Hyper reference `SimpFI' on page 728 undefined on input line 413 26. LaTeX Warning: Hyper reference `Invert' on page 728 undefined on input line 413 26. [728] LaTeX Warning: Hyper reference `astSimplify' on page 729 undefined on input lin e 41357. LaTeX Warning: Hyper reference `Polygon' on page 729 undefined on input line 41 357. LaTeX Warning: Hyper reference `Frame' on page 729 undefined on input line 4135 7. LaTeX Warning: Hyper reference `Mapping' on page 729 undefined on input line 41 357. [729] LaTeX Warning: Hyper reference `Channel' on page 730 undefined on input line 41 417. LaTeX Warning: Hyper reference `astWrite' on page 730 undefined on input line 4 1417. LaTeX Warning: Hyper reference `FitsChan' on page 730 undefined on input line 4 1417. LaTeX Warning: Hyper reference `astCopy' on page 730 undefined on input line 41 417. LaTeX Warning: Hyper reference `astShow' on page 730 undefined on input line 41 417. [730] Overfull \hbox (238.94087pt too wide) in paragraph at lines 41469--41469 \T1/ppl/m/n/10 (-20) the Spitzer Space Tele-scope and is de-scribed in the fol- low-ing doc-u-ment: http://irsa.ipac.caltech.edu/data/SPITZER/docs/files/spitze r/shupeADASS.pdf LaTeX Warning: Hyper reference `astRead' on page 731 undefined on input line 41 469. LaTeX Warning: Hyper reference `PolyMap' on page 731 undefined on input line 41 469. LaTeX Warning: Hyper reference `FrameSet' on page 731 undefined on input line 4 1469. LaTeX Warning: Hyper reference `MatrixMap' on page 731 undefined on input line 41469. LaTeX Warning: Hyper reference `astWrite' on page 731 undefined on input line 4 1469. LaTeX Warning: Hyper reference `Mapping' on page 731 undefined on input line 41 469. LaTeX Warning: Hyper reference `FitsTol' on page 731 undefined on input line 41 469. LaTeX Warning: Hyper reference `SkyFrame' on page 731 undefined on input line 4 1469. LaTeX Warning: Hyper reference `PolyTan' on page 731 undefined on input line 41 469. LaTeX Warning: Hyper reference `FitsChan' on page 731 undefined on input line 4 1469. [731] LaTeX Warning: Hyper reference `astRead' on page 732 undefined on input line 41 500. Overfull \hbox (190.3857pt too wide) in paragraph at lines 41500--41500 \T1/ppl/m/n/10 (-20) a FITS-WCS en-coded header us-ing the as-tRead func-tion. See http://irsa.ipac.caltech.edu/data/SPITZER/docs/files/spitzer/shupeADASS.pdf LaTeX Warning: Hyper reference `FitsChan' on page 732 undefined on input line 4 1500. [732] LaTeX Warning: Hyper reference `Plot' on page 733 undefined on input line 41544 . [733] LaTeX Warning: Hyper reference `KeyMap' on page 734 undefined on input line 415 75. [734] LaTeX Warning: Hyper reference `Object' on page 735 undefined on input line 416 10. LaTeX Warning: Hyper reference `Channel' on page 735 undefined on input line 41 610. LaTeX Warning: Hyper reference `FitsChan' on page 735 undefined on input line 4 1610. [735] LaTeX Warning: Hyper reference `SkyFrame' on page 736 undefined on input line 4 1691. LaTeX Warning: Hyper reference `System' on page 736 undefined on input line 416 91. LaTeX Warning: Hyper reference `SkyRefIs' on page 736 undefined on input line 4 1691. LaTeX Warning: Hyper reference `LonAxis' on page 736 undefined on input line 41 691. LaTeX Warning: Hyper reference `LatAxis' on page 736 undefined on input line 41 691. LaTeX Warning: Hyper reference `astConvert' on page 736 undefined on input line 41691. LaTeX Warning: Hyper reference `astFindFrame' on page 736 undefined on input li ne 41691. LaTeX Warning: Hyper reference `AlignSystem' on page 736 undefined on input lin e 41691. LaTeX Warning: Hyper reference `AlignOffset' on page 736 undefined on input lin e 41691. [736] LaTeX Warning: Hyper reference `SkyFrame' on page 737 undefined on input line 4 1727. LaTeX Warning: Hyper reference `System' on page 737 undefined on input line 417 27. [737] LaTeX Warning: Hyper reference `SkyRefIs' on page 738 undefined on input line 4 1798. LaTeX Warning: Hyper reference `System' on page 738 undefined on input line 417 98. LaTeX Warning: Hyper reference `SkyFrame' on page 738 undefined on input line 4 1798. LaTeX Warning: Hyper reference `LonAxis' on page 738 undefined on input line 41 798. LaTeX Warning: Hyper reference `LatAxis' on page 738 undefined on input line 41 798. [738] LaTeX Warning: Hyper reference `SkyFrame' on page 739 undefined on input line 4 1849. LaTeX Warning: Hyper reference `Mapping' on page 739 undefined on input line 41 849. LaTeX Warning: Hyper reference `astConvert' on page 739 undefined on input line 41849. LaTeX Warning: Hyper reference `astFindFrame' on page 739 undefined on input li ne 41849. LaTeX Warning: Hyper reference `UnitMap' on page 739 undefined on input line 41 849. LaTeX Warning: Hyper reference `FrameSet' on page 739 undefined on input line 4 1849. LaTeX Warning: Hyper reference `Epoch' on page 739 undefined on input line 4184 9. LaTeX Warning: Hyper reference `AlignSystem' on page 739 undefined on input lin e 41849. [739] LaTeX Warning: Hyper reference `astMapKey' on page 740 undefined on input line 41919. LaTeX Warning: Hyper reference `KeyMap' on page 740 undefined on input line 419 19. [740] LaTeX Warning: Hyper reference `Channel' on page 741 undefined on input line 41 979. LaTeX Warning: Hyper reference `astRead' on page 741 undefined on input line 41 979. LaTeX Warning: Hyper reference `FitsChan' on page 741 undefined on input line 4 1979. LaTeX Warning: Hyper reference `astCopy' on page 741 undefined on input line 41 979. LaTeX Warning: Hyper reference `astShow' on page 741 undefined on input line 41 979. [741] LaTeX Warning: Hyper reference `SourceVel' on page 742 undefined on input line 42028. LaTeX Warning: Hyper reference `SpecFrame' on page 742 undefined on input line 42028. [742] LaTeX Warning: Hyper reference `SourceVel' on page 743 undefined on input line 42060. LaTeX Warning: Hyper reference `StdOfRest' on page 743 undefined on input line 42060. LaTeX Warning: Hyper reference `SpecFrame' on page 743 undefined on input line 42060. [743] LaTeX Warning: Hyper reference `SourceSys' on page 744 undefined on input line 42110. LaTeX Warning: Hyper reference `SourceVRF' on page 744 undefined on input line 42110. LaTeX Warning: Hyper reference `RefRA' on page 744 undefined on input line 4211 0. LaTeX Warning: Hyper reference `RefDec' on page 744 undefined on input line 421 10. LaTeX Warning: Hyper reference `StdOfRest' on page 744 undefined on input line 42110. LaTeX Warning: Hyper reference `SpecFrame' on page 744 undefined on input line 42110. [744] LaTeX Warning: Hyper reference `SpecFrame' on page 745 undefined on input line 42145. LaTeX Warning: Hyper reference `System' on page 745 undefined on input line 421 45. [745] LaTeX Warning: Hyper reference `FluxFrame' on page 746 undefined on input line 42169. LaTeX Warning: Hyper reference `Mapping' on page 746 undefined on input line 42 169. [746] LaTeX Warning: Hyper reference `astRead' on page 747 undefined on input line 42 240. LaTeX Warning: Hyper reference `StcsChan' on page 747 undefined on input line 4 2240. LaTeX Warning: Hyper reference `Region' on page 747 undefined on input line 422 40. LaTeX Warning: Hyper reference `StcsCoords' on page 747 undefined on input line 42240. LaTeX Warning: Hyper reference `StcsProps' on page 747 undefined on input line 42240. LaTeX Warning: Hyper reference `Object' on page 747 undefined on input line 422 40. LaTeX Warning: Hyper reference `KeyMap' on page 747 undefined on input line 422 40. LaTeX Warning: Hyper reference `Prism' on page 747 undefined on input line 4224 0. LaTeX Warning: Hyper reference `astSimplify' on page 747 undefined on input lin e 42240. LaTeX Warning: Hyper reference `TimeFrame' on page 747 undefined on input line 42240. LaTeX Warning: Hyper reference `TimeOrigin' on page 747 undefined on input line 42240. LaTeX Warning: Hyper reference `Epoch' on page 747 undefined on input line 4224 0. [747] LaTeX Warning: Hyper reference `astRead' on page 748 undefined on input line 42 316. LaTeX Warning: Hyper reference `StcsChan' on page 748 undefined on input line 4 2316. LaTeX Warning: Hyper reference `PointList' on page 748 undefined on input line 42316. LaTeX Warning: Hyper reference `StcsArea' on page 748 undefined on input line 4 2316. LaTeX Warning: Hyper reference `StcsProps' on page 748 undefined on input line 42316. LaTeX Warning: Hyper reference `Object' on page 748 undefined on input line 423 16. LaTeX Warning: Hyper reference `KeyMap' on page 748 undefined on input line 423 16. LaTeX Warning: Hyper reference `TimeFrame' on page 748 undefined on input line 42316. LaTeX Warning: Hyper reference `TimeOrigin' on page 748 undefined on input line 42316. LaTeX Warning: Hyper reference `Epoch' on page 748 undefined on input line 4231 6. LaTeX Warning: Hyper reference `Region' on page 748 undefined on input line 423 16. [748] LaTeX Warning: Hyper reference `StcsChan' on page 749 undefined on input line 4 2345. LaTeX Warning: Hyper reference `Indent' on page 749 undefined on input line 423 45. [749] LaTeX Warning: Hyper reference `astRead' on page 750 undefined on input line 42 396. LaTeX Warning: Hyper reference `StcsChan' on page 750 undefined on input line 4 2396. LaTeX Warning: Hyper reference `KeyMap' on page 750 undefined on input line 423 96. LaTeX Warning: Hyper reference `StcsCoords' on page 750 undefined on input line 42396. LaTeX Warning: Hyper reference `StcsArea' on page 750 undefined on input line 4 2396. LaTeX Warning: Hyper reference `Object' on page 750 undefined on input line 423 96. [750] LaTeX Warning: Hyper reference `SpecFrame' on page 751 undefined on input line 42491. LaTeX Warning: Hyper reference `ObsLat' on page 751 undefined on input line 424 91. LaTeX Warning: Hyper reference `ObsLon' on page 751 undefined on input line 424 91. LaTeX Warning: Hyper reference `ObsAlt' on page 751 undefined on input line 424 91. LaTeX Warning: Hyper reference `Epoch' on page 751 undefined on input line 4249 1. LaTeX Warning: Hyper reference `RefRA' on page 751 undefined on input line 4249 1. LaTeX Warning: Hyper reference `RefDec' on page 751 undefined on input line 424 91. LaTeX Warning: Hyper reference `SourceVel' on page 751 undefined on input line 42491. LaTeX Warning: Hyper reference `System' on page 751 undefined on input line 424 91. [751] [752] LaTeX Warning: Hyper reference `Channel' on page 753 undefined on input line 42 531. LaTeX Warning: Hyper reference `astWarnings' on page 753 undefined on input lin e 42531. LaTeX Warning: Hyper reference `Object' on page 753 undefined on input line 425 31. [753] LaTeX Warning: Hyper reference `Plot' on page 754 undefined on input line 42574 . LaTeX Warning: Hyper reference `Border' on page 754 undefined on input line 425 74. [754] LaTeX Warning: Hyper reference `Frame' on page 755 undefined on input line 4263 4. LaTeX Warning: Hyper reference `Domain' on page 755 undefined on input line 426 34. LaTeX Warning: Hyper reference `SkyFrame' on page 755 undefined on input line 4 2634. LaTeX Warning: Hyper reference `TimeFrame' on page 755 undefined on input line 42634. LaTeX Warning: Hyper reference `FrameSet' on page 755 undefined on input line 4 2634. LaTeX Warning: Hyper reference `Current' on page 755 undefined on input line 42 634. [755] LaTeX Warning: Hyper reference `SkyFrame' on page 756 undefined on input line 4 2920. LaTeX Warning: Hyper reference `SpecFrame' on page 756 undefined on input line 42920. LaTeX Warning: Hyper reference `Frame' on page 756 undefined on input line 4292 0. LaTeX Warning: Hyper reference `CmpFrame' on page 756 undefined on input line 4 2920. LaTeX Warning: Hyper reference `FrameSet' on page 756 undefined on input line 4 2920. LaTeX Warning: Hyper reference `Current' on page 756 undefined on input line 42 920. LaTeX Warning: Hyper reference `Epoch' on page 756 undefined on input line 4292 0. LaTeX Warning: Hyper reference `Equinox' on page 756 undefined on input line 42 920. [756] LaTeX Warning: Hyper reference `Mapping' on page 757 undefined on input line 42 920. [757] LaTeX Warning: Hyper reference `astSetActiveUnit' on page 758 undefined on inpu t line 42920. LaTeX Warning: Hyper reference `TimeFrame' on page 758 undefined on input line 42920. LaTeX Warning: Hyper reference `FluxFrame' on page 758 undefined on input line 42920. [758] LaTeX Warning: Hyper reference `FitsChan' on page 759 undefined on input line 4 3003. LaTeX Warning: Hyper reference `astWrite' on page 759 undefined on input line 4 3003. LaTeX Warning: Hyper reference `astRead' on page 759 undefined on input line 43 003. LaTeX Warning: Hyper reference `FrameSet' on page 759 undefined on input line 4 3003. LaTeX Warning: Hyper reference `astGetTables' on page 759 undefined on input li ne 43003. LaTeX Warning: Hyper reference `FitsTable' on page 759 undefined on input line 43003. LaTeX Warning: Hyper reference `astPutTables' on page 759 undefined on input li ne 43003. LaTeX Warning: Hyper reference `astPutTable' on page 759 undefined on input lin e 43003. LaTeX Warning: Hyper reference `astTableSource' on page 759 undefined on input line 43003. [759] LaTeX Warning: Hyper reference `astGrid' on page 760 undefined on input line 43 055. LaTeX Warning: Hyper reference `Plot' on page 760 undefined on input line 43055 . LaTeX Warning: Hyper reference `Labelling' on page 760 undefined on input line 43055. LaTeX Warning: Hyper reference `Label(axis)' on page 760 undefined on input lin e 43055. LaTeX Warning: Hyper reference `Unit(axis)' on page 760 undefined on input line 43055. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 760 undefined on inpu t line 43055. LaTeX Warning: Hyper reference `NumLab(axis)' on page 760 undefined on input li ne 43055. [760] LaTeX Warning: Hyper reference `astGrid' on page 761 undefined on input line 43 107. LaTeX Warning: Hyper reference `Plot' on page 761 undefined on input line 43107 . LaTeX Warning: Hyper reference `Labelling' on page 761 undefined on input line 43107. [761] LaTeX Warning: Hyper reference `astGrid' on page 762 undefined on input line 43 144. LaTeX Warning: Hyper reference `Plot' on page 762 undefined on input line 43144 . LaTeX Warning: Hyper reference `Edge(axis)' on page 762 undefined on input line 43144. LaTeX Warning: Hyper reference `Labelling' on page 762 undefined on input line 43144. [762] LaTeX Warning: Hyper reference `TimeFrame' on page 763 undefined on input line 43225. LaTeX Warning: Hyper reference `System' on page 763 undefined on input line 432 25. LaTeX Warning: Hyper reference `Epoch' on page 763 undefined on input line 4322 5. [763] LaTeX Warning: Hyper reference `TimeFrame' on page 764 undefined on input line 43326. LaTeX Warning: Hyper reference `System' on page 764 undefined on input line 433 26. LaTeX Warning: Hyper reference `Epoch' on page 764 undefined on input line 4332 6. LaTeX Warning: Hyper reference `Dut1' on page 764 undefined on input line 43326 . LaTeX Warning: Hyper reference `Frame' on page 764 undefined on input line 4332 6. LaTeX Warning: Hyper reference `LTOffset' on page 764 undefined on input line 4 3326. Overfull \hbox (146.29462pt too wide) in paragraph at lines 43326--43326 \T1/ppl/m/n/10 (-20) An very in-for-ma-tive de-scrip-tion of these and other ti me scales is avail-able at http://www.ucolick.org/$\OMS/zplm/m/n/10 ^^X$\T1/ppl /m/n/10 (-20) sla/leapsecs/timescales.html. LaTeX Warning: Hyper reference `Warnings' on page 764 undefined on input line 4 3326. [764] [765] LaTeX Warning: Hyper reference `Frame' on page 766 undefined on input line 4337 4. LaTeX Warning: Hyper reference `Naxes' on page 766 undefined on input line 4337 4. LaTeX Warning: Hyper reference `CmpFrame' on page 766 undefined on input line 4 3374. LaTeX Warning: Hyper reference `FrameSet' on page 766 undefined on input line 4 3374. LaTeX Warning: Hyper reference `Current' on page 766 undefined on input line 43 374. [766] LaTeX Warning: Hyper reference `astGrid' on page 767 undefined on input line 43 418. LaTeX Warning: Hyper reference `Plot' on page 767 undefined on input line 43418 . LaTeX Warning: Hyper reference `Plot3D' on page 767 undefined on input line 434 18. LaTeX Warning: Hyper reference `Title' on page 767 undefined on input line 4341 8. [767] LaTeX Warning: Hyper reference `Plot' on page 768 undefined on input line 43446 . [768] LaTeX Warning: Hyper reference `IterInverse' on page 769 undefined on input lin e 43473. LaTeX Warning: Hyper reference `NiterInverse' on page 769 undefined on input li ne 43473. LaTeX Warning: Hyper reference `PolyMap' on page 769 undefined on input line 43 473. [769] LaTeX Warning: Hyper reference `astGrid' on page 770 undefined on input line 43 510. LaTeX Warning: Hyper reference `Frame' on page 770 undefined on input line 4351 0. LaTeX Warning: Hyper reference `SkyFrame' on page 770 undefined on input line 4 3510. [770] LaTeX Warning: Hyper reference `Mapping' on page 771 undefined on input line 43 559. LaTeX Warning: Hyper reference `CmpMap' on page 771 undefined on input line 435 59. LaTeX Warning: Hyper reference `FrameSet' on page 771 undefined on input line 4 3559. LaTeX Warning: Hyper reference `Frame' on page 771 undefined on input line 4355 9. LaTeX Warning: Hyper reference `Base' on page 771 undefined on input line 43559 . LaTeX Warning: Hyper reference `Current' on page 771 undefined on input line 43 559. [771] LaTeX Warning: Hyper reference `Mapping' on page 772 undefined on input line 43 608. LaTeX Warning: Hyper reference `CmpMap' on page 772 undefined on input line 436 08. LaTeX Warning: Hyper reference `FrameSet' on page 772 undefined on input line 4 3608. LaTeX Warning: Hyper reference `Frame' on page 772 undefined on input line 4360 8. LaTeX Warning: Hyper reference `Current' on page 772 undefined on input line 43 608. LaTeX Warning: Hyper reference `Base' on page 772 undefined on input line 43608 . [772] LaTeX Warning: Hyper reference `Frame' on page 773 undefined on input line 4367 9. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 773 undefined on inpu t line 43679. LaTeX Warning: Hyper reference `SkyFrame' on page 773 undefined on input line 4 3679. LaTeX Warning: Hyper reference `astFormat' on page 773 undefined on input line 43679. LaTeX Warning: Hyper reference `SpecFrame' on page 773 undefined on input line 43679. LaTeX Warning: Hyper reference `System' on page 773 undefined on input line 436 79. LaTeX Warning: Hyper reference `TimeFrame' on page 773 undefined on input line 43679. LaTeX Warning: Hyper reference `FrameSet' on page 773 undefined on input line 4 3679. LaTeX Warning: Hyper reference `Current' on page 773 undefined on input line 43 679. [773] LaTeX Warning: Hyper reference `SphMap' on page 774 undefined on input line 437 48. LaTeX Warning: Hyper reference `CmpMap' on page 774 undefined on input line 437 48. LaTeX Warning: Hyper reference `astSimplify' on page 774 undefined on input lin e 43748. LaTeX Warning: Hyper reference `UnitMap' on page 774 undefined on input line 43 748. LaTeX Warning: Hyper reference `FitsChan' on page 774 undefined on input line 4 3748. LaTeX Warning: Hyper reference `FrameSet' on page 774 undefined on input line 4 3748. LaTeX Warning: Hyper reference `astClone' on page 774 undefined on input line 4 3748. [774] LaTeX Warning: Hyper reference `astTest' on page 775 undefined on input line 43 836. LaTeX Warning: Hyper reference `Object' on page 775 undefined on input line 438 36. LaTeX Warning: Hyper reference `FrameSet' on page 775 undefined on input line 4 3836. LaTeX Warning: Hyper reference `Frame' on page 775 undefined on input line 4383 6. LaTeX Warning: Hyper reference `CmpFrame' on page 775 undefined on input line 4 3836. LaTeX Warning: Hyper reference `Region' on page 775 undefined on input line 438 36. LaTeX Warning: Hyper reference `Epoch' on page 775 undefined on input line 4383 6. LaTeX Warning: Hyper reference `ObsLat' on page 775 undefined on input line 438 36. LaTeX Warning: Hyper reference `ObsLon' on page 775 undefined on input line 438 36. LaTeX Warning: Hyper reference `SkyFrame' on page 775 undefined on input line 4 3836. LaTeX Warning: Hyper reference `Equinox' on page 775 undefined on input line 43 836. LaTeX Warning: Hyper reference `SpecFrame' on page 775 undefined on input line 43836. LaTeX Warning: Hyper reference `RefRA' on page 775 undefined on input line 4383 6. LaTeX Warning: Hyper reference `RefDec' on page 775 undefined on input line 438 36. LaTeX Warning: Hyper reference `RestFreq' on page 775 undefined on input line 4 3836. LaTeX Warning: Hyper reference `SourceVel' on page 775 undefined on input line 43836. LaTeX Warning: Hyper reference `StdOfRest' on page 775 undefined on input line 43836. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 775 undefined on input li ne 43836. LaTeX Warning: Hyper reference `ImagFreq' on page 775 undefined on input line 4 3836. LaTeX Warning: Hyper reference `DSBCentre' on page 775 undefined on input line 43836. LaTeX Warning: Hyper reference `IF' on page 775 undefined on input line 43836. [775] LaTeX Warning: Hyper reference `Mapping' on page 776 undefined on input line 43 938. LaTeX Warning: Hyper reference `Frame' on page 776 undefined on input line 4393 8. LaTeX Warning: Hyper reference `FrameSet' on page 776 undefined on input line 4 3938. LaTeX Warning: Hyper reference `astRemapFrame' on page 776 undefined on input l ine 43938. LaTeX Warning: Hyper reference `Domain' on page 776 undefined on input line 439 38. LaTeX Warning: Hyper reference `SkyFrame' on page 776 undefined on input line 4 3938. LaTeX Warning: Hyper reference `astAddFrame' on page 776 undefined on input lin e 43938. LaTeX Warning: Hyper reference `astAddVariant' on page 776 undefined on input l ine 43938. LaTeX Warning: Hyper reference `astMirrorVariants' on page 776 undefined on inp ut line 43938. LaTeX Warning: Hyper reference `AllVariants' on page 776 undefined on input lin e 43938. [776] [777] LaTeX Warning: Hyper reference `Object' on page 778 undefined on input line 439 81. LaTeX Warning: Hyper reference `FitsChan' on page 778 undefined on input line 4 3981. LaTeX Warning: Hyper reference `AllWarnings' on page 778 undefined on input lin e 43981. LaTeX Warning: Hyper reference `astFindFits' on page 778 undefined on input lin e 43981. LaTeX Warning: Hyper reference `astRead' on page 778 undefined on input line 43 981. LaTeX Warning: Hyper reference `astWrite' on page 778 undefined on input line 4 3981. LaTeX Warning: Hyper reference `astDelFits' on page 778 undefined on input line 43981. LaTeX Warning: Hyper reference `Channel' on page 778 undefined on input line 43 981. LaTeX Warning: Hyper reference `astWarnings' on page 778 undefined on input lin e 43981. [778] LaTeX Warning: Hyper reference `WcsMap' on page 779 undefined on input line 440 08. LaTeX Warning: Hyper reference `astWcsMap' on page 779 undefined on input line 44008. [779] LaTeX Warning: Hyper reference `WcsMap' on page 780 undefined on input line 440 47. LaTeX Warning: Hyper reference `astWcsMap' on page 780 undefined on input line 44047. [780] LaTeX Warning: Hyper reference `Plot' on page 781 undefined on input line 44093 . LaTeX Warning: Hyper reference `Border' on page 781 undefined on input line 440 93. [781] LaTeX Warning: Hyper reference `XmlChan' on page 782 undefined on input line 44 288. LaTeX Warning: Hyper reference `astWrite' on page 782 undefined on input line 4 4288. LaTeX Warning: Hyper reference `Object' on page 782 undefined on input line 442 88. LaTeX Warning: Hyper reference `FitsChan' on page 782 undefined on input line 4 4288. LaTeX Warning: Hyper reference `Channel' on page 782 undefined on input line 44 288. LaTeX Warning: Hyper reference `StcsChan' on page 782 undefined on input line 4 4288. LaTeX Warning: Hyper reference `astRead' on page 782 undefined on input line 44 288. [782] LaTeX Warning: Hyper reference `Stc' on page 783 undefined on input line 44288. LaTeX Warning: Hyper reference `StcResourceProfile' on page 783 undefined on in put line 44288. LaTeX Warning: Hyper reference `StcSearchLocation' on page 783 undefined on inp ut line 44288. LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 783 undefined on input line 44288. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 783 undefined on in put line 44288. LaTeX Warning: Hyper reference `TimeFrame' on page 783 undefined on input line 44288. LaTeX Warning: Hyper reference `Frame' on page 783 undefined on input line 4428 8. LaTeX Warning: Hyper reference `Domain' on page 783 undefined on input line 442 88. LaTeX Warning: Hyper reference `SkyFrame' on page 783 undefined on input line 4 4288. LaTeX Warning: Hyper reference `Region' on page 783 undefined on input line 442 88. LaTeX Warning: Hyper reference `Polygon' on page 783 undefined on input line 44 288. [783] LaTeX Warning: Hyper reference `XmlChan' on page 784 undefined on input line 44 313. [784] LaTeX Warning: Hyper reference `Object' on page 785 undefined on input line 443 42. LaTeX Warning: Hyper reference `XmlChan' on page 785 undefined on input line 44 342. [785] LaTeX Warning: Hyper reference `ZoomMap' on page 786 undefined on input line 44 390. LaTeX Warning: Hyper reference `astInvert' on page 786 undefined on input line 44390. LaTeX Warning: Hyper reference `Mapping' on page 786 undefined on input line 44 390. LaTeX Warning: Hyper reference `Invert' on page 786 undefined on input line 443 90. LaTeX Warning: Hyper reference `CmpMap' on page 786 undefined on input line 443 90. LaTeX Warning: Hyper reference `FrameSet' on page 786 undefined on input line 4 4390. LaTeX Warning: Hyper reference `astClone' on page 786 undefined on input line 4 4390. [786] [787] LaTeX Warning: Hyper reference `Frame' on page 788 undefined on input line 4441 5. LaTeX Warning: Hyper reference `astWrite' on page 788 undefined on input line 4 4415. LaTeX Warning: Hyper reference `Object' on page 788 undefined on input line 444 15. [788] LaTeX Warning: Hyper reference `Region' on page 789 undefined on input line 444 52. LaTeX Warning: Hyper reference `Frame' on page 789 undefined on input line 4445 2. LaTeX Warning: Hyper reference `Interval' on page 789 undefined on input line 4 4452. LaTeX Warning: Hyper reference `SkyFrame' on page 789 undefined on input line 4 4452. LaTeX Warning: Hyper reference `Polygon' on page 789 undefined on input line 44 452. LaTeX Warning: Hyper reference `astBox' on page 789 undefined on input line 444 52. [789] LaTeX Warning: Hyper reference `Object' on page 790 undefined on input line 445 34. LaTeX Warning: Hyper reference `SinkFile' on page 790 undefined on input line 4 4534. LaTeX Warning: Hyper reference `SourceFile' on page 790 undefined on input line 44534. LaTeX Warning: Hyper reference `astChannel' on page 790 undefined on input line 44534. LaTeX Warning: Hyper reference `Comment' on page 790 undefined on input line 44 534. LaTeX Warning: Hyper reference `Full' on page 790 undefined on input line 44534 . LaTeX Warning: Hyper reference `Indent' on page 790 undefined on input line 445 34. LaTeX Warning: Hyper reference `ReportLevel' on page 790 undefined on input lin e 44534. LaTeX Warning: Hyper reference `SinkFile' on page 790 undefined on input line 4 4534. LaTeX Warning: Hyper reference `Skip' on page 790 undefined on input line 44534 . LaTeX Warning: Hyper reference `SourceFile' on page 790 undefined on input line 44534. LaTeX Warning: Hyper reference `Strict' on page 790 undefined on input line 445 34. LaTeX Warning: Hyper reference `astWarnings' on page 790 undefined on input lin e 44534. LaTeX Warning: Hyper reference `astPutChannelData' on page 790 undefined on inp ut line 44534. LaTeX Warning: Hyper reference `astRead' on page 790 undefined on input line 44 534. LaTeX Warning: Hyper reference `astWrite' on page 790 undefined on input line 4 4534. [790] LaTeX Warning: Hyper reference `Mapping' on page 791 undefined on input line 44 621. LaTeX Warning: Hyper reference `astPolyTran' on page 791 undefined on input lin e 44621. LaTeX Warning: Hyper reference `PolyMap' on page 791 undefined on input line 44 621. LaTeX Warning: Hyper reference `astChebyMap' on page 791 undefined on input lin e 44621. LaTeX Warning: Hyper reference `astChebyDomain' on page 791 undefined on input line 44621. [791] LaTeX Warning: Hyper reference `Region' on page 792 undefined on input line 446 57. LaTeX Warning: Hyper reference `Frame' on page 792 undefined on input line 4465 7. LaTeX Warning: Hyper reference `astCircle' on page 792 undefined on input line 44657. LaTeX Warning: Hyper reference `astCirclePars' on page 792 undefined on input l ine 44657. [792] LaTeX Warning: Hyper reference `Frame' on page 793 undefined on input line 4471 2. LaTeX Warning: Hyper reference `Mapping' on page 793 undefined on input line 44 712. LaTeX Warning: Hyper reference `UnitMap' on page 793 undefined on input line 44 712. LaTeX Warning: Hyper reference `Region' on page 793 undefined on input line 447 12. LaTeX Warning: Hyper reference `astCmpFrame' on page 793 undefined on input lin e 44712. LaTeX Warning: Hyper reference `SpecFrame' on page 793 undefined on input line 44712. LaTeX Warning: Hyper reference `SkyFrame' on page 793 undefined on input line 4 4712. LaTeX Warning: Hyper reference `Equinox' on page 793 undefined on input line 44 712. LaTeX Warning: Hyper reference `RestFreq' on page 793 undefined on input line 4 4712. [793] LaTeX Warning: Hyper reference `Mapping' on page 794 undefined on input line 44 753. LaTeX Warning: Hyper reference `astCmpMap' on page 794 undefined on input line 44753. [794] LaTeX Warning: Hyper reference `Region' on page 795 undefined on input line 448 13. LaTeX Warning: Hyper reference `Frame' on page 795 undefined on input line 4481 3. LaTeX Warning: Hyper reference `astConvert' on page 795 undefined on input line 44813. LaTeX Warning: Hyper reference `Mapping' on page 795 undefined on input line 44 813. LaTeX Warning: Hyper reference `SkyFrame' on page 795 undefined on input line 4 4813. LaTeX Warning: Hyper reference `astCmpRegion' on page 795 undefined on input li ne 44813. [795] LaTeX Warning: Hyper reference `SpecFrame' on page 796 undefined on input line 44882. LaTeX Warning: Hyper reference `SideBand' on page 796 undefined on input line 4 4882. LaTeX Warning: Hyper reference `IF' on page 796 undefined on input line 44882. LaTeX Warning: Hyper reference `astDSBSpecFrame' on page 796 undefined on input line 44882. LaTeX Warning: Hyper reference `AlignSideBand' on page 796 undefined on input l ine 44882. LaTeX Warning: Hyper reference `DSBCentre' on page 796 undefined on input line 44882. LaTeX Warning: Hyper reference `IF' on page 796 undefined on input line 44882. LaTeX Warning: Hyper reference `ImagFreq' on page 796 undefined on input line 4 4882. LaTeX Warning: Hyper reference `SideBand' on page 796 undefined on input line 4 4882. [796] LaTeX Warning: Hyper reference `Mapping' on page 797 undefined on input line 44 929. LaTeX Warning: Hyper reference `FrameSet' on page 797 undefined on input line 4 4929. LaTeX Warning: Hyper reference `astRead' on page 797 undefined on input line 44 929. LaTeX Warning: Hyper reference `FitsChan' on page 797 undefined on input line 4 4929. LaTeX Warning: Hyper reference `Encoding' on page 797 undefined on input line 4 4929. [797] LaTeX Warning: Hyper reference `Region' on page 798 undefined on input line 449 65. LaTeX Warning: Hyper reference `Frame' on page 798 undefined on input line 4496 5. LaTeX Warning: Hyper reference `astEllipse' on page 798 undefined on input line 44965. LaTeX Warning: Hyper reference `astEllipsePars' on page 798 undefined on input line 44965. [798] LaTeX Warning: Hyper reference `Channel' on page 799 undefined on input line 45 201. LaTeX Warning: Hyper reference `System' on page 799 undefined on input line 452 01. LaTeX Warning: Hyper reference `Object' on page 799 undefined on input line 452 01. LaTeX Warning: Hyper reference `astWrite' on page 799 undefined on input line 4 5201. LaTeX Warning: Hyper reference `Card' on page 799 undefined on input line 45201 . LaTeX Warning: Hyper reference `astFindFits' on page 799 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astPutFits' on page 799 undefined on input line 45201. LaTeX Warning: Hyper reference `astPutCards' on page 799 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 799 undefined on inp ut line 45201. LaTeX Warning: Hyper reference `astDelFits' on page 799 undefined on input line 45201. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 799 undefined on inp ut line 45201. LaTeX Warning: Hyper reference `SourceFile' on page 799 undefined on input line 45201. LaTeX Warning: Hyper reference `SinkFile' on page 799 undefined on input line 4 5201. LaTeX Warning: Hyper reference `astRead' on page 799 undefined on input line 45 201. LaTeX Warning: Hyper reference `Encoding' on page 799 undefined on input line 4 5201. LaTeX Warning: Hyper reference `astRetainFits' on page 799 undefined on input l ine 45201. [799] LaTeX Warning: Hyper reference `astFitsChan' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `AllWarnings' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `Card' on page 800 undefined on input line 45201 . LaTeX Warning: Hyper reference `CardComm' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `CardName' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `CardType' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `CarLin' on page 800 undefined on input line 452 01. LaTeX Warning: Hyper reference `CDMatrix' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `Clean' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `DefB1950' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `Encoding' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 800 undefined on input l ine 45201. LaTeX Warning: Hyper reference `FitsDigits' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `Iwc' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `Frame' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `Ncard' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `Nkey' on page 800 undefined on input line 45201 . LaTeX Warning: Hyper reference `PolyTan' on page 800 undefined on input line 45 201. LaTeX Warning: Hyper reference `PVi_m' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `SipReplace' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `SipOK' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `SipReplace' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `TabOK' on page 800 undefined on input line 4520 1. LaTeX Warning: Hyper reference `Warnings' on page 800 undefined on input line 4 5201. LaTeX Warning: Hyper reference `astDelFits' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `astEmptyFits' on page 800 undefined on input li ne 45201. LaTeX Warning: Hyper reference `astFindFits' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 800 undefined on inp ut line 45201. LaTeX Warning: Hyper reference `astGetTables' on page 800 undefined on input li ne 45201. LaTeX Warning: Hyper reference `astPurgeWCS' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astPutCards' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astPutFits' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `astPutTable' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `FitsTable' on page 800 undefined on input line 45201. LaTeX Warning: Hyper reference `astPutTables' on page 800 undefined on input li ne 45201. LaTeX Warning: Hyper reference `astReadFits' on page 800 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astRemoveTables' on page 800 undefined on input line 45201. [800] LaTeX Warning: Hyper reference `astRetainFits' on page 801 undefined on input l ine 45201. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 801 undefined on inp ut line 45201. LaTeX Warning: Hyper reference `astShowFits' on page 801 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astTableSource' on page 801 undefined on input line 45201. LaTeX Warning: Hyper reference `astTestFits' on page 801 undefined on input lin e 45201. LaTeX Warning: Hyper reference `astWriteFits' on page 801 undefined on input li ne 45201. [801] LaTeX Warning: Hyper reference `Table' on page 802 undefined on input line 4526 6. LaTeX Warning: Hyper reference `FitsChan' on page 802 undefined on input line 4 5266. LaTeX Warning: Hyper reference `astFitsTable' on page 802 undefined on input li ne 45266. LaTeX Warning: Hyper reference `astColumnNull' on page 802 undefined on input l ine 45266. LaTeX Warning: Hyper reference `astColumnSize' on page 802 undefined on input l ine 45266. LaTeX Warning: Hyper reference `astGetColumnData' on page 802 undefined on inpu t line 45266. LaTeX Warning: Hyper reference `astGetTableHeader' on page 802 undefined on inp ut line 45266. LaTeX Warning: Hyper reference `astPutColumnData' on page 802 undefined on inpu t line 45266. LaTeX Warning: Hyper reference `astPutTableHeader' on page 802 undefined on inp ut line 45266. [802] LaTeX Warning: Hyper reference `Frame' on page 803 undefined on input line 4531 0. LaTeX Warning: Hyper reference `System' on page 803 undefined on input line 453 10. LaTeX Warning: Hyper reference `SpecVal' on page 803 undefined on input line 45 310. LaTeX Warning: Hyper reference `astFluxFrame' on page 803 undefined on input li ne 45310. LaTeX Warning: Hyper reference `SpecVal' on page 803 undefined on input line 45 310. [803] LaTeX Warning: Hyper reference `Title' on page 804 undefined on input line 4550 9. LaTeX Warning: Hyper reference `astFrame' on page 804 undefined on input line 4 5509. LaTeX Warning: Hyper reference `Mapping' on page 804 undefined on input line 45 509. LaTeX Warning: Hyper reference `UnitMap' on page 804 undefined on input line 45 509. LaTeX Warning: Hyper reference `Nin' on page 804 undefined on input line 45509. LaTeX Warning: Hyper reference `Nout' on page 804 undefined on input line 45509 . LaTeX Warning: Hyper reference `AlignSystem' on page 804 undefined on input lin e 45509. LaTeX Warning: Hyper reference `Bottom(axis)' on page 804 undefined on input li ne 45509. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 804 undefined on i nput line 45509. LaTeX Warning: Hyper reference `Direction(axis)' on page 804 undefined on input line 45509. LaTeX Warning: Hyper reference `Domain' on page 804 undefined on input line 455 09. LaTeX Warning: Hyper reference `Dtai' on page 804 undefined on input line 45509 . LaTeX Warning: Hyper reference `Dut1' on page 804 undefined on input line 45509 . LaTeX Warning: Hyper reference `Epoch' on page 804 undefined on input line 4550 9. LaTeX Warning: Hyper reference `Format(axis)' on page 804 undefined on input li ne 45509. LaTeX Warning: Hyper reference `InternalUnit(axis)' on page 804 undefined on in put line 45509. LaTeX Warning: Hyper reference `Label(axis)' on page 804 undefined on input lin e 45509. LaTeX Warning: Hyper reference `Axis' on page 804 undefined on input line 45509 . LaTeX Warning: Hyper reference `MatchEnd' on page 804 undefined on input line 4 5509. LaTeX Warning: Hyper reference `MaxAxes' on page 804 undefined on input line 45 509. LaTeX Warning: Hyper reference `MinAxes' on page 804 undefined on input line 45 509. LaTeX Warning: Hyper reference `Naxes' on page 804 undefined on input line 4550 9. LaTeX Warning: Hyper reference `NormUnit(axis)' on page 804 undefined on input line 45509. LaTeX Warning: Hyper reference `ObsAlt' on page 804 undefined on input line 455 09. LaTeX Warning: Hyper reference `ObsLat' on page 804 undefined on input line 455 09. LaTeX Warning: Hyper reference `ObsLon' on page 804 undefined on input line 455 09. [804] LaTeX Warning: Hyper reference `Permute' on page 805 undefined on input line 45 509. LaTeX Warning: Hyper reference `PreserveAxes' on page 805 undefined on input li ne 45509. LaTeX Warning: Hyper reference `Symbol(axis)' on page 805 undefined on input li ne 45509. LaTeX Warning: Hyper reference `System' on page 805 undefined on input line 455 09. LaTeX Warning: Hyper reference `Title' on page 805 undefined on input line 4550 9. LaTeX Warning: Hyper reference `Top(axis)' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `Unit(axis)' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astAngle' on page 805 undefined on input line 4 5509. LaTeX Warning: Hyper reference `astAxAngle' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astAxDistance' on page 805 undefined on input l ine 45509. LaTeX Warning: Hyper reference `astAxNorm' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astAxOffset' on page 805 undefined on input lin e 45509. LaTeX Warning: Hyper reference `astConvert' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astDistance' on page 805 undefined on input lin e 45509. LaTeX Warning: Hyper reference `astFindFrame' on page 805 undefined on input li ne 45509. LaTeX Warning: Hyper reference `astFormat' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astGetActiveUnit' on page 805 undefined on inpu t line 45509. LaTeX Warning: Hyper reference `astIntersect' on page 805 undefined on input li ne 45509. LaTeX Warning: Hyper reference `astMatchAxes' on page 805 undefined on input li ne 45509. LaTeX Warning: Hyper reference `astNorm' on page 805 undefined on input line 45 509. LaTeX Warning: Hyper reference `astOffset' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astOffset2' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astPermAxes' on page 805 undefined on input lin e 45509. LaTeX Warning: Hyper reference `astPickAxes' on page 805 undefined on input lin e 45509. LaTeX Warning: Hyper reference `astResolve' on page 805 undefined on input line 45509. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 805 undefined on inpu t line 45509. LaTeX Warning: Hyper reference `astUnformat' on page 805 undefined on input lin e 45509. [805] LaTeX Warning: Hyper reference `Mapping' on page 806 undefined on input line 45 632. LaTeX Warning: Hyper reference `Frame' on page 806 undefined on input line 4563 2. LaTeX Warning: Hyper reference `Base' on page 806 undefined on input line 45632 . LaTeX Warning: Hyper reference `Current' on page 806 undefined on input line 45 632. LaTeX Warning: Hyper reference `Title' on page 806 undefined on input line 4563 2. LaTeX Warning: Hyper reference `astInvert' on page 806 undefined on input line 45632. LaTeX Warning: Hyper reference `Region' on page 806 undefined on input line 456 32. LaTeX Warning: Hyper reference `astFrameSet' on page 806 undefined on input lin e 45632. LaTeX Warning: Hyper reference `AllVariants' on page 806 undefined on input lin e 45632. LaTeX Warning: Hyper reference `Base' on page 806 undefined on input line 45632 . LaTeX Warning: Hyper reference `Current' on page 806 undefined on input line 45 632. LaTeX Warning: Hyper reference `Nframe' on page 806 undefined on input line 456 32. LaTeX Warning: Hyper reference `Variant' on page 806 undefined on input line 45 632. LaTeX Warning: Hyper reference `Equinox' on page 806 undefined on input line 45 632. LaTeX Warning: Hyper reference `SkyFrame' on page 806 undefined on input line 4 5632. [806] LaTeX Warning: Hyper reference `astAddFrame' on page 807 undefined on input lin e 45632. LaTeX Warning: Hyper reference `astAddVariant' on page 807 undefined on input l ine 45632. LaTeX Warning: Hyper reference `astGetFrame' on page 807 undefined on input lin e 45632. LaTeX Warning: Hyper reference `astGetMapping' on page 807 undefined on input l ine 45632. LaTeX Warning: Hyper reference `astMirrorVariants' on page 807 undefined on inp ut line 45632. LaTeX Warning: Hyper reference `astRemapFrame' on page 807 undefined on input l ine 45632. LaTeX Warning: Hyper reference `astRemoveFrame' on page 807 undefined on input line 45632. [807] LaTeX Warning: Hyper reference `Mapping' on page 808 undefined on input line 45 703. LaTeX Warning: Hyper reference `GrismWaveR' on page 808 undefined on input line 45703. LaTeX Warning: Hyper reference `GrismNRP' on page 808 undefined on input line 4 5703. LaTeX Warning: Hyper reference `GrismG' on page 808 undefined on input line 457 03. LaTeX Warning: Hyper reference `astGrismMap' on page 808 undefined on input lin e 45703. LaTeX Warning: Hyper reference `GrismNR' on page 808 undefined on input line 45 703. LaTeX Warning: Hyper reference `GrismNRP' on page 808 undefined on input line 4 5703. LaTeX Warning: Hyper reference `GrismWaveR' on page 808 undefined on input line 45703. LaTeX Warning: Hyper reference `GrismAlpha' on page 808 undefined on input line 45703. LaTeX Warning: Hyper reference `GrismG' on page 808 undefined on input line 457 03. LaTeX Warning: Hyper reference `GrismM' on page 808 undefined on input line 457 03. LaTeX Warning: Hyper reference `GrismEps' on page 808 undefined on input line 4 5703. LaTeX Warning: Hyper reference `GrismTheta' on page 808 undefined on input line 45703. [808] LaTeX Warning: Hyper reference `Region' on page 809 undefined on input line 457 45. LaTeX Warning: Hyper reference `Frame' on page 809 undefined on input line 4574 5. LaTeX Warning: Hyper reference `SkyFrame' on page 809 undefined on input line 4 5745. LaTeX Warning: Hyper reference `Box' on page 809 undefined on input line 45745. LaTeX Warning: Hyper reference `astInterval' on page 809 undefined on input lin e 45745. [809] LaTeX Warning: Hyper reference `Mapping' on page 810 undefined on input line 45 794. LaTeX Warning: Hyper reference `astIntraReg' on page 810 undefined on input lin e 45794. LaTeX Warning: Hyper reference `astIntraMap' on page 810 undefined on input lin e 45794. LaTeX Warning: Hyper reference `IntraFlag' on page 810 undefined on input line 45794. [810] LaTeX Warning: Hyper reference `KeyCase' on page 811 undefined on input line 45 912. LaTeX Warning: Hyper reference `Object' on page 811 undefined on input line 459 12. LaTeX Warning: Hyper reference `Mapping' on page 811 undefined on input line 45 912. LaTeX Warning: Hyper reference `astKeyMap' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `KeyCase' on page 811 undefined on input line 45 912. LaTeX Warning: Hyper reference `KeyError' on page 811 undefined on input line 4 5912. LaTeX Warning: Hyper reference `Report' on page 811 undefined on input line 459 12. LaTeX Warning: Hyper reference `SizeGuess' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `SortBy' on page 811 undefined on input line 459 12. LaTeX Warning: Hyper reference `MapLocked' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapDefined' on page 811 undefined on input l ine 45912. LaTeX Warning: Hyper reference `astMapGetC' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapGet0$<$X$>$' on page 811 undefined on inp ut line 45912. LaTeX Warning: Hyper reference `astMapGet1$<$X$>$' on page 811 undefined on inp ut line 45912. LaTeX Warning: Hyper reference `astMapGetElem$<$X$>$' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapHasKey' on page 811 undefined on input li ne 45912. LaTeX Warning: Hyper reference `astMapKey' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapLenC' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapLength' on page 811 undefined on input li ne 45912. LaTeX Warning: Hyper reference `astMapCopy' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 811 undefined on inp ut line 45912. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 811 undefined on inp ut line 45912. LaTeX Warning: Hyper reference `astMapPutElem$<$X$>$' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapPutU' on page 811 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapRemove' on page 811 undefined on input li ne 45912. [811] LaTeX Warning: Hyper reference `astMapRename' on page 812 undefined on input li ne 45912. LaTeX Warning: Hyper reference `astMapSize' on page 812 undefined on input line 45912. LaTeX Warning: Hyper reference `astMapType' on page 812 undefined on input line 45912. [812] LaTeX Warning: Hyper reference `Mapping' on page 813 undefined on input line 45 971. LaTeX Warning: Hyper reference `astLutMap' on page 813 undefined on input line 45971. LaTeX Warning: Hyper reference `LutEpsilon' on page 813 undefined on input line 45971. LaTeX Warning: Hyper reference `LutInterp' on page 813 undefined on input line 45971. [813] LaTeX Warning: Hyper reference `Object' on page 814 undefined on input line 460 90. LaTeX Warning: Hyper reference `Invert' on page 814 undefined on input line 460 90. LaTeX Warning: Hyper reference `IsLinear' on page 814 undefined on input line 4 6090. LaTeX Warning: Hyper reference `IsSimple' on page 814 undefined on input line 4 6090. LaTeX Warning: Hyper reference `Nin' on page 814 undefined on input line 46090. LaTeX Warning: Hyper reference `Nout' on page 814 undefined on input line 46090 . LaTeX Warning: Hyper reference `Report' on page 814 undefined on input line 460 90. LaTeX Warning: Hyper reference `TranForward' on page 814 undefined on input lin e 46090. LaTeX Warning: Hyper reference `TranInverse' on page 814 undefined on input lin e 46090. LaTeX Warning: Hyper reference `astDecompose' on page 814 undefined on input li ne 46090. LaTeX Warning: Hyper reference `astTranGrid' on page 814 undefined on input lin e 46090. LaTeX Warning: Hyper reference `astInvert' on page 814 undefined on input line 46090. LaTeX Warning: Hyper reference `astLinearApprox' on page 814 undefined on input line 46090. LaTeX Warning: Hyper reference `astMapBox' on page 814 undefined on input line 46090. LaTeX Warning: Hyper reference `astMapSplit' on page 814 undefined on input lin e 46090. LaTeX Warning: Hyper reference `astQuadApprox' on page 814 undefined on input l ine 46090. LaTeX Warning: Hyper reference `astRate' on page 814 undefined on input line 46 090. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 814 undefined on input line 46090. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 814 undefined on in put line 46090. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 814 undefined on in put line 46090. LaTeX Warning: Hyper reference `astRemoveRegions' on page 814 undefined on inpu t line 46090. LaTeX Warning: Hyper reference `astSimplify' on page 814 undefined on input lin e 46090. LaTeX Warning: Hyper reference `astTran1' on page 814 undefined on input line 4 6090. [814] LaTeX Warning: Hyper reference `astTran2' on page 815 undefined on input line 4 6090. LaTeX Warning: Hyper reference `astTranN' on page 815 undefined on input line 4 6090. LaTeX Warning: Hyper reference `astTranP' on page 815 undefined on input line 4 6090. [815] LaTeX Warning: Hyper reference `Mapping' on page 816 undefined on input line 46 139. LaTeX Warning: Hyper reference `IntraMap' on page 816 undefined on input line 4 6139. LaTeX Warning: Hyper reference `astMathMap' on page 816 undefined on input line 46139. LaTeX Warning: Hyper reference `Seed' on page 816 undefined on input line 46139 . LaTeX Warning: Hyper reference `SimpFI' on page 816 undefined on input line 461 39. LaTeX Warning: Hyper reference `SimpIF' on page 816 undefined on input line 461 39. [816] LaTeX Warning: Hyper reference `Mapping' on page 817 undefined on input line 46 173. LaTeX Warning: Hyper reference `astMatrixMap' on page 817 undefined on input li ne 46173. [817] LaTeX Warning: Hyper reference `Mapping' on page 818 undefined on input line 46 217. LaTeX Warning: Hyper reference `astNorm' on page 818 undefined on input line 46 217. LaTeX Warning: Hyper reference `Frame' on page 818 undefined on input line 4621 7. LaTeX Warning: Hyper reference `astSimplify' on page 818 undefined on input lin e 46217. LaTeX Warning: Hyper reference `UnitMap' on page 818 undefined on input line 46 217. LaTeX Warning: Hyper reference `CmpMap' on page 818 undefined on input line 462 17. LaTeX Warning: Hyper reference `astNormMap' on page 818 undefined on input line 46217. [818] LaTeX Warning: Hyper reference `Region' on page 819 undefined on input line 462 50. LaTeX Warning: Hyper reference `Frame' on page 819 undefined on input line 4625 0. LaTeX Warning: Hyper reference `Negated' on page 819 undefined on input line 46 250. LaTeX Warning: Hyper reference `astNullRegion' on page 819 undefined on input l ine 46250. [819] LaTeX Warning: Hyper reference `Class' on page 820 undefined on input line 4639 0. LaTeX Warning: Hyper reference `ID' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `Ident' on page 820 undefined on input line 4639 0. LaTeX Warning: Hyper reference `Nobject' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `ObjSize' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `RefCount' on page 820 undefined on input line 4 6390. LaTeX Warning: Hyper reference `UseDefs' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `astAnnul' on page 820 undefined on input line 4 6390. LaTeX Warning: Hyper reference `astBegin' on page 820 undefined on input line 4 6390. LaTeX Warning: Hyper reference `astClear' on page 820 undefined on input line 4 6390. LaTeX Warning: Hyper reference `astClone' on page 820 undefined on input line 4 6390. LaTeX Warning: Hyper reference `astCopy' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `astCreatedAt' on page 820 undefined on input li ne 46390. LaTeX Warning: Hyper reference `astDelete' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astEnd' on page 820 undefined on input line 463 90. LaTeX Warning: Hyper reference `astEscapes' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astExempt' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astExport' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 820 undefined on input l ine 46390. LaTeX Warning: Hyper reference `astHasAttribute' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astImport' on page 820 undefined on input line 46390. LaTeX Warning: Hyper reference `astIsA$<$Class$>$' on page 820 undefined on inp ut line 46390. LaTeX Warning: Hyper reference `astLock' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `astToString' on page 820 undefined on input lin e 46390. LaTeX Warning: Hyper reference `astSame' on page 820 undefined on input line 46 390. LaTeX Warning: Hyper reference `astSet' on page 820 undefined on input line 463 90. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 820 undefined on input l ine 46390. [820] LaTeX Warning: Hyper reference `astShow' on page 821 undefined on input line 46 390. LaTeX Warning: Hyper reference `astTest' on page 821 undefined on input line 46 390. LaTeX Warning: Hyper reference `astTune' on page 821 undefined on input line 46 390. LaTeX Warning: Hyper reference `astTuneC' on page 821 undefined on input line 4 6390. LaTeX Warning: Hyper reference `astUnlock' on page 821 undefined on input line 46390. LaTeX Warning: Hyper reference `astFromString' on page 821 undefined on input l ine 46390. LaTeX Warning: Hyper reference `astVersion' on page 821 undefined on input line 46390. [821] LaTeX Warning: Hyper reference `Mapping' on page 822 undefined on input line 46 447. LaTeX Warning: Hyper reference `Disco' on page 822 undefined on input line 4644 7. LaTeX Warning: Hyper reference `astPcdMap' on page 822 undefined on input line 46447. LaTeX Warning: Hyper reference `Disco' on page 822 undefined on input line 4644 7. LaTeX Warning: Hyper reference `PcdCen(axis)' on page 822 undefined on input li ne 46447. [822] LaTeX Warning: Hyper reference `Mapping' on page 823 undefined on input line 46 483. LaTeX Warning: Hyper reference `astPermMap' on page 823 undefined on input line 46483. [823] LaTeX Warning: Hyper reference `FrameSet' on page 824 undefined on input line 4 6792. LaTeX Warning: Hyper reference `Frame' on page 824 undefined on input line 4679 2. LaTeX Warning: Hyper reference `Mapping' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `astCurve' on page 824 undefined on input line 4 6792. LaTeX Warning: Hyper reference `astGenCurve' on page 824 undefined on input lin e 46792. LaTeX Warning: Hyper reference `astPolyCurve' on page 824 undefined on input li ne 46792. LaTeX Warning: Hyper reference `astMark' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `astText' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `astGridLine' on page 824 undefined on input lin e 46792. LaTeX Warning: Hyper reference `astGrid' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `Current' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `astClip' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `astPlot' on page 824 undefined on input line 46 792. LaTeX Warning: Hyper reference `Border' on page 824 undefined on input line 467 92. LaTeX Warning: Hyper reference `Clip' on page 824 undefined on input line 46792 . LaTeX Warning: Hyper reference `ClipOp' on page 824 undefined on input line 467 92. LaTeX Warning: Hyper reference `Colour(element)' on page 824 undefined on input line 46792. LaTeX Warning: Hyper reference `DrawAxes(axis)' on page 824 undefined on input line 46792. LaTeX Warning: Hyper reference `DrawTitle' on page 824 undefined on input line 46792. LaTeX Warning: Hyper reference `Escape' on page 824 undefined on input line 467 92. LaTeX Warning: Hyper reference `Edge(axis)' on page 824 undefined on input line 46792. LaTeX Warning: Hyper reference `Font(element)' on page 824 undefined on input l ine 46792. [824] LaTeX Warning: Hyper reference `Gap(axis)' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `Interval' on page 825 undefined on input line 4 6792. LaTeX Warning: Hyper reference `Grf' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `Grid' on page 825 undefined on input line 46792 . LaTeX Warning: Hyper reference `Invisible' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `LabelAt(axis)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `LabelUp(axis)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `Labelling' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `LogGap(axis)' on page 825 undefined on input li ne 46792. LaTeX Warning: Hyper reference `LogPlot(axis)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `LogTicks(axis)' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `MajTickLen(axis)' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `MinTickLen(axis)' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `MinTick(axis)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `NumLab(axis)' on page 825 undefined on input li ne 46792. LaTeX Warning: Hyper reference `NumLabGap(axis)' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `Size(element)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `Style(element)' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `TextLab(axis)' on page 825 undefined on input l ine 46792. LaTeX Warning: Hyper reference `TextLabGap(axis)' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `TickAll' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `TitleGap' on page 825 undefined on input line 4 6792. LaTeX Warning: Hyper reference `Tol' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `Width(element)' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astBBuf' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `astBorder' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astBoundingBox' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astClip' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `astCurve' on page 825 undefined on input line 4 6792. LaTeX Warning: Hyper reference `astEBuf' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `astGenCurve' on page 825 undefined on input lin e 46792. LaTeX Warning: Hyper reference `astGetGrfContext' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `astGrfPop' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astGrfPush' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astGrfSet' on page 825 undefined on input line 46792. LaTeX Warning: Hyper reference `astGrid' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `astGridLine' on page 825 undefined on input lin e 46792. LaTeX Warning: Hyper reference `astMark' on page 825 undefined on input line 46 792. LaTeX Warning: Hyper reference `astPolyCurve' on page 825 undefined on input li ne 46792. LaTeX Warning: Hyper reference `astRegionOutline' on page 825 undefined on inpu t line 46792. LaTeX Warning: Hyper reference `Region' on page 825 undefined on input line 467 92. [825] LaTeX Warning: Hyper reference `astText' on page 826 undefined on input line 46 792. LaTeX Warning: Hyper reference `Axis' on page 826 undefined on input line 46792 . LaTeX Warning: Hyper reference `Title' on page 826 undefined on input line 4679 2. [826] LaTeX Warning: Hyper reference `Plot' on page 827 undefined on input line 46913 . LaTeX Warning: Hyper reference `Frame' on page 827 undefined on input line 4691 3. LaTeX Warning: Hyper reference `ast_link' on page 827 undefined on input line 4 6913. LaTeX Warning: Hyper reference `Current' on page 827 undefined on input line 46 913. LaTeX Warning: Hyper reference `FrameSet' on page 827 undefined on input line 4 6913. LaTeX Warning: Hyper reference `Mapping' on page 827 undefined on input line 46 913. LaTeX Warning: Hyper reference `astClip' on page 827 undefined on input line 46 913. LaTeX Warning: Hyper reference `astGrfSet' on page 827 undefined on input line 46913. LaTeX Warning: Hyper reference `astGrfPop' on page 827 undefined on input line 46913. LaTeX Warning: Hyper reference `astGrfPush' on page 827 undefined on input line 46913. LaTeX Warning: Hyper reference `astGetGrfContext' on page 827 undefined on inpu t line 46913. LaTeX Warning: Hyper reference `astPlot3D' on page 827 undefined on input line 46913. [827] LaTeX Warning: Hyper reference `RootCorner' on page 828 undefined on input line 46913. LaTeX Warning: Hyper reference `DrawTitle' on page 828 undefined on input line 46913. LaTeX Warning: Hyper reference `TitleGap' on page 828 undefined on input line 4 6913. LaTeX Warning: Hyper reference `Grid' on page 828 undefined on input line 46913 . LaTeX Warning: Hyper reference `astBoundingBox' on page 828 undefined on input line 46913. LaTeX Warning: Hyper reference `astCurve' on page 828 undefined on input line 4 6913. LaTeX Warning: Hyper reference `astGenCurve' on page 828 undefined on input lin e 46913. LaTeX Warning: Hyper reference `astGridLine' on page 828 undefined on input lin e 46913. LaTeX Warning: Hyper reference `astPolyCurve' on page 828 undefined on input li ne 46913. [828] LaTeX Warning: Hyper reference `Region' on page 829 undefined on input line 469 49. LaTeX Warning: Hyper reference `Frame' on page 829 undefined on input line 4694 9. LaTeX Warning: Hyper reference `astPointList' on page 829 undefined on input li ne 46949. LaTeX Warning: Hyper reference `ListSize' on page 829 undefined on input line 4 6949. [829] LaTeX Warning: Hyper reference `Mapping' on page 830 undefined on input line 47 006. LaTeX Warning: Hyper reference `IterInverse' on page 830 undefined on input lin e 47006. LaTeX Warning: Hyper reference `astPolyMap' on page 830 undefined on input line 47006. LaTeX Warning: Hyper reference `IterInverse' on page 830 undefined on input lin e 47006. LaTeX Warning: Hyper reference `NiterInverse' on page 830 undefined on input li ne 47006. LaTeX Warning: Hyper reference `TolInverse' on page 830 undefined on input line 47006. LaTeX Warning: Hyper reference `astPolyCoeffs' on page 830 undefined on input l ine 47006. LaTeX Warning: Hyper reference `astPolyTran' on page 830 undefined on input lin e 47006. [830] LaTeX Warning: Hyper reference `Frame' on page 831 undefined on input line 4707 2. LaTeX Warning: Hyper reference `SkyFrame' on page 831 undefined on input line 4 7072. LaTeX Warning: Hyper reference `astPolygon' on page 831 undefined on input line 47072. LaTeX Warning: Hyper reference `Region' on page 831 undefined on input line 470 72. LaTeX Warning: Hyper reference `SimpVertices' on page 831 undefined on input li ne 47072. LaTeX Warning: Hyper reference `astDownsize' on page 831 undefined on input lin e 47072. LaTeX Warning: Hyper reference `astConvex$<$X$>$' on page 831 undefined on inpu t line 47072. LaTeX Warning: Hyper reference `astOutline$<$X$>$' on page 831 undefined on inp ut line 47072. [831] LaTeX Warning: Hyper reference `Region' on page 832 undefined on input line 471 12. LaTeX Warning: Hyper reference `Circle' on page 832 undefined on input line 471 12. LaTeX Warning: Hyper reference `Interval' on page 832 undefined on input line 4 7112. LaTeX Warning: Hyper reference `astPrism' on page 832 undefined on input line 4 7112. [832] LaTeX Warning: Hyper reference `Mapping' on page 833 undefined on input line 47 155. LaTeX Warning: Hyper reference `astRateMap' on page 833 undefined on input line 47155. [833] LaTeX Warning: Hyper reference `Circle' on page 834 undefined on input line 473 15. LaTeX Warning: Hyper reference `Box' on page 834 undefined on input line 47315. LaTeX Warning: Hyper reference `Frame' on page 834 undefined on input line 4731 5. LaTeX Warning: Hyper reference `astFormat' on page 834 undefined on input line 47315. LaTeX Warning: Hyper reference `Mapping' on page 834 undefined on input line 47 315. LaTeX Warning: Hyper reference `UnitMap' on page 834 undefined on input line 47 315. LaTeX Warning: Hyper reference `astRemoveRegions' on page 834 undefined on inpu t line 47315. LaTeX Warning: Hyper reference `FrameSet' on page 834 undefined on input line 4 7315. LaTeX Warning: Hyper reference `SkyFrame' on page 834 undefined on input line 4 7315. LaTeX Warning: Hyper reference `System' on page 834 undefined on input line 473 15. LaTeX Warning: Hyper reference `astSimplify' on page 834 undefined on input lin e 47315. [834] LaTeX Warning: Hyper reference `Adaptive' on page 835 undefined on input line 4 7315. LaTeX Warning: Hyper reference `Negated' on page 835 undefined on input line 47 315. LaTeX Warning: Hyper reference `Closed' on page 835 undefined on input line 473 15. LaTeX Warning: Hyper reference `MeshSize' on page 835 undefined on input line 4 7315. LaTeX Warning: Hyper reference `FillFactor' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `Bounded' on page 835 undefined on input line 47 315. LaTeX Warning: Hyper reference `Equinox' on page 835 undefined on input line 47 315. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 835 undefined on in put line 47315. LaTeX Warning: Hyper reference `astGetRegionFrame' on page 835 undefined on inp ut line 47315. LaTeX Warning: Hyper reference `astGetRegionFrameSet' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 835 undefined on inpu t line 47315. LaTeX Warning: Hyper reference `astGetRegionPoints' on page 835 undefined on in put line 47315. LaTeX Warning: Hyper reference `astGetUnc' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astMapRegion' on page 835 undefined on input li ne 47315. LaTeX Warning: Hyper reference `astNegate' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astOverlap' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astMask$<$X$>$' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astSetUnc' on page 835 undefined on input line 47315. LaTeX Warning: Hyper reference `astShowMesh' on page 835 undefined on input lin e 47315. [835] LaTeX Warning: Hyper reference `Mapping' on page 836 undefined on input line 47 369. LaTeX Warning: Hyper reference `Region' on page 836 undefined on input line 473 69. LaTeX Warning: Hyper reference `Frame' on page 836 undefined on input line 4736 9. LaTeX Warning: Hyper reference `Nin' on page 836 undefined on input line 47369. LaTeX Warning: Hyper reference `UnitMap' on page 836 undefined on input line 47 369. LaTeX Warning: Hyper reference `astSimplify' on page 836 undefined on input lin e 47369. LaTeX Warning: Hyper reference `astSelectorMap' on page 836 undefined on input line 47369. [836] LaTeX Warning: Hyper reference `Mapping' on page 837 undefined on input line 47 399. LaTeX Warning: Hyper reference `astShiftMap' on page 837 undefined on input lin e 47399. [837] LaTeX Warning: Hyper reference `SkyFrame' on page 838 undefined on input line 4 7419. LaTeX Warning: Hyper reference `astWrite' on page 838 undefined on input line 4 7419. LaTeX Warning: Hyper reference `Axis' on page 838 undefined on input line 47419 . [838] LaTeX Warning: Hyper reference `Frame' on page 839 undefined on input line 4752 2. LaTeX Warning: Hyper reference `System' on page 839 undefined on input line 475 22. LaTeX Warning: Hyper reference `Equinox' on page 839 undefined on input line 47 522. LaTeX Warning: Hyper reference `Epoch' on page 839 undefined on input line 4752 2. LaTeX Warning: Hyper reference `SkyRefIs' on page 839 undefined on input line 4 7522. LaTeX Warning: Hyper reference `AlignOffset' on page 839 undefined on input lin e 47522. LaTeX Warning: Hyper reference `astFormat' on page 839 undefined on input line 47522. LaTeX Warning: Hyper reference `astSkyFrame' on page 839 undefined on input lin e 47522. LaTeX Warning: Hyper reference `AlignOffset' on page 839 undefined on input lin e 47522. LaTeX Warning: Hyper reference `AsTime(axis)' on page 839 undefined on input li ne 47522. LaTeX Warning: Hyper reference `Equinox' on page 839 undefined on input line 47 522. LaTeX Warning: Hyper reference `LatAxis' on page 839 undefined on input line 47 522. LaTeX Warning: Hyper reference `LonAxis' on page 839 undefined on input line 47 522. LaTeX Warning: Hyper reference `NegLon' on page 839 undefined on input line 475 22. LaTeX Warning: Hyper reference `Projection' on page 839 undefined on input line 47522. LaTeX Warning: Hyper reference `SkyRefIs' on page 839 undefined on input line 4 7522. LaTeX Warning: Hyper reference `SkyTol' on page 839 undefined on input line 475 22. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 839 undefined on input line 47522. LaTeX Warning: Hyper reference `Mapping' on page 839 undefined on input line 47 522. [839] LaTeX Warning: Hyper reference `Mapping' on page 840 undefined on input line 47 571. LaTeX Warning: Hyper reference `astSlaAdd' on page 840 undefined on input line 47571. LaTeX Warning: Hyper reference `astSlaMap' on page 840 undefined on input line 47571. LaTeX Warning: Hyper reference `astSlaAdd' on page 840 undefined on input line 47571. [840] LaTeX Warning: Hyper reference `SpecFrame' on page 841 undefined on input line 47609. LaTeX Warning: Hyper reference `FluxFrame' on page 841 undefined on input line 47609. LaTeX Warning: Hyper reference `Frame' on page 841 undefined on input line 4760 9. LaTeX Warning: Hyper reference `Plot' on page 841 undefined on input line 47609 . LaTeX Warning: Hyper reference `astSpecFluxFrame' on page 841 undefined on inpu t line 47609. LaTeX Warning: Hyper reference `CmpFrame' on page 841 undefined on input line 4 7609. LaTeX Warning: Hyper reference `StdOfRest' on page 841 undefined on input line 47609. [841] LaTeX Warning: Hyper reference `Frame' on page 842 undefined on input line 4769 7. LaTeX Warning: Hyper reference `System' on page 842 undefined on input line 476 97. LaTeX Warning: Hyper reference `SpecOrigin' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `astSpecFrame' on page 842 undefined on input li ne 47697. LaTeX Warning: Hyper reference `AlignSpecOffset' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `RefDec' on page 842 undefined on input line 476 97. LaTeX Warning: Hyper reference `RefRA' on page 842 undefined on input line 4769 7. LaTeX Warning: Hyper reference `RestFreq' on page 842 undefined on input line 4 7697. LaTeX Warning: Hyper reference `SourceSys' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `SourceVel' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `SourceVRF' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `SpecOrigin' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `StdOfRest' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `Unit(axis)' on page 842 undefined on input line 47697. LaTeX Warning: Hyper reference `Label(axis)' on page 842 undefined on input lin e 47697. LaTeX Warning: Hyper reference `astSetRefPos' on page 842 undefined on input li ne 47697. LaTeX Warning: Hyper reference `astGetRefPos' on page 842 undefined on input li ne 47697. [842] LaTeX Warning: Hyper reference `Mapping' on page 843 undefined on input line 47 758. LaTeX Warning: Hyper reference `astSpecAdd' on page 843 undefined on input line 47758. LaTeX Warning: Hyper reference `astSpecMap' on page 843 undefined on input line 47758. LaTeX Warning: Hyper reference `astSpecAdd' on page 843 undefined on input line 47758. [843] LaTeX Warning: Hyper reference `Mapping' on page 844 undefined on input line 47 803. LaTeX Warning: Hyper reference `astSphMap' on page 844 undefined on input line 47803. LaTeX Warning: Hyper reference `UnitRadius' on page 844 undefined on input line 47803. LaTeX Warning: Hyper reference `PolarLong' on page 844 undefined on input line 47803. [844] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 845 undefined on input line 47858. LaTeX Warning: Hyper reference `StcResourceProfile' on page 845 undefined on in put line 47858. LaTeX Warning: Hyper reference `StcSearchLocation' on page 845 undefined on inp ut line 47858. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 845 undefined on in put line 47858. LaTeX Warning: Hyper reference `Region' on page 845 undefined on input line 478 58. LaTeX Warning: Hyper reference `RegionClass' on page 845 undefined on input lin e 47858. LaTeX Warning: Hyper reference `astGetStcRegion' on page 845 undefined on input line 47858. LaTeX Warning: Hyper reference `astGetStcCoord' on page 845 undefined on input line 47858. LaTeX Warning: Hyper reference `astGetStcNCoord' on page 845 undefined on input line 47858. [845] LaTeX Warning: Hyper reference `Stc' on page 846 undefined on input line 47890. LaTeX Warning: Hyper reference `astStcCatalogEntryLocation' on page 846 undefin ed on input line 47890. [846] LaTeX Warning: Hyper reference `Stc' on page 847 undefined on input line 47941. LaTeX Warning: Hyper reference `Frame' on page 847 undefined on input line 4794 1. LaTeX Warning: Hyper reference `ObsLon' on page 847 undefined on input line 479 41. LaTeX Warning: Hyper reference `ObsLat' on page 847 undefined on input line 479 41. LaTeX Warning: Hyper reference `astStcObsDataLocation' on page 847 undefined on input line 47941. [847] LaTeX Warning: Hyper reference `Stc' on page 848 undefined on input line 47973. LaTeX Warning: Hyper reference `astStcResourceProfile' on page 848 undefined on input line 47973. [848] LaTeX Warning: Hyper reference `Stc' on page 849 undefined on input line 48005. LaTeX Warning: Hyper reference `astStcSearchLocation' on page 849 undefined on input line 48005. [849] LaTeX Warning: Hyper reference `Channel' on page 850 undefined on input line 48 167. LaTeX Warning: Hyper reference `Object' on page 850 undefined on input line 481 67. LaTeX Warning: Hyper reference `astWrite' on page 850 undefined on input line 4 8167. LaTeX Warning: Hyper reference `astRead' on page 850 undefined on input line 48 167. LaTeX Warning: Hyper reference `PointList' on page 850 undefined on input line 48167. LaTeX Warning: Hyper reference `Region' on page 850 undefined on input line 481 67. LaTeX Warning: Hyper reference `KeyMap' on page 850 undefined on input line 481 67. LaTeX Warning: Hyper reference `StcsArea' on page 850 undefined on input line 4 8167. LaTeX Warning: Hyper reference `StcsCoords' on page 850 undefined on input line 48167. LaTeX Warning: Hyper reference `StcsProps' on page 850 undefined on input line 48167. LaTeX Warning: Hyper reference `XmlChan' on page 850 undefined on input line 48 167. LaTeX Warning: Hyper reference `SinkFile' on page 850 undefined on input line 4 8167. LaTeX Warning: Hyper reference `SourceFile' on page 850 undefined on input line 48167. LaTeX Warning: Hyper reference `TimeFrame' on page 850 undefined on input line 48167. LaTeX Warning: Hyper reference `SkyFrame' on page 850 undefined on input line 4 8167. [850] Overfull \hbox (7.12534pt too wide) in paragraph at lines 48167--48167 \T1/ppl/m/n/10 (-20) CAL_GROUP_CENTER, UN-KNOWN-Ref-Pos, EM-BARYCEN-TER, MOON, MER-CURY, VENUS, LaTeX Warning: Hyper reference `astStcsChan' on page 851 undefined on input lin e 48167. LaTeX Warning: Hyper reference `StcsArea' on page 851 undefined on input line 4 8167. LaTeX Warning: Hyper reference `StcsCoords' on page 851 undefined on input line 48167. LaTeX Warning: Hyper reference `StcsLength' on page 851 undefined on input line 48167. LaTeX Warning: Hyper reference `StcsProps' on page 851 undefined on input line 48167. [851] LaTeX Warning: Hyper reference `Mapping' on page 852 undefined on input line 48 256. LaTeX Warning: Hyper reference `Nin' on page 852 undefined on input line 48256. LaTeX Warning: Hyper reference `Nout' on page 852 undefined on input line 48256 . LaTeX Warning: Hyper reference `SelectorMap' on page 852 undefined on input lin e 48256. LaTeX Warning: Hyper reference `UnitMap' on page 852 undefined on input line 48 256. LaTeX Warning: Hyper reference `astSimplify' on page 852 undefined on input lin e 48256. LaTeX Warning: Hyper reference `astSwitchMap' on page 852 undefined on input li ne 48256. [852] [853] LaTeX Warning: Hyper reference `KeyMap' on page 854 undefined on input line 483 79. LaTeX Warning: Hyper reference `astAddColumn' on page 854 undefined on input li ne 48379. LaTeX Warning: Hyper reference `astAddParameter' on page 854 undefined on input line 48379. LaTeX Warning: Hyper reference `astTable' on page 854 undefined on input line 4 8379. LaTeX Warning: Hyper reference `ColumnLenC(column)' on page 854 undefined on in put line 48379. LaTeX Warning: Hyper reference `ColumnLength(column)' on page 854 undefined on input line 48379. LaTeX Warning: Hyper reference `ColumnNdim(column)' on page 854 undefined on in put line 48379. LaTeX Warning: Hyper reference `ColumnType(column)' on page 854 undefined on in put line 48379. LaTeX Warning: Hyper reference `Ncolumn' on page 854 undefined on input line 48 379. LaTeX Warning: Hyper reference `Nrow' on page 854 undefined on input line 48379 . LaTeX Warning: Hyper reference `Nparameter' on page 854 undefined on input line 48379. LaTeX Warning: Hyper reference `astAddColumn' on page 854 undefined on input li ne 48379. LaTeX Warning: Hyper reference `astAddParameter' on page 854 undefined on input line 48379. LaTeX Warning: Hyper reference `astColumnName' on page 854 undefined on input l ine 48379. LaTeX Warning: Hyper reference `astColumnShape' on page 854 undefined on input line 48379. LaTeX Warning: Hyper reference `astHasColumn' on page 854 undefined on input li ne 48379. [854] LaTeX Warning: Hyper reference `astHasParameter' on page 855 undefined on input line 48379. LaTeX Warning: Hyper reference `astParameterName' on page 855 undefined on inpu t line 48379. LaTeX Warning: Hyper reference `astPurgeRows' on page 855 undefined on input li ne 48379. LaTeX Warning: Hyper reference `astRemoveColumn' on page 855 undefined on input line 48379. LaTeX Warning: Hyper reference `astRemoveParameter' on page 855 undefined on in put line 48379. LaTeX Warning: Hyper reference `astRemoveRow' on page 855 undefined on input li ne 48379. [855] LaTeX Warning: Hyper reference `Frame' on page 856 undefined on input line 4846 3. LaTeX Warning: Hyper reference `System' on page 856 undefined on input line 484 63. LaTeX Warning: Hyper reference `TimeOrigin' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `TimeScale' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `astTimeFrame' on page 856 undefined on input li ne 48463. LaTeX Warning: Hyper reference `AlignTimeScale' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `LTOffset' on page 856 undefined on input line 4 8463. LaTeX Warning: Hyper reference `TimeOrigin' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `TimeScale' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `Unit(axis)' on page 856 undefined on input line 48463. LaTeX Warning: Hyper reference `Label(axis)' on page 856 undefined on input lin e 48463. LaTeX Warning: Hyper reference `astCurrentTime' on page 856 undefined on input line 48463. [856] LaTeX Warning: Hyper reference `Mapping' on page 857 undefined on input line 48 510. LaTeX Warning: Hyper reference `astTimeAdd' on page 857 undefined on input line 48510. LaTeX Warning: Hyper reference `astTimeMap' on page 857 undefined on input line 48510. LaTeX Warning: Hyper reference `astTimeAdd' on page 857 undefined on input line 48510. [857] LaTeX Warning: Hyper reference `Mapping' on page 858 undefined on input line 48 549. LaTeX Warning: Hyper reference `astTranMap' on page 858 undefined on input line 48549. [858] LaTeX Warning: Hyper reference `Mapping' on page 859 undefined on input line 48 583. LaTeX Warning: Hyper reference `Nin' on page 859 undefined on input line 48583. LaTeX Warning: Hyper reference `Nout' on page 859 undefined on input line 48583 . LaTeX Warning: Hyper reference `astUnitMap' on page 859 undefined on input line 48583. [859] LaTeX Warning: Hyper reference `Nin' on page 860 undefined on input line 48640. LaTeX Warning: Hyper reference `astUnitNormMap' on page 860 undefined on input line 48640. LaTeX Warning: Hyper reference `Mapping' on page 860 undefined on input line 48 640. [860] LaTeX Warning: Hyper reference `Mapping' on page 861 undefined on input line 48 729. LaTeX Warning: Hyper reference `WcsType' on page 861 undefined on input line 48 729. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 861 undefined on input line 48729. LaTeX Warning: Hyper reference `PVi_m' on page 861 undefined on input line 4872 9. LaTeX Warning: Hyper reference `astWcsMap' on page 861 undefined on input line 48729. LaTeX Warning: Hyper reference `NatLat' on page 861 undefined on input line 487 29. LaTeX Warning: Hyper reference `NatLon' on page 861 undefined on input line 487 29. LaTeX Warning: Hyper reference `PVi_m' on page 861 undefined on input line 4872 9. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 861 undefined on input line 48729. LaTeX Warning: Hyper reference `WcsType' on page 861 undefined on input line 48 729. [861] [862] LaTeX Warning: Hyper reference `Mapping' on page 863 undefined on input line 48 765. LaTeX Warning: Hyper reference `astWinMap' on page 863 undefined on input line 48765. [863] LaTeX Warning: Hyper reference `Channel' on page 864 undefined on input line 48 822. LaTeX Warning: Hyper reference `Object' on page 864 undefined on input line 488 22. LaTeX Warning: Hyper reference `astWrite' on page 864 undefined on input line 4 8822. LaTeX Warning: Hyper reference `SinkFile' on page 864 undefined on input line 4 8822. LaTeX Warning: Hyper reference `SourceFile' on page 864 undefined on input line 48822. LaTeX Warning: Hyper reference `astXmlChan' on page 864 undefined on input line 48822. LaTeX Warning: Hyper reference `XmlFormat' on page 864 undefined on input line 48822. LaTeX Warning: Hyper reference `System' on page 864 undefined on input line 488 22. LaTeX Warning: Hyper reference `XmlLength' on page 864 undefined on input line 48822. LaTeX Warning: Hyper reference `XmlPrefix' on page 864 undefined on input line 48822. [864] LaTeX Warning: Hyper reference `Mapping' on page 865 undefined on input line 48 861. LaTeX Warning: Hyper reference `astZoomMap' on page 865 undefined on input line 48861. LaTeX Warning: Hyper reference `Zoom' on page 865 undefined on input line 48861 . [865] [866] [867] Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 LaTeX Warning: Hyper reference `System' on page 868 undefined on input line 490 40. [868] [869] LaTeX Warning: Hyper reference `ast_link' on page 870 undefined on input line 4 9205. Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 [870] LaTeX Warning: Hyper reference `System' on page 871 undefined on input line 492 05. [871] [872] LaTeX Warning: Hyper reference `astMalloc' on page 873 undefined on input line 49212. LaTeX Warning: Hyper reference `astFree' on page 873 undefined on input line 49 213. LaTeX Warning: Hyper reference `astRealloc' on page 873 undefined on input line 49213. LaTeX Warning: Hyper reference `astStore' on page 873 undefined on input line 4 9225. LaTeX Warning: Hyper reference `astGrow' on page 873 undefined on input line 49 228. LaTeX Warning: Hyper reference `astAppendString' on page 873 undefined on input line 49229. [873] Overfull \hbox (5.62103pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 Pointer to the null-terminated dynamic string, whose memory has been allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 using an AST memory allocation function. If no space has yet be en allocated for Overfull \hbox (0.10988pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 this string, a NULL pointer may be given and fresh space will b e allocated by Overfull \hbox (10.86975pt too wide) in paragraph at lines 49327--49327 [] \T1/cmtt/m/n/10 Pointer to an integer containing the number of characters in the dynamic string Overfull \hbox (31.33975pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 (excluding the final null). This is used to save repeated searc hing of this string Overfull \hbox (0.37231pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 to determine its length and it defines the point where the new string will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 appended. Its value is updated by this function to include the extra characters Overfull \hbox (0.5835pt too wide) in paragraph at lines 49327--49327 []\T1/cmtt/m/n/10 If " str1" is NULL, the initial value supplied for " $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 nc" will be ignored and Overfull \hbox (10.86975pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 Pointer to a constant null-terminated string, a copy of which i s to be appended LaTeX Warning: Hyper reference `astFree' on page 874 undefined on input line 49 327. Overfull \hbox (28.50703pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 A possibly new pointer to the dynamic string with the new strin g appended (its location Overfull \hbox (33.75575pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 in memory may have to change if it has to be extended, in which case the original memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 is automatically freed by this function). When the string is no longer required, its Overfull \hbox (21.36719pt too wide) in paragraph at lines 49327--49327 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t or if it should fail Overfull \hbox (26.6159pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [874] LaTeX Warning: Hyper reference `astAppendString' on page 875 undefined on input line 49403. Overfull \hbox (5.62103pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 Pointer to the null-terminated dynamic string, whose memory has been allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 using an AST memory allocation function. If no space has yet be en allocated for Overfull \hbox (0.10988pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 this string, a NULL pointer may be given and fresh space will b e allocated by Overfull \hbox (10.86975pt too wide) in paragraph at lines 49403--49403 [] \T1/cmtt/m/n/10 Pointer to an integer containing the number of characters in the dynamic string Overfull \hbox (31.33975pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 (excluding the final null). This is used to save repeated searc hing of this string Overfull \hbox (0.37231pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 to determine its length and it defines the point where the new string will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 appended. Its value is updated by this function to include the extra characters Overfull \hbox (0.5835pt too wide) in paragraph at lines 49403--49403 []\T1/cmtt/m/n/10 If " str1" is NULL, the initial value supplied for " $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 nc" will be ignored and Overfull \hbox (10.86975pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 Pointer to a constant null-terminated string, a copy of which i s to be appended Overfull \hbox (37.11334pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (16.11847pt too wide) in paragraph at lines 49403--49403 [] \T1/cmtt/m/n/10 Additional optional arguments (as used by e.g. " printf" ) which specify values Overfull \hbox (64.66911pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 which are to be substituted into the " str2" string in place of any format specifications. Underfull \hbox (badness 10000) in paragraph at lines 49403--49403 LaTeX Warning: Hyper reference `astFree' on page 875 undefined on input line 49 403. Overfull \hbox (28.50703pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 A possibly new pointer to the dynamic string with the new strin g appended (its location Overfull \hbox (33.75575pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 in memory may have to change if it has to be extended, in which case the original memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 is automatically freed by this function). When the string is no longer required, its Overfull \hbox (21.36719pt too wide) in paragraph at lines 49403--49403 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t or if it should fail Overfull \hbox (26.6159pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [875] Overfull \hbox (21.10757pt too wide) in paragraph at lines 49524--49524 []\T1/cmtt/m/n/10 int astBrackets( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 text, size_t start, size_t end, char opchar, char clchar, Overfull \hbox (3.9529pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 int strip, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 openat, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 closeat, char $\OMS/zplm/m/n/10 ^ ^C$$^^C$\T1/cmtt/m/n/10 before, char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 in, char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 after Overfull \hbox (10.60732pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 The zero-based index of the first character to be checked withi n " text" . The Overfull \hbox (5.3586pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 The zero-based index of the last character to be checked within " text" . The Overfull \hbox (15.85603pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 whole string is used if " start" is greater than " end" . The l ast character is Overfull \hbox (16.11847pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 If non-zero, leading and trailing spaces are removed from the r eturned " before" Overfull \hbox (7.19565pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Returned holding the zero-based index of the opening bracket. I gnored if NULL. Overfull \hbox (7.19565pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Returned holding the zero-based index of the closing bracket. I gnored if NULL. LaTeX Warning: Hyper reference `astFree' on page 876 undefined on input line 49 524. Overfull \hbox (21.10475pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (10.86975pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came before the opening bracket. This will be a null string " " if the opening Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.36719pt too wide) in paragraph at lines 49524--49524 [] \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came between the opening and closing bracket. This will be a nu ll string " " Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 if the bracket was empty. The returned pointer should be freed using astFree Overfull \hbox (21.10475pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (5.62103pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came after the opening bracket. This will be a null string " " if the closing Overfull \hbox (26.6159pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [876] Overfull \hbox (7.51216pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 A value of 1 is returned if a correctly bracketed sub-string wa s found. A value of Overfull \hbox (18.27203pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 0 is returned if no bracketed sub-string was found. A value of -1 is returned if too Overfull \hbox (39.2669pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 many closing brackets were found. A value of -2 is returned if too many opening brackets Overfull \hbox (0.10988pt too wide) in paragraph at lines 49524--49524 [][]\T1/cmtt/m/n/10 Any nested brackets within a top-level bracketed sub-string are skipped. Any Overfull \hbox (5.62103pt too wide) in paragraph at lines 49524--49524 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [877] LaTeX Warning: Hyper reference `astMalloc' on page 878 undefined on input line 49572. Overfull \hbox (2.26344pt too wide) in paragraph at lines 49572--49572 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated memory Overfull \hbox (10.86975pt too wide) in paragraph at lines 49572--49572 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [878] Overfull \hbox (21.10475pt too wide) in paragraph at lines 49608--49608 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [879] LaTeX Warning: Hyper reference `astStringCase' on page 880 undefined on input l ine 49652. Overfull \hbox (42.36206pt too wide) in paragraph at lines 49652--49652 [] \T1/cmtt/m/n/10 Pointer to the null terminated string to be converted. If this is NULL, the supplied Overfull \hbox (21.10475pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 Pointer to the buffer to receive the converted string. The leng th of this buffer Overfull \hbox (21.36719pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 is given by " blen" . If NULL is supplied for " in" , then the supplied contents Overfull \hbox (5.62103pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 of " out" are converted and written back into " out" over-writi ng the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 If non-zero, the string is converted to upper case. Otherwise i t is converted Overfull \hbox (10.60732pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 The length of the output buffer. Ignored if " in" is NULL. No m ore than " blen Overfull \hbox (44.72398pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [880] [881] Overfull \hbox (10.13652pt too wide) in paragraph at lines 49703--49703 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [882] Overfull \hbox (0.10988pt too wide) in paragraph at lines 49744--49744 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [883] Overfull \hbox (0.10988pt too wide) in paragraph at lines 49790--49790 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [884] LaTeX Warning: Hyper reference `astChrClean' on page 885 undefined on input lin e 49811. [885] Overfull \hbox (7.72334pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (13.02332pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a word extracted Overfull \hbox (18.27203pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 from the supplied string. Each of these words will have no lead ing or trailing white Overfull \hbox (31.86462pt too wide) in paragraph at lines 49855--49855 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [886] Overfull \hbox (7.72334pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (13.02332pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a word extracted Overfull \hbox (31.86462pt too wide) in paragraph at lines 49909--49909 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [887] Overfull \hbox (35.49646pt too wide) in paragraph at lines 49983--49983 []\T1/cmtt/m/n/10 char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 astChrSplitRE ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 str, const char $\OMS/zplm/m /n/10 ^^C$\T1/cmtt/m/n/10 regexp, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 n, const char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 matchend LaTeX Warning: Hyper reference `astChrSub' on page 888 undefined on input line 49983. Overfull \hbox (23.72911pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 The regular expression. See " Template Syntax:" in the astChrSu b prologue. Note, Overfull \hbox (15.85603pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 this function differs from astChrSub in that any equals signs ( =) in the regular Overfull \hbox (26.35347pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A pointer to a location at which to return a pointer to the cha racter that follows Overfull \hbox (21.36719pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 the last character within the supplied test string that matched any parenthesises Overfull \hbox (12.44437pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 sub-section of " regexp" . A NULL pointer is returned if no mat ches were found. Overfull \hbox (15.85603pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A NULL pointer may be supplied if the location of the last matc hing character is LaTeX Warning: Hyper reference `astFree' on page 888 undefined on input line 49 983. Overfull \hbox (7.72334pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (44.51563pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a sub-string extracted Overfull \hbox (2.52588pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 from the supplied string. The array itself, and the strings wit hin it, should all Overfull \hbox (10.86975pt too wide) in paragraph at lines 49983--49983 [][]\T1/cmtt/m/n/10 If a parenthesised sub-string in the regular expression is matched by more than Overfull \hbox (26.6159pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 one sub-string within the test string, then only the first is r eturned. To return Overfull \hbox (5.62103pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 multiple matches, the regular expression should include multipl e copies of the Overfull \hbox (8.7222pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 parenthesised sub-string (for instance, separated by " .$\OT1/z plm/m/n/10 +$\T1/cmtt/m/n/10 ?" if the intervening Overfull \hbox (31.86462pt too wide) in paragraph at lines 49983--49983 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [888] Overfull \hbox (13.86804pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChrSub( const c har $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 test, const char $\OMS/zplm/m/n/10 ^^ C$\T1/cmtt/m/n/10 pattern, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 sub s[], int nsub Overfull \hbox (26.35347pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 An array of strings that are to replace the sections of the tes t string that match Overfull \hbox (37.11334pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 each parenthesised sub-string in " pattern" . The first element of " subs" replaces Overfull \hbox (5.62103pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 the part of the test string that matches the first parenthesise d sub-string in Overfull \hbox (37.11334pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 If " nsub" is zero, then the " subs" pointer is ignored. In t his case, substitution Overfull \hbox (2.99667pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 strings may be specified by appended them to the end of the " p attern" string, Overfull \hbox (36.8509pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 separated by " =" characters. Note, if you need to include a li teral " =" character LaTeX Warning: Hyper reference `astFree' on page 889 undefined on input line 50 118. Overfull \hbox (10.13652pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 A pointer to a dynamically allocated string holding the result of the substitutions, Overfull \hbox (2.52588pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 or NULL if the test string does not match the template string. This string should Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 be freed using astFree when no longer needed. If no substituion s are specified then Overfull \hbox (31.86462pt too wide) in paragraph at lines 50118--50118 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (16.11847pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied tes t string does not Overfull \hbox (12.76088pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 The template syntax is a minimal form of regular expression, The quantifiers allowed Overfull \hbox (24.6343pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 are " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " , " ?" , " $\OT1/ zplm/m/n/10 +$\T1/cmtt/m/n/10 " , " {n}" , " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 ?" and " $\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 ?" (the last two are non-greed y - they Overfull \hbox (14.59793pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [889] Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 Note, minus signs (" -" ) within brackets have no special signi ficance, so ranges of Overfull \hbox (5.66588pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Multiple template strings can be concatenated, using the " $\ OMS/zplm/m/n/10 j$\T1/cmtt/m/n/10 " character to separate Overfull \hbox (4.1005pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 them. The test string is compared against each one in turn unti l a match is found. Overfull \hbox (39.2669pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Parentheses are used within each template to identify sub-str ings that are to be replaced Overfull \hbox (23.52075pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 If " nsub" is supplied as zero, then substitution strings may be specified by appended Overfull \hbox (7.7746pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 them to the end of the " pattern" string, separated by " =" cha racters. If " nsub" Overfull \hbox (35.5928pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 is not zero, then any substitution strings appended to the end of " pattern" are ignored. Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Each element of " subs" may contain a reference to a token of the form " $1" , " $2" Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 , etc. The " $1" token will be replaced by the part of the test string that matched Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 the first parenthesised sub-string in " pattern" . The " $2" to ken will be replaced Overfull \hbox (2.52588pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [890] [891] Overfull \hbox (1.84724pt too wide) in paragraph at lines 50194--50194 []\T1/cmtt/m/n/10 void astFandl_( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 text, size_t start, size_t end, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 f, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l ) Overfull \hbox (10.60732pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 The zero-based index of the first character to be checked withi n " text" . The Overfull \hbox (5.3586pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 The zero-based index of the last character to be checked within " text" . The Overfull \hbox (15.85603pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 whole string is used if " start" is greater than " end" . The l ast character is Overfull \hbox (16.11847pt too wide) in paragraph at lines 50194--50194 [] \T1/cmtt/m/n/10 Returned holding the zero-based index of the first non-sp ace character. Ignored Overfull \hbox (10.86975pt too wide) in paragraph at lines 50194--50194 [] \T1/cmtt/m/n/10 Returned holding the zero-based index of the last non-spa ce character. Ignored Overfull \hbox (42.09962pt too wide) in paragraph at lines 50194--50194 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [892] Overfull \hbox (10.86975pt too wide) in paragraph at lines 50225--50225 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory. An error will res ult if the memory has Overfull \hbox (0.37231pt too wide) in paragraph at lines 50225--50225 \T1/cmtt/m/n/10 not previously been allocated by another function in this modul e. However, a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50225--50225 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [893] LaTeX Warning: Hyper reference `astGrow' on page 894 undefined on input line 50 263. Overfull \hbox (10.86975pt too wide) in paragraph at lines 50263--50263 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory. An error will res ult if the memory has Overfull \hbox (0.37231pt too wide) in paragraph at lines 50263--50263 \T1/cmtt/m/n/10 not previously been allocated by another function in this modul e. However, a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50263--50263 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [894] Overfull \hbox (12.44437pt too wide) in paragraph at lines 50326--50326 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if none h as yet been allocated). Overfull \hbox (12.76088pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 If the memory was allocated successfully, a pointer to the star t of the possibly new Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 [][]\T1/cmtt/m/n/10 This function does not free memory once it is allocated, so the size allocated Overfull \hbox (31.60219pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 grows to accommodate the maximum size of the array (or " high w ater mark" ). Other Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 memory handling routines may be used to free the memory (or alt er its size) if Overfull \hbox (15.85603pt too wide) in paragraph at lines 50326--50326 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t, or if it fails for Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [895] Overfull \hbox (7.7746pt too wide) in paragraph at lines 50367--50367 \T1/cmtt/m/n/10 Non-zero if the memory was allocated dynamically. Zero is retur ned if the supplied Overfull \hbox (0.10988pt too wide) in paragraph at lines 50367--50367 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [896] Overfull \hbox (2.26344pt too wide) in paragraph at lines 50408--50408 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated memory Overfull \hbox (10.86975pt too wide) in paragraph at lines 50408--50408 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [897] LaTeX Warning: Hyper reference `astTune' on page 898 undefined on input line 50 444. Overfull \hbox (12.18193pt too wide) in paragraph at lines 50444--50444 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see astTu ne in objectc.c). [898] Overfull \hbox (42.36206pt too wide) in paragraph at lines 50501--50501 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if the pr evious size of the allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 New size required for the memory region. This may be zero, in w hich case a NULL Overfull \hbox (12.76088pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 If the memory was reallocated successfully, a pointer to the st art of the new memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 region is returned (this may be the same as the original pointe r). If size was given Overfull \hbox (0.10988pt too wide) in paragraph at lines 50501--50501 [][]\T1/cmtt/m/n/10 If this function is invoked with the error status set, or i f it fails for any Overfull \hbox (38.68796pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. Overfull \hbox (16.11847pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [899] [900] Overfull \hbox (0.37231pt too wide) in paragraph at lines 50558--50558 [] \T1/cmtt/m/n/10 Pointer to dynamically allocated memory (or NULL if the s ize of the allocated Overfull \hbox (12.76088pt too wide) in paragraph at lines 50558--50558 \T1/cmtt/m/n/10 The allocated size. This will be zero if a NULL pointer was sup plied (no error will Overfull \hbox (0.10988pt too wide) in paragraph at lines 50558--50558 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [901] Overfull \hbox (12.44437pt too wide) in paragraph at lines 50622--50622 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if none h as yet been allocated). LaTeX Warning: Hyper reference `astRealloc' on page 902 undefined on input line 50622. Overfull \hbox (26.6159pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 Pointer to the start of the data to be stored. This may be give n as NULL if there Overfull \hbox (55.48386pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 are no data, in which case it will be ignored and this function behaves like astRealloc, Overfull \hbox (22.67937pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 The total size of the data to be stored and/or the size of memo ry to be allocated. Overfull \hbox (52.59706pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 This may be zero, in which case the data parameter is ignored, any previously-allocated Overfull \hbox (28.50703pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 If the data were stored successfully, a pointer to the start of the possibly new memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 region is returned (this may be the same as the original pointe r). If size was given Overfull \hbox (0.37231pt too wide) in paragraph at lines 50622--50622 [][]\T1/cmtt/m/n/10 This is a convenience function for use when storing data of arbitrary size in Overfull \hbox (0.37231pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 memory which is to be allocated dynamically. It is appropriate when the size Overfull \hbox (21.36719pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 of the data will not change frequently because the size of the memory region will Overfull \hbox (0.10988pt too wide) in paragraph at lines 50622--50622 [][]\T1/cmtt/m/n/10 If this function is invoked with the error status set, or i f it fails for any Overfull \hbox (38.68796pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [902] LaTeX Warning: Hyper reference `astFree' on page 903 undefined on input line 50 674. Overfull \hbox (4.1005pt too wide) in paragraph at lines 50674--50674 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated string. Overfull \hbox (2.52588pt too wide) in paragraph at lines 50674--50674 \T1/cmtt/m/n/10 If the number of characters is zero, a zero-length string is st ill allocated and a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50674--50674 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [903] LaTeX Warning: Hyper reference `astFree' on page 904 undefined on input line 50 746. Overfull \hbox (21.10475pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 Pointer to the array of input characters. The number of charact ers in this array Overfull \hbox (0.10988pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 The number of fixed-length strings in the input character array . This may be Overfull \hbox (0.10988pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 The number of characters in each fixed-length input string. Thi s may be zero Overfull \hbox (2.26344pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 A pointer to the start of the index array, which contains " nel " pointers pointing Overfull \hbox (12.76088pt too wide) in paragraph at lines 50746--50746 []\T1/cmtt/m/n/10 The returned pointer should be passed to astFree to de-alloca te the memory used when Overfull \hbox (2.52588pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 it is no longer required. This will free both the index array a nd the memory used Overfull \hbox (0.37231pt too wide) in paragraph at lines 50746--50746 [][]\T1/cmtt/m/n/10 A NULL pointer will also be returned if the value of " nel" is zero, in which Overfull \hbox (5.62103pt too wide) in paragraph at lines 50746--50746 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [904] LaTeX Warning: Hyper reference `astChrCase' on page 905 undefined on input line 50791. Overfull \hbox (5.62103pt too wide) in paragraph at lines 50791--50791 \T1/cmtt/m/n/10 If non-zero, the string is converted to upper case. Otherwise i t is converted LaTeX Warning: Hyper reference `astFree' on page 905 undefined on input line 50 791. Overfull \hbox (4.1005pt too wide) in paragraph at lines 50791--50791 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated string. Overfull \hbox (10.86975pt too wide) in paragraph at lines 50791--50791 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [905] LaTeX Warning: Hyper reference `FitsChan' on page 906 undefined on input line 5 0797. LaTeX Warning: Hyper reference `Encoding' on page 906 undefined on input line 5 0801. LaTeX Warning: Hyper reference `FrameSet' on page 906 undefined on input line 5 0803. LaTeX Warning: Hyper reference `astRead' on page 906 undefined on input line 50 805. LaTeX Warning: Hyper reference `astWrite' on page 906 undefined on input line 5 0809. LaTeX Warning: Hyper reference `Frame' on page 906 undefined on input line 5081 0. LaTeX Warning: Hyper reference `MathMap' on page 906 undefined on input line 50 811. LaTeX Warning: Hyper reference `FrameSet' on page 906 undefined on input line 5 0824. LaTeX Warning: Hyper reference `FitsChan' on page 906 undefined on input line 5 0824. LaTeX Warning: Hyper reference `Frame' on page 906 undefined on input line 5082 8. LaTeX Warning: Hyper reference `SkyFrame' on page 906 undefined on input line 5 0829. LaTeX Warning: Hyper reference `SpecFrame' on page 906 undefined on input line 50829. LaTeX Warning: Hyper reference `Table' on page 906 undefined on input line 5083 1. LaTeX Warning: Reference `tab:fitspaper1' on page 906 undefined on input line 5 0831. LaTeX Warning: Hyper reference `Mapping' on page 906 undefined on input line 50 845. LaTeX Warning: Hyper reference `CDMatrix' on page 906 undefined on input line 5 0852. Underfull \hbox (badness 1490) in paragraph at lines 50860--50860 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, LaTeX Warning: Hyper reference `Domain' on page 906 undefined on input line 508 83. Overfull \hbox (7.69725pt too wide) in paragraph at lines 50835--50892 [][] LaTeX Warning: Hyper reference `FrameSet' on page 906 undefined on input line 5 0897. LaTeX Warning: Hyper reference `Frame' on page 906 undefined on input line 5089 8. LaTeX Warning: Hyper reference `FitsChan' on page 906 undefined on input line 5 0898. LaTeX Warning: Hyper reference `Mapping' on page 906 undefined on input line 50 899. LaTeX Warning: Hyper reference `FrameSet' on page 906 undefined on input line 5 0904. LaTeX Warning: Hyper reference `FitsChan' on page 906 undefined on input line 5 0904. LaTeX Warning: Hyper reference `Frame' on page 906 undefined on input line 5090 5. LaTeX Warning: Hyper reference `SkyFrame' on page 906 undefined on input line 5 0919. LaTeX Warning: Hyper reference `SpecFrame' on page 906 undefined on input line 50919. LaTeX Warning: Hyper reference `System' on page 906 undefined on input line 509 20. LaTeX Warning: Hyper reference `Mapping' on page 906 undefined on input line 50 921. [906] [907] LaTeX Warning: Hyper reference `FrameSet' on page 908 undefined on input line 5 0925. LaTeX Warning: Hyper reference `FitsChan' on page 908 undefined on input line 5 0926. LaTeX Warning: Hyper reference `Frame' on page 908 undefined on input line 5093 4. LaTeX Warning: Hyper reference `Mapping' on page 908 undefined on input line 50 945. LaTeX Warning: Hyper reference `SkyFrame' on page 908 undefined on input line 5 0949. LaTeX Warning: Hyper reference `SpecFrame' on page 908 undefined on input line 50949. LaTeX Warning: Hyper reference `FrameSet' on page 908 undefined on input line 5 0954. LaTeX Warning: Hyper reference `FitsChan' on page 908 undefined on input line 5 0955. LaTeX Warning: Hyper reference `Frame' on page 908 undefined on input line 5095 6. LaTeX Warning: Hyper reference `FrameSet' on page 908 undefined on input line 5 0965. LaTeX Warning: Hyper reference `FitsChan' on page 908 undefined on input line 5 0966. LaTeX Warning: Hyper reference `Frame' on page 908 undefined on input line 5096 7. LaTeX Warning: Hyper reference `Mapping' on page 908 undefined on input line 50 969. LaTeX Warning: Hyper reference `Ident' on page 908 undefined on input line 5096 9. [908] LaTeX Warning: Hyper reference `FrameSet' on page 909 undefined on input line 5 0989. LaTeX Warning: Hyper reference `FitsChan' on page 909 undefined on input line 5 0990. LaTeX Warning: Hyper reference `Frame' on page 909 undefined on input line 5099 1. LaTeX Warning: Hyper reference `SkyFrame' on page 909 undefined on input line 5 0992. LaTeX Warning: Hyper reference `Table' on page 909 undefined on input line 5099 4. LaTeX Warning: Reference `tab:fitspaper2' on page 909 undefined on input line 5 0994. LaTeX Warning: Hyper reference `System' on page 909 undefined on input line 510 08. LaTeX Warning: Hyper reference `WcsType' on page 909 undefined on input line 51 008. LaTeX Warning: Hyper reference `WcsMap' on page 909 undefined on input line 510 08. LaTeX Warning: Hyper reference `Mapping' on page 909 undefined on input line 51 014. LaTeX Warning: Hyper reference `PVi_m' on page 909 undefined on input line 5101 9. Underfull \hbox (badness 2103) in paragraph at lines 51029--51029 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the LaTeX Warning: Hyper reference `Equinox' on page 909 undefined on input line 51 033. Underfull \hbox (badness 4291) in paragraph at lines 51037--51038 []|\T1/ppl/m/n/10.95 (+20) Only writ-ten if us-ing FITS-AIPS LaTeX Warning: Hyper reference `Epoch' on page 909 undefined on input line 5104 4. Overfull \hbox (1.56534pt too wide) in paragraph at lines 50998--51049 [][] LaTeX Warning: Hyper reference `FrameSet' on page 909 undefined on input line 5 1054. LaTeX Warning: Hyper reference `Frame' on page 909 undefined on input line 5105 5. LaTeX Warning: Hyper reference `SkyFrame' on page 909 undefined on input line 5 1055. LaTeX Warning: Hyper reference `FitsChan' on page 909 undefined on input line 5 1056. LaTeX Warning: Hyper reference `Mapping' on page 909 undefined on input line 51 060. LaTeX Warning: Hyper reference `WcsMap' on page 909 undefined on input line 510 61. LaTeX Warning: Hyper reference `TabOK' on page 909 undefined on input line 5106 6. LaTeX Warning: Hyper reference `FrameSet' on page 909 undefined on input line 5 1076. LaTeX Warning: Hyper reference `FitsChan' on page 909 undefined on input line 5 1076. LaTeX Warning: Hyper reference `WcsMap' on page 909 undefined on input line 510 81. [909] [910] LaTeX Warning: Hyper reference `Mapping' on page 911 undefined on input line 51 107. LaTeX Warning: Hyper reference `FrameSet' on page 911 undefined on input line 5 1112. LaTeX Warning: Hyper reference `FitsChan' on page 911 undefined on input line 5 1112. LaTeX Warning: Hyper reference `WcsMap' on page 911 undefined on input line 511 16. LaTeX Warning: Hyper reference `PVi_m' on page 911 undefined on input line 5111 9. LaTeX Warning: Hyper reference `FrameSet' on page 911 undefined on input line 5 1132. LaTeX Warning: Hyper reference `FitsChan' on page 911 undefined on input line 5 1132. LaTeX Warning: Hyper reference `WcsMap' on page 911 undefined on input line 511 49. LaTeX Warning: Hyper reference `Projection' on page 911 undefined on input line 51150. LaTeX Warning: Hyper reference `PVi_m' on page 911 undefined on input line 5115 1. LaTeX Warning: Hyper reference `Warnings' on page 911 undefined on input line 5 1164. [911] LaTeX Warning: Hyper reference `PolyTan' on page 912 undefined on input line 51 175. LaTeX Warning: Hyper reference `FrameSet' on page 912 undefined on input line 5 1181. LaTeX Warning: Hyper reference `FitsChan' on page 912 undefined on input line 5 1182. LaTeX Warning: Hyper reference `Frame' on page 912 undefined on input line 5118 4. LaTeX Warning: Hyper reference `SpecFrame' on page 912 undefined on input line 51184. LaTeX Warning: Hyper reference `Table' on page 912 undefined on input line 5118 6. LaTeX Warning: Reference `tab:fitspaper3' on page 912 undefined on input line 5 1186. LaTeX Warning: Hyper reference `TabOK' on page 912 undefined on input line 5120 1. LaTeX Warning: Hyper reference `System' on page 912 undefined on input line 512 01. LaTeX Warning: Hyper reference `Mapping' on page 912 undefined on input line 51 201. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 912 undefined on inpu t line 51205. Underfull \hbox (badness 4713) in paragraph at lines 51205--51205 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the LaTeX Warning: Hyper reference `GrismMap' on page 912 undefined on input line 5 1209. LaTeX Warning: Hyper reference `StdOfRest' on page 912 undefined on input line 51214. Underfull \hbox (badness 3229) in paragraph at lines 51214--51215 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the LaTeX Warning: Hyper reference `ObsLon' on page 912 undefined on input line 512 22. LaTeX Warning: Hyper reference `ObsLat' on page 912 undefined on input line 512 22. LaTeX Warning: Hyper reference `Epoch' on page 912 undefined on input line 5122 6. Underfull \hbox (badness 2261) in paragraph at lines 51226--51226 []|\T1/ppl/m/n/9 (+20) Used to set the Epoch at-tributes of the LaTeX Warning: Hyper reference `SourceVRF' on page 912 undefined on input line 51231. Underfull \hbox (badness 1931) in paragraph at lines 51231--51232 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the LaTeX Warning: Hyper reference `SourceVel' on page 912 undefined on input line 51240. Underfull \hbox (badness 3657) in paragraph at lines 51240--51241 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the LaTeX Warning: Hyper reference `RestFreq' on page 912 undefined on input line 5 1249. Underfull \hbox (badness 1043) in paragraph at lines 51249--51249 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 51249--51250 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 51255--51255 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 51255--51256 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Overfull \hbox (12.3573pt too wide) in paragraph at lines 51191--51264 [][] LaTeX Warning: Hyper reference `FrameSet' on page 912 undefined on input line 5 1269. LaTeX Warning: Hyper reference `Frame' on page 912 undefined on input line 5126 9. LaTeX Warning: Hyper reference `SpecFrame' on page 912 undefined on input line 51269. LaTeX Warning: Hyper reference `FitsChan' on page 912 undefined on input line 5 1270. LaTeX Warning: Hyper reference `Mapping' on page 912 undefined on input line 51 271. LaTeX Warning: Hyper reference `GrismMap' on page 912 undefined on input line 5 1279. LaTeX Warning: Hyper reference `TabOK' on page 912 undefined on input line 5128 3. LaTeX Warning: Hyper reference `FitsChan' on page 912 undefined on input line 5 1298. [912] [913] LaTeX Warning: Hyper reference `FrameSet' on page 914 undefined on input line 5 1313. LaTeX Warning: Hyper reference `FitsChan' on page 914 undefined on input line 5 1313. LaTeX Warning: Hyper reference `Mapping' on page 914 undefined on input line 51 315. LaTeX Warning: Hyper reference `FrameSet' on page 914 undefined on input line 5 1337. LaTeX Warning: Hyper reference `FitsChan' on page 914 undefined on input line 5 1337. LaTeX Warning: Hyper reference `PolyMap' on page 914 undefined on input line 51 342. [914] LaTeX Warning: Reference `ss:howto' on page 915 undefined on input line 51362. LaTeX Warning: Hyper reference `astUnformat' on page 915 undefined on input lin e 51366. LaTeX Warning: Hyper reference `Frame' on page 915 undefined on input line 5136 7. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 915 undefined on i nput line 51368. LaTeX Warning: Hyper reference `astFormat' on page 915 undefined on input line 51369. LaTeX Warning: Reference `ss:unformattingskyaxisvalues' on page 915 undefined o n input line 51372. LaTeX Warning: Hyper reference `SkyFrame' on page 915 undefined on input line 5 1375. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 915 undefined on input line 51379. LaTeX Warning: Hyper reference `astMapBox' on page 915 undefined on input line 51384. LaTeX Warning: Hyper reference `Mapping' on page 915 undefined on input line 51 386. LaTeX Warning: Hyper reference `Object' on page 915 undefined on input line 513 90. LaTeX Warning: Hyper reference `IntraMap' on page 915 undefined on input line 5 1390. LaTeX Warning: Reference `ss:intramaps' on page 915 undefined on input line 513 91. LaTeX Warning: Hyper reference `FrameSet' on page 915 undefined on input line 5 1397. LaTeX Warning: Reference `ss:framesetintegrity' on page 915 undefined on input line 51402. LaTeX Warning: Hyper reference `astSimplify' on page 915 undefined on input lin e 51412. LaTeX Warning: Hyper reference `Channel' on page 915 undefined on input line 51 415. [915] LaTeX Warning: Hyper reference `astRead' on page 916 undefined on input line 51 423. LaTeX Warning: Hyper reference `MatrixMap' on page 916 undefined on input line 51430. LaTeX Warning: Hyper reference `Invert' on page 916 undefined on input line 514 31. LaTeX Warning: Hyper reference `astPolyCurve' on page 916 undefined on input li ne 51447. LaTeX Warning: Reference `ss:plottinggeodesics' on page 916 undefined on input line 51449. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 916 undefined on in put line 51451. LaTeX Warning: Hyper reference `Mapping' on page 916 undefined on input line 51 454. LaTeX Warning: Hyper reference `ast_link' on page 916 undefined on input line 5 1457. LaTeX Warning: Hyper reference `ast_link_adam' on page 916 undefined on input l ine 51458. LaTeX Warning: Hyper reference `astMapBox' on page 916 undefined on input line 51463. LaTeX Warning: Hyper reference `Encoding' on page 916 undefined on input line 5 1468. LaTeX Warning: Hyper reference `FitsChan' on page 916 undefined on input line 5 1468. LaTeX Warning: Hyper reference `FrameSet' on page 916 undefined on input line 5 1473. LaTeX Warning: Hyper reference `Frame' on page 916 undefined on input line 5147 4. LaTeX Warning: Hyper reference `Domain' on page 916 undefined on input line 514 75. LaTeX Warning: Reference `ss:domainconventions' on page 916 undefined on input line 51478. LaTeX Warning: Hyper reference `astFindFits' on page 916 undefined on input lin e 51481. LaTeX Warning: Hyper reference `astPutFits' on page 916 undefined on input line 51483. [916] LaTeX Warning: Hyper reference `astSimplify' on page 917 undefined on input lin e 51494. LaTeX Warning: Hyper reference `UnitRadius' on page 917 undefined on input line 51496. LaTeX Warning: Hyper reference `SphMap' on page 917 undefined on input line 514 96. LaTeX Warning: Hyper reference `MatrixMap' on page 917 undefined on input line 51501. LaTeX Warning: Hyper reference `astConvert' on page 917 undefined on input line 51510. LaTeX Warning: Hyper reference `CmpFrame' on page 917 undefined on input line 5 1511. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 917 undefined on in put line 51522. LaTeX Warning: Hyper reference `Mapping' on page 917 undefined on input line 51 525. LaTeX Warning: Hyper reference `PcdMap' on page 917 undefined on input line 515 27. LaTeX Warning: Hyper reference `FitsChan' on page 917 undefined on input line 5 1531. [917] LaTeX Warning: Hyper reference `MathMap' on page 918 undefined on input line 51 574. LaTeX Warning: Hyper reference `Mapping' on page 918 undefined on input line 51 575. LaTeX Warning: Hyper reference `IntraMap' on page 918 undefined on input line 5 1580. LaTeX Warning: Hyper reference `astIntraReg' on page 918 undefined on input lin e 51580. LaTeX Warning: Hyper reference `IntraFlag' on page 918 undefined on input line 51589. LaTeX Warning: Reference `ss:intraflag' on page 918 undefined on input line 515 92. LaTeX Warning: Hyper reference `Plot' on page 918 undefined on input line 51594 . LaTeX Warning: Hyper reference `Labelling' on page 918 undefined on input line 51603. LaTeX Warning: Hyper reference `FitsChan' on page 918 undefined on input line 5 1605. LaTeX Warning: Hyper reference `Encoding' on page 918 undefined on input line 5 1608. LaTeX Warning: Hyper reference `System' on page 918 undefined on input line 516 11. LaTeX Warning: Hyper reference `SkyFrame' on page 918 undefined on input line 5 1617. [918] LaTeX Warning: Hyper reference `FitsChan' on page 919 undefined on input line 5 1645. LaTeX Warning: Hyper reference `Projection' on page 919 undefined on input line 51660. LaTeX Warning: Hyper reference `PVi_m' on page 919 undefined on input line 5166 1. [919] LaTeX Warning: Hyper reference `Encoding' on page 920 undefined on input line 5 1693. LaTeX Warning: Hyper reference `FrameSet' on page 920 undefined on input line 5 1703. LaTeX Warning: Hyper reference `Object' on page 920 undefined on input line 517 09. LaTeX Warning: Hyper reference `Frame' on page 920 undefined on input line 5171 0. LaTeX Warning: Hyper reference `Warnings' on page 920 undefined on input line 5 1716. LaTeX Warning: Hyper reference `WcsMap' on page 920 undefined on input line 517 22. LaTeX Warning: Hyper reference `astTranN' on page 920 undefined on input line 5 1746. LaTeX Warning: Hyper reference `astMark' on page 920 undefined on input line 51 746. LaTeX Warning: Hyper reference `astPolyCurve' on page 920 undefined on input li ne 51747. LaTeX Warning: Hyper reference `Plot' on page 920 undefined on input line 51752 . [920] LaTeX Warning: Hyper reference `FitsChan' on page 921 undefined on input line 5 1758. LaTeX Warning: Hyper reference `FrameSet' on page 921 undefined on input line 5 1759. LaTeX Warning: Hyper reference `Domain' on page 921 undefined on input line 517 60. LaTeX Warning: Hyper reference `Frame' on page 921 undefined on input line 5176 2. LaTeX Warning: Hyper reference `Ident' on page 921 undefined on input line 5176 8. LaTeX Warning: Hyper reference `SkyFrame' on page 921 undefined on input line 5 1774. LaTeX Warning: Hyper reference `System' on page 921 undefined on input line 517 74. LaTeX Warning: Hyper reference `Warnings' on page 921 undefined on input line 5 1785. LaTeX Warning: Hyper reference `AllWarnings' on page 921 undefined on input lin e 51789. LaTeX Warning: Hyper reference `Title' on page 921 undefined on input line 5179 3. [921] LaTeX Warning: Hyper reference `LatAxis' on page 922 undefined on input line 51 813. LaTeX Warning: Hyper reference `LonAxis' on page 922 undefined on input line 51 813. LaTeX Warning: Hyper reference `Object' on page 922 undefined on input line 518 16. LaTeX Warning: Hyper reference `ID' on page 922 undefined on input line 51817. LaTeX Warning: Hyper reference `Mapping' on page 922 undefined on input line 51 822. LaTeX Warning: Hyper reference `CmpFrame' on page 922 undefined on input line 5 1822. LaTeX Warning: Hyper reference `Frame' on page 922 undefined on input line 5183 3. LaTeX Warning: Hyper reference `astAngle' on page 922 undefined on input line 5 1834. LaTeX Warning: Hyper reference `astOffset2' on page 922 undefined on input line 51839. LaTeX Warning: Hyper reference `astAxDistance' on page 922 undefined on input l ine 51846. LaTeX Warning: Hyper reference `astAxOffset' on page 922 undefined on input lin e 51852. LaTeX Warning: Hyper reference `Plot' on page 922 undefined on input line 51858 . LaTeX Warning: Hyper reference `astGenCurve' on page 922 undefined on input lin e 51859. LaTeX Warning: Hyper reference `Mapping' on page 922 undefined on input line 51 861. LaTeX Warning: Hyper reference `astGrfSet' on page 922 undefined on input line 51867. LaTeX Warning: Hyper reference `ast_link' on page 922 undefined on input line 5 1871. LaTeX Warning: Hyper reference `astGrfPush' on page 922 undefined on input line 51874. LaTeX Warning: Hyper reference `astGrfPop' on page 922 undefined on input line 51874. [922] LaTeX Warning: Hyper reference `IntraMap' on page 923 undefined on input line 5 1887. LaTeX Warning: Hyper reference `FitsChan' on page 923 undefined on input line 5 1890. LaTeX Warning: Hyper reference `SkyFrame' on page 923 undefined on input line 5 1908. LaTeX Warning: Hyper reference `NegLon' on page 923 undefined on input line 519 08. LaTeX Warning: Hyper reference `astAngle' on page 923 undefined on input line 5 1913. LaTeX Warning: Hyper reference `astAxAngle' on page 923 undefined on input line 51913. LaTeX Warning: Hyper reference `astResolve' on page 923 undefined on input line 51913. LaTeX Warning: Hyper reference `astOffset2' on page 923 undefined on input line 51913. LaTeX Warning: Hyper reference `astAxOffset' on page 923 undefined on input lin e 51913. LaTeX Warning: Hyper reference `astAxDistance' on page 923 undefined on input l ine 51914. LaTeX Warning: Hyper reference `Frame' on page 923 undefined on input line 5191 5. LaTeX Warning: Hyper reference `astDecompose' on page 923 undefined on input li ne 51935. LaTeX Warning: Hyper reference `Mapping' on page 923 undefined on input line 51 935. LaTeX Warning: Hyper reference `CmpMap' on page 923 undefined on input line 519 36. LaTeX Warning: Hyper reference `CmpFrame' on page 923 undefined on input line 5 1937. LaTeX Warning: Hyper reference `FitsChan' on page 923 undefined on input line 5 1952. LaTeX Warning: Hyper reference `DefB1950' on page 923 undefined on input line 5 1952. LaTeX Warning: Hyper reference `astWrite' on page 923 undefined on input line 5 1958. LaTeX Warning: Hyper reference `FrameSet' on page 923 undefined on input line 5 1959. [923] LaTeX Warning: Hyper reference `astRead' on page 924 undefined on input line 51 962. LaTeX Warning: Hyper reference `Plot' on page 924 undefined on input line 51974 . LaTeX Warning: Hyper reference `Grid' on page 924 undefined on input line 51978 . LaTeX Warning: Hyper reference `CarLin' on page 924 undefined on input line 519 91. LaTeX Warning: Hyper reference `FitsChan' on page 924 undefined on input line 5 1991. LaTeX Warning: Hyper reference `FrameSet' on page 924 undefined on input line 5 1993. LaTeX Warning: Hyper reference `Mapping' on page 924 undefined on input line 51 997. LaTeX Warning: Hyper reference `astRead' on page 924 undefined on input line 52 000. LaTeX Warning: Hyper reference `Plot' on page 924 undefined on input line 52007 . LaTeX Warning: Hyper reference `astSet' on page 924 undefined on input line 520 16. [924] LaTeX Warning: Hyper reference `FitsChan' on page 925 undefined on input line 5 2028. LaTeX Warning: Hyper reference `FrameSet' on page 925 undefined on input line 5 2029. LaTeX Warning: Hyper reference `astBoundingBox' on page 925 undefined on input line 52036. LaTeX Warning: Hyper reference `Plot' on page 925 undefined on input line 52037 . LaTeX Warning: Hyper reference `Invisible' on page 925 undefined on input line 52040. LaTeX Warning: Hyper reference `FitsChan' on page 925 undefined on input line 5 2063. LaTeX Warning: Hyper reference `astWrite' on page 925 undefined on input line 5 2064. LaTeX Warning: Hyper reference `WcsMap' on page 925 undefined on input line 520 88. [925] LaTeX Warning: Hyper reference `Frame' on page 926 undefined on input line 5209 9. LaTeX Warning: Hyper reference `Top(axis)' on page 926 undefined on input line 52099. LaTeX Warning: Hyper reference `Bottom(axis)' on page 926 undefined on input li ne 52099. LaTeX Warning: Hyper reference `astGrid' on page 926 undefined on input line 52 101. LaTeX Warning: Hyper reference `Frame' on page 926 undefined on input line 5210 7. LaTeX Warning: Hyper reference `Channel' on page 926 undefined on input line 52 111. LaTeX Warning: Hyper reference `FitsChan' on page 926 undefined on input line 5 2112. LaTeX Warning: Hyper reference `Encoding' on page 926 undefined on input line 5 2112. LaTeX Warning: Hyper reference `astShow' on page 926 undefined on input line 52 113. LaTeX Warning: Hyper reference `Domain' on page 926 undefined on input line 521 25. LaTeX Warning: Hyper reference `CmpFrame' on page 926 undefined on input line 5 2125. LaTeX Warning: Hyper reference `astWrite' on page 926 undefined on input line 5 2132. LaTeX Warning: Hyper reference `FrameSet' on page 926 undefined on input line 5 2134. LaTeX Warning: Hyper reference `Current' on page 926 undefined on input line 52 135. LaTeX Warning: Hyper reference `Base' on page 926 undefined on input line 52136 . LaTeX Warning: Hyper reference `SpecFrame' on page 926 undefined on input line 52151. LaTeX Warning: Hyper reference `SpecMap' on page 926 undefined on input line 52 151. LaTeX Warning: Hyper reference `Mapping' on page 926 undefined on input line 52 156. [926] LaTeX Warning: Hyper reference `astConvert' on page 927 undefined on input line 52168. LaTeX Warning: Hyper reference `Axis' on page 927 undefined on input line 52169 . LaTeX Warning: Hyper reference `ZoomMap' on page 927 undefined on input line 52 171. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 927 undefined on inpu t line 52179. LaTeX Warning: Hyper reference `System' on page 927 undefined on input line 521 85. LaTeX Warning: Hyper reference `Epoch' on page 927 undefined on input line 5218 5. LaTeX Warning: Hyper reference `SkyFrame' on page 927 undefined on input line 5 2185. LaTeX Warning: Hyper reference `AlignSystem' on page 927 undefined on input lin e 52190. LaTeX Warning: Hyper reference `astFindFrame' on page 927 undefined on input li ne 52192. LaTeX Warning: Hyper reference `StdOfRest' on page 927 undefined on input line 52199. LaTeX Warning: Hyper reference `Equinox' on page 927 undefined on input line 52 200. LaTeX Warning: Hyper reference `Plot' on page 927 undefined on input line 52211 . [927] LaTeX Warning: Hyper reference `astVersion' on page 928 undefined on input line 52223. LaTeX Warning: Hyper reference `FitsChan' on page 928 undefined on input line 5 2243. LaTeX Warning: Hyper reference `CDMatrix' on page 928 undefined on input line 5 2252. LaTeX Warning: Hyper reference `FrameSet' on page 928 undefined on input line 5 2253. LaTeX Warning: Hyper reference `SkyFrame' on page 928 undefined on input line 5 2277. LaTeX Warning: Hyper reference `System' on page 928 undefined on input line 522 77. LaTeX Warning: Hyper reference `PolyMap' on page 928 undefined on input line 52 294. [928] LaTeX Warning: Hyper reference `Warnings' on page 929 undefined on input line 5 2300. LaTeX Warning: Hyper reference `Encoding' on page 929 undefined on input line 5 2313. LaTeX Warning: Hyper reference `DefB1950' on page 929 undefined on input line 5 2320. LaTeX Warning: Hyper reference `astRate' on page 929 undefined on input line 52 333. LaTeX Warning: Hyper reference `Mapping' on page 929 undefined on input line 52 335. LaTeX Warning: Hyper reference `Frame' on page 929 undefined on input line 5233 9. LaTeX Warning: Hyper reference `Domain' on page 929 undefined on input line 523 39. LaTeX Warning: Hyper reference `CmpFrame' on page 929 undefined on input line 5 2343. LaTeX Warning: Hyper reference `GrismMap' on page 929 undefined on input line 5 2350. [929] LaTeX Warning: Hyper reference `ShiftMap' on page 930 undefined on input line 5 2353. LaTeX Warning: Hyper reference `WinMap' on page 930 undefined on input line 523 54. LaTeX Warning: Hyper reference `Plot' on page 930 undefined on input line 52357 . LaTeX Warning: Hyper reference `SphMap' on page 930 undefined on input line 523 60. LaTeX Warning: Hyper reference `PolarLong' on page 930 undefined on input line 52360. LaTeX Warning: Hyper reference `WcsMap' on page 930 undefined on input line 523 64. LaTeX Warning: Hyper reference `NatLat' on page 930 undefined on input line 523 67. LaTeX Warning: Hyper reference `NatLon' on page 930 undefined on input line 523 67. LaTeX Warning: Hyper reference `astSimplify' on page 930 undefined on input lin e 52378. LaTeX Warning: Hyper reference `CmpMap' on page 930 undefined on input line 523 79. LaTeX Warning: Hyper reference `SlaMap' on page 930 undefined on input line 523 82. LaTeX Warning: Hyper reference `SpecMap' on page 930 undefined on input line 52 385. LaTeX Warning: Hyper reference `XmlChan' on page 930 undefined on input line 52 400. LaTeX Warning: Hyper reference `Channel' on page 930 undefined on input line 52 400. LaTeX Warning: Hyper reference `Plot' on page 930 undefined on input line 52402 . LaTeX Warning: Hyper reference `astPutCards' on page 930 undefined on input lin e 52420. LaTeX Warning: Hyper reference `FitsChan' on page 930 undefined on input line 5 2421. [930] LaTeX Warning: Hyper reference `Plot' on page 931 undefined on input line 52439 . LaTeX Warning: Hyper reference `Escape' on page 931 undefined on input line 524 42. LaTeX Warning: Hyper reference `Tol' on page 931 undefined on input line 52444. LaTeX Warning: Hyper reference `SkyAxis' on page 931 undefined on input line 52 460. LaTeX Warning: Hyper reference `ast_link' on page 931 undefined on input line 5 2473. [931] LaTeX Warning: Hyper reference `astEscapes' on page 932 undefined on input line 52487. LaTeX Warning: Hyper reference `astFormat' on page 932 undefined on input line 52488. LaTeX Warning: Hyper reference `XmlPrefix' on page 932 undefined on input line 52491. LaTeX Warning: Hyper reference `XmlChan' on page 932 undefined on input line 52 491. LaTeX Warning: Hyper reference `XmlFormat' on page 932 undefined on input line 52495. LaTeX Warning: Hyper reference `Mapping' on page 932 undefined on input line 52 498. LaTeX Warning: Hyper reference `TranMap' on page 932 undefined on input line 52 498. LaTeX Warning: Hyper reference `WcsMap' on page 932 undefined on input line 525 02. LaTeX Warning: Hyper reference `SkyFrame' on page 932 undefined on input line 5 2514. LaTeX Warning: Hyper reference `SkyRefIs' on page 932 undefined on input line 5 2517. LaTeX Warning: Hyper reference `AlignOffset' on page 932 undefined on input lin e 52517. LaTeX Warning: Hyper reference `FitsChan' on page 932 undefined on input line 5 2519. LaTeX Warning: Hyper reference `Iwc' on page 932 undefined on input line 52524. [932] LaTeX Warning: Hyper reference `Mapping' on page 933 undefined on input line 52 571. LaTeX Warning: Hyper reference `astLinearApprox' on page 933 undefined on input line 52572. LaTeX Warning: Hyper reference `SkyFrame' on page 933 undefined on input line 5 2578. LaTeX Warning: Hyper reference `Frame' on page 933 undefined on input line 5257 8. LaTeX Warning: Hyper reference `Plot' on page 933 undefined on input line 52583 . LaTeX Warning: Hyper reference `DSBSpecFrame' on page 933 undefined on input li ne 52592. LaTeX Warning: Hyper reference `SpecFrame' on page 933 undefined on input line 52593. LaTeX Warning: Hyper reference `FitsChan' on page 933 undefined on input line 5 2596. LaTeX Warning: Hyper reference `Encoding' on page 933 undefined on input line 5 2600. LaTeX Warning: Hyper reference `Region' on page 933 undefined on input line 526 16. [933] LaTeX Warning: Hyper reference `Frame' on page 934 undefined on input line 5262 4. LaTeX Warning: Hyper reference `FluxFrame' on page 934 undefined on input line 52624. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 934 undefined on input l ine 52628. LaTeX Warning: Hyper reference `Mapping' on page 934 undefined on input line 52 632. LaTeX Warning: Hyper reference `RateMap' on page 934 undefined on input line 52 632. LaTeX Warning: Hyper reference `SkyFrame' on page 934 undefined on input line 5 2638. LaTeX Warning: Hyper reference `System' on page 934 undefined on input line 526 38. LaTeX Warning: Hyper reference `KeyMap' on page 934 undefined on input line 526 42. LaTeX Warning: Hyper reference `astRate' on page 934 undefined on input line 52 647. LaTeX Warning: Hyper reference `FitsChan' on page 934 undefined on input line 5 2654. LaTeX Warning: Hyper reference `SkyFrame' on page 934 undefined on input line 5 2667. LaTeX Warning: Hyper reference `Frame' on page 934 undefined on input line 5267 0. LaTeX Warning: Hyper reference `Plot' on page 934 undefined on input line 52672 . LaTeX Warning: Hyper reference `Clip' on page 934 undefined on input line 52672 . LaTeX Warning: Hyper reference `PolyMap' on page 934 undefined on input line 52 675. LaTeX Warning: Hyper reference `Channel' on page 934 undefined on input line 52 676. LaTeX Warning: Hyper reference `FitsChan' on page 934 undefined on input line 5 2677. [934] LaTeX Warning: Hyper reference `ast_link' on page 935 undefined on input line 5 2686. LaTeX Warning: Hyper reference `TimeFrame' on page 935 undefined on input line 52702. LaTeX Warning: Hyper reference `TimeMap' on page 935 undefined on input line 52 702. LaTeX Warning: Hyper reference `Frame' on page 935 undefined on input line 5270 3. LaTeX Warning: Hyper reference `Epoch' on page 935 undefined on input line 5270 5. LaTeX Warning: Hyper reference `Mapping' on page 935 undefined on input line 52 706. LaTeX Warning: Hyper reference `XmlChan' on page 935 undefined on input line 52 722. LaTeX Warning: Hyper reference `Mapping' on page 935 undefined on input line 52 726. Overfull \hbox (36.88722pt too wide) in paragraph at lines 52725--52728 \T1/ppl/m/n/10.95 (-20) class. These are flux-conserving al-ter-na-tives to the ex-ist-ing AST_RESAMPLE/astResample LaTeX Warning: Hyper reference `SkyFrame' on page 935 undefined on input line 5 2747. LaTeX Warning: Hyper reference `System' on page 935 undefined on input line 527 47. [935] LaTeX Warning: Hyper reference `FitsChan' on page 936 undefined on input line 5 2750. LaTeX Warning: Hyper reference `Frame' on page 936 undefined on input line 5275 3. LaTeX Warning: Hyper reference `ObsLon' on page 936 undefined on input line 527 53. LaTeX Warning: Hyper reference `ObsLat' on page 936 undefined on input line 527 53. LaTeX Warning: Hyper reference `TimeFrame' on page 936 undefined on input line 52757. LaTeX Warning: Hyper reference `SpecFrame' on page 936 undefined on input line 52758. LaTeX Warning: Hyper reference `astMapSplit' on page 936 undefined on input lin e 52765. LaTeX Warning: Hyper reference `Mapping' on page 936 undefined on input line 52 766. LaTeX Warning: Hyper reference `SkyRefIs' on page 936 undefined on input line 5 2770. LaTeX Warning: Hyper reference `SideBand' on page 936 undefined on input line 5 2785. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 936 undefined on input li ne 52785. LaTeX Warning: Hyper reference `FitsChan' on page 936 undefined on input line 5 2790. LaTeX Warning: Hyper reference `FrameSet' on page 936 undefined on input line 5 2793. LaTeX Warning: Hyper reference `astRetainFits' on page 936 undefined on input l ine 52796. LaTeX Warning: Hyper reference `Object' on page 936 undefined on input line 527 98. LaTeX Warning: Hyper reference `ObjSize' on page 936 undefined on input line 52 805. LaTeX Warning: Hyper reference `Class' on page 936 undefined on input line 5280 6. LaTeX Warning: Hyper reference `Channel' on page 936 undefined on input line 52 809. [936] LaTeX Warning: Hyper reference `astTune' on page 937 undefined on input line 52 812. LaTeX Warning: Hyper reference `astTranGrid' on page 937 undefined on input lin e 52818. LaTeX Warning: Hyper reference `Mapping' on page 937 undefined on input line 52 819. LaTeX Warning: Hyper reference `SwitchMap' on page 937 undefined on input line 52825. LaTeX Warning: Hyper reference `SelectorMap' on page 937 undefined on input lin e 52830. LaTeX Warning: Hyper reference `Region' on page 937 undefined on input line 528 32. LaTeX Warning: Hyper reference `astConvert' on page 937 undefined on input line 52836. LaTeX Warning: Hyper reference `CmpFrame' on page 937 undefined on input line 5 2837. LaTeX Warning: Hyper reference `Frame' on page 937 undefined on input line 5283 7. LaTeX Warning: Hyper reference `SkyFrame' on page 937 undefined on input line 5 2841. LaTeX Warning: Hyper reference `SpecFrame' on page 937 undefined on input line 52842. LaTeX Warning: Hyper reference `ast_link_adam' on page 937 undefined on input l ine 52845. LaTeX Warning: Hyper reference `ast_link' on page 937 undefined on input line 5 2845. LaTeX Warning: Hyper reference `SpecFrame' on page 937 undefined on input line 52863. LaTeX Warning: Hyper reference `SourceSys' on page 937 undefined on input line 52863. LaTeX Warning: Hyper reference `SourceVel' on page 937 undefined on input line 52864. LaTeX Warning: Hyper reference `astFindFrame' on page 937 undefined on input li ne 52881. LaTeX Warning: Hyper reference `CmpFrame' on page 937 undefined on input line 5 2882. LaTeX Warning: Hyper reference `Frame' on page 937 undefined on input line 5288 3. LaTeX Warning: Hyper reference `SkyFrame' on page 937 undefined on input line 5 2883. LaTeX Warning: Hyper reference `TimeFrame' on page 937 undefined on input line 52883. LaTeX Warning: Hyper reference `SpecFrame' on page 937 undefined on input line 52883. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 937 undefined on input li ne 52883. LaTeX Warning: Hyper reference `FluxFrame' on page 937 undefined on input line 52884. LaTeX Warning: Hyper reference `FrameSet' on page 937 undefined on input line 5 2887. LaTeX Warning: Hyper reference `Mapping' on page 937 undefined on input line 52 890. LaTeX Warning: Hyper reference `PermMap' on page 937 undefined on input line 52 890. LaTeX Warning: Hyper reference `MaxAxes' on page 937 undefined on input line 52 893. LaTeX Warning: Hyper reference `MinAxes' on page 937 undefined on input line 52 893. [937] LaTeX Warning: Hyper reference `SideBand' on page 938 undefined on input line 5 2903. LaTeX Warning: Hyper reference `astConvert' on page 938 undefined on input line 52905. LaTeX Warning: Hyper reference `Dut1' on page 938 undefined on input line 52907 . LaTeX Warning: Hyper reference `ObsLat' on page 938 undefined on input line 529 11. LaTeX Warning: Hyper reference `ObsLon' on page 938 undefined on input line 529 12. LaTeX Warning: Hyper reference `AlignOffset' on page 938 undefined on input lin e 52914. LaTeX Warning: Hyper reference `UnitMap' on page 938 undefined on input line 52 919. LaTeX Warning: Hyper reference `Plot' on page 938 undefined on input line 52921 . LaTeX Warning: Hyper reference `FrameSet' on page 938 undefined on input line 5 2941. LaTeX Warning: Hyper reference `astWrite' on page 938 undefined on input line 5 2942. [938] LaTeX Warning: Hyper reference `astPurgeWCS' on page 939 undefined on input lin e 52951. LaTeX Warning: Hyper reference `FitsChan' on page 939 undefined on input line 5 2952. LaTeX Warning: Hyper reference `Plot' on page 939 undefined on input line 52955 . LaTeX Warning: Hyper reference `astGrfSet' on page 939 undefined on input line 52958. LaTeX Warning: Hyper reference `Frame' on page 939 undefined on input line 5298 0. LaTeX Warning: Hyper reference `astShowMesh' on page 939 undefined on input lin e 52986. LaTeX Warning: Hyper reference `Region' on page 939 undefined on input line 529 87. LaTeX Warning: Hyper reference `TimeFrame' on page 939 undefined on input line 53009. LaTeX Warning: Hyper reference `LTOffset' on page 939 undefined on input line 5 3011. LaTeX Warning: Hyper reference `Plot3D' on page 939 undefined on input line 530 13. [939] LaTeX Warning: Hyper reference `ObsLat' on page 940 undefined on input line 530 18. LaTeX Warning: Hyper reference `Frame' on page 940 undefined on input line 5301 8. LaTeX Warning: Hyper reference `SkyFrame' on page 940 undefined on input line 5 3022. LaTeX Warning: Hyper reference `astLock' on page 940 undefined on input line 53 040. LaTeX Warning: Hyper reference `astUnlock' on page 940 undefined on input line 53040. LaTeX Warning: Hyper reference `Object' on page 940 undefined on input line 530 40. LaTeX Warning: Hyper reference `TimeFrame' on page 940 undefined on input line 53043. LaTeX Warning: Hyper reference `LTOffset' on page 940 undefined on input line 5 3045. LaTeX Warning: Hyper reference `Channel' on page 940 undefined on input line 53 047. LaTeX Warning: Hyper reference `Strict' on page 940 undefined on input line 530 47. LaTeX Warning: Hyper reference `astUnlock' on page 940 undefined on input line 53063. LaTeX Warning: Hyper reference `Object' on page 940 undefined on input line 530 64. LaTeX Warning: Hyper reference `Prism' on page 940 undefined on input line 5306 7. LaTeX Warning: Hyper reference `Region' on page 940 undefined on input line 530 67. LaTeX Warning: Hyper reference `Box' on page 940 undefined on input line 53068. LaTeX Warning: Hyper reference `Interval' on page 940 undefined on input line 5 3068. LaTeX Warning: Hyper reference `astSimplify' on page 940 undefined on input lin e 53076. LaTeX Warning: Hyper reference `PointList' on page 940 undefined on input line 53080. LaTeX Warning: Hyper reference `ListSize' on page 940 undefined on input line 5 3084. [940] LaTeX Warning: Hyper reference `Channel' on page 941 undefined on input line 53 087. LaTeX Warning: Hyper reference `Strict' on page 941 undefined on input line 530 91. LaTeX Warning: Hyper reference `ReportLevel' on page 941 undefined on input lin e 53092. LaTeX Warning: Hyper reference `astWarnings' on page 941 undefined on input lin e 53093. LaTeX Warning: Hyper reference `FitsChan' on page 941 undefined on input line 5 3095. LaTeX Warning: Hyper reference `Frame' on page 941 undefined on input line 5310 3. LaTeX Warning: Hyper reference `astPickAxes' on page 941 undefined on input lin e 53112. LaTeX Warning: Hyper reference `astTestFits' on page 941 undefined on input lin e 53121. LaTeX Warning: Hyper reference `astSetFitsCM' on page 941 undefined on input li ne 53143. LaTeX Warning: Hyper reference `FitsChan' on page 941 undefined on input line 5 3144. LaTeX Warning: Hyper reference `ObsAlt' on page 941 undefined on input line 531 47. LaTeX Warning: Hyper reference `Frame' on page 941 undefined on input line 5314 7. LaTeX Warning: Hyper reference `TimeMap' on page 941 undefined on input line 53 156. LaTeX Warning: Hyper reference `SpecMap' on page 941 undefined on input line 53 156. [941] LaTeX Warning: Hyper reference `Polygon' on page 942 undefined on input line 53 160. LaTeX Warning: Hyper reference `Channel' on page 942 undefined on input line 53 169. LaTeX Warning: Hyper reference `StcsChan' on page 942 undefined on input line 5 3169. LaTeX Warning: Hyper reference `astRemoveRegions' on page 942 undefined on inpu t line 53173. LaTeX Warning: Hyper reference `Mapping' on page 942 undefined on input line 53 174. LaTeX Warning: Hyper reference `Region' on page 942 undefined on input line 531 75. LaTeX Warning: Hyper reference `astDownsize' on page 942 undefined on input lin e 53181. LaTeX Warning: Hyper reference `KeyMap' on page 942 undefined on input line 531 96. LaTeX Warning: Hyper reference `KeyError' on page 942 undefined on input line 5 3199. LaTeX Warning: Hyper reference `Class' on page 942 undefined on input line 5319 9. LaTeX Warning: Hyper reference `Frame' on page 942 undefined on input line 5321 4. LaTeX Warning: Hyper reference `astFindFrame' on page 942 undefined on input li ne 53215. LaTeX Warning: Hyper reference `astConvert' on page 942 undefined on input line 53215. LaTeX Warning: Hyper reference `Domain' on page 942 undefined on input line 532 18. LaTeX Warning: Hyper reference `SkyFrame' on page 942 undefined on input line 5 3220. LaTeX Warning: Hyper reference `UnitMap' on page 942 undefined on input line 53 221. LaTeX Warning: Hyper reference `astMatchAxes' on page 942 undefined on input li ne 53227. LaTeX Warning: Hyper reference `astAddFrame' on page 942 undefined on input lin e 53232. LaTeX Warning: Hyper reference `FrameSet' on page 942 undefined on input line 5 3233. [942] LaTeX Warning: Hyper reference `KeyMap' on page 943 undefined on input line 532 46. LaTeX Warning: Hyper reference `astMapPutU' on page 943 undefined on input line 53248. LaTeX Warning: Hyper reference `astMapCopy' on page 943 undefined on input line 53256. LaTeX Warning: Hyper reference `MapLocked' on page 943 undefined on input line 53259. LaTeX Warning: Hyper reference `Object' on page 943 undefined on input line 532 66. LaTeX Warning: Hyper reference `astHasAttribute' on page 943 undefined on input line 53266. LaTeX Warning: Hyper reference `SkyFrame' on page 943 undefined on input line 5 3270. LaTeX Warning: Hyper reference `StcsChan' on page 943 undefined on input line 5 3283. LaTeX Warning: Hyper reference `Mapping' on page 943 undefined on input line 53 286. LaTeX Warning: Hyper reference `astQuadApprox' on page 943 undefined on input l ine 53287. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 943 undefined on input line 53291. LaTeX Warning: Hyper reference `Channel' on page 943 undefined on input line 53 295. LaTeX Warning: Hyper reference `Indent' on page 943 undefined on input line 532 95. LaTeX Warning: Hyper reference `astWrite' on page 943 undefined on input line 5 3297. [943] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 944 undefined on input li ne 53314. LaTeX Warning: Hyper reference `FitsChan' on page 944 undefined on input line 5 3327. LaTeX Warning: Hyper reference `astSet' on page 944 undefined on input line 533 32. LaTeX Warning: Hyper reference `FrameSet' on page 944 undefined on input line 5 3339. LaTeX Warning: Hyper reference `astRead' on page 944 undefined on input line 53 339. LaTeX Warning: Hyper reference `KeyMap' on page 944 undefined on input line 533 41. LaTeX Warning: Hyper reference `SortBy' on page 944 undefined on input line 533 41. LaTeX Warning: Hyper reference `astMapKey' on page 944 undefined on input line 53343. LaTeX Warning: Hyper reference `FitsChan' on page 944 undefined on input line 5 3363. LaTeX Warning: Hyper reference `TabOK' on page 944 undefined on input line 5336 5. LaTeX Warning: Hyper reference `Table' on page 944 undefined on input line 5336 8. LaTeX Warning: Hyper reference `KeyMap' on page 944 undefined on input line 533 68. LaTeX Warning: Hyper reference `FitsTable' on page 944 undefined on input line 53371. LaTeX Warning: Hyper reference `KeyCase' on page 944 undefined on input line 53 379. LaTeX Warning: Hyper reference `astMapRename' on page 944 undefined on input li ne 53387. [944] LaTeX Warning: Hyper reference `FitsChan' on page 945 undefined on input line 5 3398. LaTeX Warning: Hyper reference `TabOK' on page 945 undefined on input line 5339 8. LaTeX Warning: Hyper reference `astWrite' on page 945 undefined on input line 5 3401. LaTeX Warning: Hyper reference `astRead' on page 945 undefined on input line 53 409. LaTeX Warning: Hyper reference `astBBuf' on page 945 undefined on input line 53 424. LaTeX Warning: Hyper reference `astEBuf' on page 945 undefined on input line 53 424. LaTeX Warning: Hyper reference `Plot' on page 945 undefined on input line 53425 . LaTeX Warning: Hyper reference `ast_link' on page 945 undefined on input line 5 3429. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 945 undefined on inpu t line 53441. LaTeX Warning: Hyper reference `Region' on page 945 undefined on input line 534 43. LaTeX Warning: Hyper reference `Table' on page 945 undefined on input line 5345 6. [945] LaTeX Warning: Hyper reference `astFindFrame' on page 946 undefined on input li ne 53462. LaTeX Warning: Hyper reference `Frame' on page 946 undefined on input line 5346 3. LaTeX Warning: Hyper reference `SkyFrame' on page 946 undefined on input line 5 3465. LaTeX Warning: Hyper reference `FitsChan' on page 946 undefined on input line 5 3477. LaTeX Warning: Hyper reference `PolyTan' on page 946 undefined on input line 53 489. LaTeX Warning: Hyper reference `PolyMap' on page 946 undefined on input line 53 495. LaTeX Warning: Hyper reference `astPolyTran' on page 946 undefined on input lin e 53496. LaTeX Warning: Hyper reference `Channel' on page 946 undefined on input line 53 510. LaTeX Warning: Hyper reference `SourceFile' on page 946 undefined on input line 53513. LaTeX Warning: Hyper reference `SinkFile' on page 946 undefined on input line 5 3513. LaTeX Warning: Hyper reference `FitsChan' on page 946 undefined on input line 5 3515. LaTeX Warning: Hyper reference `FrameSet' on page 946 undefined on input line 5 3516. LaTeX Warning: Hyper reference `astRead' on page 946 undefined on input line 53 518. LaTeX Warning: Hyper reference `PolyMap' on page 946 undefined on input line 53 521. [946] LaTeX Warning: Hyper reference `Object' on page 947 undefined on input line 535 34. LaTeX Warning: Hyper reference `astToString' on page 947 undefined on input lin e 53534. LaTeX Warning: Hyper reference `astFromString' on page 947 undefined on input l ine 53536. LaTeX Warning: Hyper reference `PolyMap' on page 947 undefined on input line 53 539. LaTeX Warning: Hyper reference `FitsChan' on page 947 undefined on input line 5 3543. LaTeX Warning: Hyper reference `astWriteFits' on page 947 undefined on input li ne 53544. LaTeX Warning: Hyper reference `SinkFile' on page 947 undefined on input line 5 3546. LaTeX Warning: Hyper reference `Nkey' on page 947 undefined on input line 53550 . LaTeX Warning: Hyper reference `CardType' on page 947 undefined on input line 5 3557. LaTeX Warning: Hyper reference `astReadFits' on page 947 undefined on input lin e 53561. LaTeX Warning: Hyper reference `astRead' on page 947 undefined on input line 53 565. LaTeX Warning: Hyper reference `FitsChan' on page 947 undefined on input line 5 3584. LaTeX Warning: Hyper reference `Plot' on page 947 undefined on input line 53589 . LaTeX Warning: Hyper reference `astTuneC' on page 947 undefined on input line 5 3595. [947] LaTeX Warning: Hyper reference `FitsChan' on page 948 undefined on input line 5 3606. LaTeX Warning: Hyper reference `AlignSystem' on page 948 undefined on input lin e 53611. LaTeX Warning: Hyper reference `CmpFrame' on page 948 undefined on input line 5 3668. LaTeX Warning: Hyper reference `SkyFrame' on page 948 undefined on input line 5 3670. [948] LaTeX Warning: Hyper reference `CmpRegion' on page 949 undefined on input line 53673. LaTeX Warning: Hyper reference `Region' on page 949 undefined on input line 536 74. LaTeX Warning: Hyper reference `Plot3D' on page 949 undefined on input line 536 78. LaTeX Warning: Hyper reference `FitsChan' on page 949 undefined on input line 5 3708. LaTeX Warning: Hyper reference `FrameSet' on page 949 undefined on input line 5 3725. [949] LaTeX Warning: Hyper reference `astAddFrame' on page 950 undefined on input lin e 53750. LaTeX Warning: Hyper reference `FrameSet' on page 950 undefined on input line 5 3751. LaTeX Warning: Hyper reference `astRate' on page 950 undefined on input line 53 756. LaTeX Warning: Hyper reference `FitsChan' on page 950 undefined on input line 5 3768. LaTeX Warning: Hyper reference `SkyFrame' on page 950 undefined on input line 5 3768. LaTeX Warning: Hyper reference `SkyRefIs' on page 950 undefined on input line 5 3769. LaTeX Warning: Hyper reference `FrameSet' on page 950 undefined on input line 5 3775. LaTeX Warning: Hyper reference `Frame' on page 950 undefined on input line 5377 6. LaTeX Warning: Hyper reference `System' on page 950 undefined on input line 537 77. LaTeX Warning: Hyper reference `astMapDefined' on page 950 undefined on input l ine 53789. LaTeX Warning: Hyper reference `KeyMap' on page 950 undefined on input line 537 90. LaTeX Warning: Hyper reference `FrameSet' on page 950 undefined on input line 5 3809. LaTeX Warning: Hyper reference `Frame' on page 950 undefined on input line 5380 9. LaTeX Warning: Hyper reference `Mapping' on page 950 undefined on input line 53 812. LaTeX Warning: Hyper reference `Variant' on page 950 undefined on input line 53 812. [950] LaTeX Warning: Hyper reference `Ident' on page 951 undefined on input line 5381 5. LaTeX Warning: Hyper reference `astSimplify' on page 951 undefined on input lin e 53817. LaTeX Warning: Hyper reference `KeyMap' on page 951 undefined on input line 538 45. LaTeX Warning: Hyper reference `SortBy' on page 951 undefined on input line 538 47. LaTeX Warning: Hyper reference `FitsChan' on page 951 undefined on input line 5 3849. LaTeX Warning: Hyper reference `FitsChan' on page 951 undefined on input line 5 3862. LaTeX Warning: Hyper reference `CardName' on page 951 undefined on input line 5 3862. LaTeX Warning: Hyper reference `CardComm' on page 951 undefined on input line 5 3862. [951] LaTeX Warning: Hyper reference `SimpVertices' on page 952 undefined on input li ne 53883. LaTeX Warning: Hyper reference `Polygon' on page 952 undefined on input line 53 886. LaTeX Warning: Hyper reference `PolyMap' on page 952 undefined on input line 53 902. LaTeX Warning: Hyper reference `Base' on page 952 undefined on input line 53919 . LaTeX Warning: Hyper reference `Current' on page 952 undefined on input line 53 919. LaTeX Warning: Hyper reference `FrameSet' on page 952 undefined on input line 5 3919. LaTeX Warning: Hyper reference `Domain' on page 952 undefined on input line 539 20. LaTeX Warning: Hyper reference `Frame' on page 952 undefined on input line 5392 0. LaTeX Warning: Hyper reference `astWrite' on page 952 undefined on input line 5 3921. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 952 undefined on input l ine 53922. LaTeX Warning: Hyper reference `astAppendString' on page 952 undefined on input line 53924. LaTeX Warning: Hyper reference `astAppendString' on page 952 undefined on input line 53937. LaTeX Warning: Hyper reference `astAppendStringf' on page 952 undefined on inpu t line 53938. [952] LaTeX Warning: Hyper reference `astTranGrid' on page 953 undefined on input lin e 53952. LaTeX Warning: Hyper reference `astAddFrame' on page 953 undefined on input lin e 53971. LaTeX Warning: Hyper reference `FrameSet' on page 953 undefined on input line 5 3972. LaTeX Warning: Hyper reference `Mapping' on page 953 undefined on input line 53 972. LaTeX Warning: Hyper reference `Frame' on page 953 undefined on input line 5397 3. LaTeX Warning: Hyper reference `astRegionOutline' on page 953 undefined on inpu t line 53985. LaTeX Warning: Hyper reference `Plot' on page 953 undefined on input line 53986 . LaTeX Warning: Hyper reference `Region' on page 953 undefined on input line 539 87. LaTeX Warning: Hyper reference `SkyFrame' on page 953 undefined on input line 5 3998. [953] LaTeX Warning: Hyper reference `LutMap' on page 954 undefined on input line 540 03. LaTeX Warning: Hyper reference `LutEpsilon' on page 954 undefined on input line 54003. LaTeX Warning: Hyper reference `SkyFrame' on page 954 undefined on input line 5 4016. LaTeX Warning: Hyper reference `SkyTol' on page 954 undefined on input line 540 16. LaTeX Warning: Hyper reference `Mapping' on page 954 undefined on input line 54 018. LaTeX Warning: Hyper reference `FitsChan' on page 954 undefined on input line 5 4021. LaTeX Warning: Hyper reference `Warnings' on page 954 undefined on input line 5 4028. LaTeX Warning: Hyper reference `astWarnings' on page 954 undefined on input lin e 54029. LaTeX Warning: Hyper reference `Mapping' on page 954 undefined on input line 54 054. LaTeX Warning: Hyper reference `UnitNormMap' on page 954 undefined on input lin e 54054. LaTeX Warning: Hyper reference `GrismMap' on page 954 undefined on input line 5 4069. LaTeX Warning: Hyper reference `LutMap' on page 954 undefined on input line 540 69. LaTeX Warning: Hyper reference `PcdMap' on page 954 undefined on input line 540 69. LaTeX Warning: Hyper reference `SphMap' on page 954 undefined on input line 540 69. LaTeX Warning: Hyper reference `WcsMap' on page 954 undefined on input line 540 69. LaTeX Warning: Hyper reference `ZoomMap' on page 954 undefined on input line 54 069. [954] LaTeX Warning: Hyper reference `astAxNorm' on page 955 undefined on input line 54080. LaTeX Warning: Hyper reference `Frame' on page 955 undefined on input line 5408 1. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 955 undefined on in put line 54086. LaTeX Warning: Hyper reference `NormMap' on page 955 undefined on input line 54 102. LaTeX Warning: Hyper reference `Frame' on page 955 undefined on input line 5410 4. LaTeX Warning: Hyper reference `UnitMap' on page 955 undefined on input line 54 105. LaTeX Warning: Hyper reference `astTimeAdd' on page 955 undefined on input line 54107. LaTeX Warning: Hyper reference `TimeMap' on page 955 undefined on input line 54 108. LaTeX Warning: Hyper reference `astSlaAdd' on page 955 undefined on input line 54112. LaTeX Warning: Hyper reference `SlaMap' on page 955 undefined on input line 541 13. LaTeX Warning: Hyper reference `astSpecAdd' on page 955 undefined on input line 54117. LaTeX Warning: Hyper reference `SpecMap' on page 955 undefined on input line 54 118. LaTeX Warning: Hyper reference `astMapRegion' on page 955 undefined on input li ne 54129. LaTeX Warning: Hyper reference `Region' on page 955 undefined on input line 541 30. LaTeX Warning: Hyper reference `Mapping' on page 955 undefined on input line 54 132. [955] LaTeX Warning: Hyper reference `Mapping' on page 956 undefined on input line 54 146. LaTeX Warning: Hyper reference `ChebyMap' on page 956 undefined on input line 5 4146. LaTeX Warning: Hyper reference `PolyMap' on page 956 undefined on input line 54 149. LaTeX Warning: Hyper reference `TranForward' on page 956 undefined on input lin e 54150. LaTeX Warning: Hyper reference `TranInverse' on page 956 undefined on input lin e 54150. LaTeX Warning: Hyper reference `KeyMap' on page 956 undefined on input line 541 53. LaTeX Warning: Hyper reference `astMapGetC' on page 956 undefined on input line 54154. LaTeX Warning: Hyper reference `astSetPutErr' on page 956 undefined on input li ne 54163. LaTeX Warning: Hyper reference `Frame' on page 956 undefined on input line 5416 8. LaTeX Warning: Hyper reference `Epoch' on page 956 undefined on input line 5417 0. LaTeX Warning: Hyper reference `TimeMap' on page 956 undefined on input line 54 175. LaTeX Warning: Hyper reference `Dtai' on page 956 undefined on input line 54176 . LaTeX Warning: Hyper reference `astLinearApprox' on page 956 undefined on input line 54195. LaTeX Warning: Hyper reference `Mapping' on page 956 undefined on input line 54 195. [956] LaTeX Warning: Hyper reference `astWrite' on page 957 undefined on input line 5 4203. LaTeX Warning: Hyper reference `FitsChan' on page 957 undefined on input line 5 4203. LaTeX Warning: Hyper reference `SipOK' on page 957 undefined on input line 5420 6. LaTeX Warning: Hyper reference `FrameSet' on page 957 undefined on input line 5 4207. LaTeX Warning: Hyper reference `PolyMap' on page 957 undefined on input line 54 208. LaTeX Warning: Hyper reference `astCreatedAt' on page 957 undefined on input li ne 54210. LaTeX Warning: Hyper reference `astAddFrame' on page 957 undefined on input lin e 54219. LaTeX Warning: Hyper reference `Region' on page 957 undefined on input line 542 33. LaTeX Warning: Hyper reference `FitsChan' on page 957 undefined on input line 5 4233. LaTeX Warning: Hyper reference `Mapping' on page 957 undefined on input line 54 239. [957] (./sun211.aux) kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1440 mkdir: cannot create directory '././nonexistent': Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1440 This is METAFONT, Version 2.7182818 (TeX Live 2019/dev/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1440.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1440.tfm. Output written on ectt1440.600gf (256 characters, 61024 bytes). Transcript written on ectt1440.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1440.600pk: successfully generated. Package rerunfilecheck Warning: File `sun211.out' has changed. (rerunfilecheck) Rerun to get outlines right (rerunfilecheck) or use package `bookmark'. LaTeX Font Warning: Some font shapes were not available, defaults substituted. LaTeX Warning: There were undefined references. LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right. ) (\end occurred inside a group at level 1) ### simple group (level 1) entered at line 6511 ({) ### bottom level (see the transcript file for additional information) {/usr/share/texlive/texmf-dist/fonts/enc/dvips/base/8 r.enc} kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1095 mkdir: cannot create directory '././nonexistent': Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1095 This is METAFONT, Version 2.7182818 (TeX Live 2019/dev/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1095.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1095.tfm. Output written on ectt1095.600gf (256 characters, 47796 bytes). Transcript written on ectt1095.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1095.600pk: successfully generated. kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1000 mkdir: cannot create directory '././nonexistent': Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1000 This is METAFONT, Version 2.7182818 (TeX Live 2019/dev/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1000.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1000.tfm. Output written on ectt1000.600gf (256 characters, 43832 bytes). Transcript written on ectt1000.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1000.600pk: successfully generated. kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt0900 mkdir: cannot create directory '././nonexistent': Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt0900 This is METAFONT, Version 2.7182818 (TeX Live 2019/dev/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt0900.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [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]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt0900.tfm. Output written on ectt0900.600gf (256 characters, 39464 bytes). Transcript written on ectt0900.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt0900.600pk: successfully generated. Output written on sun211.pdf (961 pages, 2361203 bytes). Transcript written on sun211.log. This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2019/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2018-12-01> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2018/09/03 v1.4i Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size11.clo)) ..........Article!.......... (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifpdf.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty (/usr/share/texlive/texmf-dist/tex/latex/base/t1enc.def)) (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype-pdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/mathpazo.sty) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3-code.tex) (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/l3pdfmode.def)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/multirow/multirow.sty) (/usr/share/texlive/texmf-dist/tex/latex/enumitem/enumitem.sty) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/dvipsnam.def) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/svgnam.def)) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/kvsetkeys.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/etexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifluatex.sty)))) (/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/zref-abspage.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/zref-base.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/pdftexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/auxhook.sty)) (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/atbegshi.sty)) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/frontendlayer/tikz.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgf.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfrcs.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common-lists.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-latex.def (/usr/share/texlive/texmf-dist/tex/latex/ms/everyshi.sty)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfrcs.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/pgf.revision.tex))) (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgfcore.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/systemlayer/pgfsys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeysfiltered.code.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgf.cfg) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-pdftex.def (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-common-pdf.de f))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsyssoftpath.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsysprotocol.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcore.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathcalc.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathutil.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathparser.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.basic.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.trigonomet ric.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.random.cod e.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.comparison .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.base.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.round.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.misc.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.integerari thmetics.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepoints.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathconstruct. code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathusage.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorescopes.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoregraphicstate.c ode.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoretransformation s.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorequick.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreobjects.code.t ex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepathprocessing .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorearrows.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreshade.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreimage.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoreexternal.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorelayers.code.te x) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcoretransparency.c ode.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorepatterns.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcorerdf.code.tex)) ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmoduleshapes.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmoduleplot.code.tex ) (/usr/share/texlive/texmf-dist/tex/latex/pgf/compatibility/pgfcomp-version-0-65 .sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/compatibility/pgfcomp-version-1-18 .sty)) (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgffor.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfkeys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex)) (/usr/share/texlive/texmf-dist/tex/latex/pgf/math/pgfmath.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgffor.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/tikz.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/libraries/pgflibraryplothandlers .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmodulematrix.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/libraries/tik zlibrarytopaths.code.tex))) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/md-frame-1.mdf)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/rotating.sty (/usr/share/texlive/texmf-dist/tex/latex/base/ifthen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/pdflscape.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/lscape.sty) (/usr/share/texlive/texmf-dist/tex/generic/ifxetex/ifxetex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/ifvtex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titling/titling.sty) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty) (/usr/share/texlive/texmf-dist/tex/latex/tocloft/tocloft.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/hobsub-generic.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/hyperref.cfg) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/rerunfilecheck.sty)) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty Style option: `fancyvrb' v3.2a <2019/01/15> (tvz)) (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty) (/usr/share/texlive/texmf-dist/tex/latex/eqparbox/eqparbox.sty (/usr/share/texlive/texmf-dist/tex/latex/environ/environ.sty (/usr/share/texlive/texmf-dist/tex/latex/trimspaces/trimspaces.sty))) (./starabbrev.sty ... Using standard SIunitx degrees ) (./starstyle.sty (/usr/share/texlive/texmf-dist/tex/latex/titlesec/ttlkeys.def)) (./sst.sty)) (./sun211.aux LaTeX Warning: Label `astSet' multiply defined. LaTeX Warning: Label `{xref_changes}' multiply defined. LaTeX Warning: Label `{xref_list_of_most_recent_changes}' multiply defined. ) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/base/ts1enc.dfu) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator-basic-dictionary -English.dict) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx-abbreviations.cfg) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/grfext.sty) (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) ABD: EveryShipout initializing macros *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty)) (./sun211.out) (./sun211.out) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omlzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omszplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omxzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1zplm.fd) Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map} <./sun211_figures/fronta. pdf> <./sun211_figures/frontb.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontb.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page > <./sun211_figures/frontc.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontc.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page >] [2] (./sun211.toc [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20]) [21] (./sun211.lof) [22] [1] (/usr/share/texlive/texmf-dist/tex/latex/base/t1cmtt.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omsppl.fd) [2] [3] [4] [5 <./su n211_figures/mapping.pdf>] Overfull \hbox (16.86678pt too wide) in paragraph at lines 316--318 []\T1/ppl/m/n/10.95 (-20) Various lin-ear co-or-di-nate trans-for-ma-tions (the []Ma-trixMap[], []Win-Map[], []ShiftMap[] and []ZoomMap[]). [6] [7 <./sun211_figures/series.pdf> <./sun211_figures/parallel.pdf>] [8 <./sun 211_figures/complex.pdf>] [9 <./sun211_figures/frames.pdf>] [10 <./sun211_figur es/cmpframe.pdf>] [11 <./sun211_figures/frameset.pdf>] [12] [13 <./sun211_figur es/gridplot_bw.pdf>] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27 <./sun211_figures/overgrid_bw.pdf>] [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 <./sun211_ figures/simpexamp.pdf>] [62] [63] [64] [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] LaTeX Warning: Float too large for page by 241.1866pt on input line 4738. [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 <./sun211_figures/fsexample.pdf>] [114] [115] [116] [117] [118] [119 <./sun211_figures/fsconvert.pdf>] [120] [121 <./sun211_figures/fsalign.pdf>] [122] [123] [124] [125 <./sun211_figures/f sremap.pdf>] [126] [127] [128 <./sun211_figures/fsmerge.pdf>] [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] Overfull \hbox (135.34566pt too wide) in paragraph at lines 9623--9626 []\T1/ppl/m/n/10.95 (-20) The outer-most XML el-e-ment of an AST ob-ject will s et the de-fault names-pace to [][]\T1/cmtt/m/n/10.95 http://www.starlink.ac.uk/ ast/xml/ [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] Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the Report attribute for Object " map" to the value 1 a nd the Zoom Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the []Label(axis)[] attribute for Object " frame" to a suitable string, where Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 Underfull \hbox (badness 10000) in paragraph at lines 11102--11102 [] \T1/cmtt/m/n/10 Sets the Title attribute for Object " frame" to the contents of the string " LaTeX Font Warning: Font shape `OMS/cmtt/m/n' undefined (Font) using `OMS/cmsy/m/n' instead (Font) for symbol `textbullet' on input line 11102. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 White space may also surround attribute values, where it wi ll generally be ignored Overfull \hbox (5.09616pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [192] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 To include a literal comma in the value assigned to an attr ibute, the whole attribute Overfull \hbox (10.60732pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 value should be enclosed in quotation markes. Alternatively, yo u can use " %s" Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 format and supply the value as a separate additional argument t o astSet (or use Overfull \hbox (5.62103pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 The same procedure may be adopted if " %" signs are to be i ncluded and are not Overfull \hbox (10.86975pt too wide) in paragraph at lines 11102--11102 \T1/cmtt/m/n/10 to be interpreted as format specifiers (alternatively, the " pr intf" convention Overfull \hbox (33.43924pt too wide) in paragraph at lines 11102--11102 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [193] Overfull \hbox (28.19052pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 If NULL, then the returned KeyMap will contain pointers ofr Obj ects of all classes. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 If not NULL, then " class" should be a pointer to a null-termin ated string holding Overfull \hbox (0.10988pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 the name of an AST class. The returned KeyMap will contain poin ters only for Overfull \hbox (5.3586pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A Boolean flag indicating if all subclasses of the class specif ied by " class" Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 should be included in the returned KeyMap. If zero, then subcla ss objects are Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 not returned. Otherwise they are returned. The supplied " subcl ass" value is Overfull \hbox (10.60732pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A Boolean flag indicating if the returned list of pointers shou ld be restricted Overfull \hbox (28.19052pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 to pointers issued within the current AST object context (see [ ]astBegin[] and []astEnd[]). Underfull \hbox (badness 10000) in paragraph at lines 11183--11183 Overfull \hbox (12.49844pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 A pointer to a new KeyMap holding the required object pointers. They KeyMap pointer Overfull \hbox (2.52588pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 should be annulled when it is no longer needed, but the object pointers within the Overfull \hbox (7.7746pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 KeyMap should not be annulled. A NULL pointer is returned if an error has occurred Overfull \hbox (2.26344pt too wide) in paragraph at lines 11183--11183 []\T1/cmtt/m/n/10 The values stored in the KeyMap should be accessed as generic C pointers using the Overfull \hbox (12.44437pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 This function will only return objects locked by the curren tly executing thread. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 The KeyMap pointer returned by this function is not include d in the list of active Overfull \hbox (5.62103pt too wide) in paragraph at lines 11183--11183 [][]\T1/cmtt/m/n/10 Objects that were created using the Fortran interface will have a null " file" Overfull \hbox (10.60732pt too wide) in paragraph at lines 11183--11183 \T1/cmtt/m/n/10 value and will have a routine name equal to the upper case Fort ran routine that [194] Overfull \hbox (5.52135pt too wide) in paragraph at lines 11277--11277 []\T1/cmtt/m/n/10 void astAddColumn( AstTable $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int type, int ndim, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 dims, Overfull \hbox (17.43065pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). Overfull \hbox (0.10988pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 The number of dimensions spanned by the values stored in a sing le cell of the Overfull \hbox (21.10475pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 An array holding the the lengths of each of the axes spanned by the values stored Overfull \hbox (21.10475pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 A string specifying the units of the column. Supply a blank str ing if the column Overfull \hbox (41.62883pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 Tables can hold columns with any of the following data types - AST__INTTYPE (for integer), Overfull \hbox (36.38011pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 AST__SINTTYPE (for short int), AST__BYTETYPE (for unsigned byte s - i.e. unsigned chars), Overfull \hbox (49.5019pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 AST__DOUBLETYPE (for double precision floating point), AST__FLO ATTYPE (for single precision Overfull \hbox (34.01819pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 floating point), AST__STRINGTYPE (for character string), AST__O BJECTTYPE (for AST []Object[] Overfull \hbox (18.27203pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 pointer), AST__POINTERTYPE (for arbitrary C pointer) or AST__UN DEFTYPE (for undefined Overfull \hbox (12.76088pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 FitsTables can hold columns with any of the following data type s - AST__INTTYPE (for Overfull \hbox (49.76434pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 integer), AST__SINTTYPE (for short int), AST__BYTETYPE (for uns igned bytes - i.e. unsigned Overfull \hbox (2.26344pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 chars), AST__DOUBLETYPE (for double precision floating point), AST__FLOATTYPE (for Overfull \hbox (21.36719pt too wide) in paragraph at lines 11277--11277 [][]\T1/cmtt/m/n/10 This function returns without action if a column already ex ists in the Table with Overfull \hbox (0.37231pt too wide) in paragraph at lines 11277--11277 \T1/cmtt/m/n/10 the supplied name and properties. However an error is reported if any of the [195] Overfull \hbox (7.09596pt too wide) in paragraph at lines 11395--11395 []\T1/cmtt/m/n/10 void astAddFrame( AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, int iframe, AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame ) Overfull \hbox (15.85603pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 The index of the Frame within the FrameSet which describes the coordinate system Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 upon which the new one is to be based. This value should lie in the range from Overfull \hbox (38.42552pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 1 to the number of Frames already in the FrameSet (as given by its []Nframe[] attribute). Overfull \hbox (21.10475pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 As a special case, AST__ALLFRAMES may be supplied, in which cas e the axes defined Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by the supplied Frame are appended to every Frame in the FrameS et (see the Notes Overfull \hbox (52.8595pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Pointer to a Mapping which describes how to convert coordinates from the old coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 system (described by the Frame with index " iframe" ) into coor dinates in the Overfull \hbox (23.99155pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 new system. The Mapping' s forward transformation should perfor m this conversion, Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 and its inverse transformation should convert in the opposite d irection. The Overfull \hbox (1.94693pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 supplied Mapping is ignored if parameter " iframe" is equal to AST__ALLFRAMES. Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Pointer to a Frame that describes the new coordinate system. An y class of Frame Overfull \hbox (10.60732pt too wide) in paragraph at lines 11395--11395 []\T1/cmtt/m/n/10 This function may also be used to merge two FrameSets by supp lying a pointer to Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 Deep copies of the supplied " mapping" and " frame" objects are stored within Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 the modified FrameSet. So any changes made to the FrameSet afte r calling this Overfull \hbox (0.10988pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 This function sets the value of the []Current[] attribute f or the FrameSet so that Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 The number of input coordinate values accepted by the suppl ied Mapping (its []Nin[] Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 attribute) must match the number of axes in the Frame identifie d by the " iframe" Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 parameter. Similarly, the number of output coordinate values ge nerated by this Overfull \hbox (23.99155pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 As a special case, if a pointer to a FrameSet is given for the " frame" parameter, Overfull \hbox (42.36206pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 this is treated as a request to merge a pair of FrameSets. This is done by appending Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 all the new Frames (in the " frame" FrameSet) to the original F rameSet, while Overfull \hbox (20.31744pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 preserving their order and retaining all the inter-relationship s (i.e. Mappings) Overfull \hbox (26.6159pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 between them. The two sets of Frames are inter-related within t he merged FrameSet Overfull \hbox (16.11847pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by using the Mapping supplied. This should convert between the Frame identified Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 by the " iframe" parameter (in the original FrameSet) and the c urrent Frame of Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 the " frame" FrameSet. This latter Frame becomes the current Fr ame in the merged [196] Overfull \hbox (10.60732pt too wide) in paragraph at lines 11395--11395 [][]\T1/cmtt/m/n/10 As another special case, if a value of AST__ALLFRAMES is su pplied for parameter Overfull \hbox (0.37231pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 " iframe" , then the supplied Mapping is ignored, and the axes defined by the Overfull \hbox (21.36719pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 supplied Frame are appended to each Frame in the FrameSet. In d etail, each Frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 in the FrameSet is replaced by a []CmpFrame[] containing the or iginal Frame and the Overfull \hbox (26.6159pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 Frame specified by parameter " frame" . In addition, each Mappi ng in the FrameSet Overfull \hbox (22.9418pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 is replaced by a []CmpMap[] containing the original Mapping and a []UnitMap[] in parallel. Overfull \hbox (5.3586pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 The Nin and Nout attributes of the UnitMap are set equal to the number of axes Overfull \hbox (5.62103pt too wide) in paragraph at lines 11395--11395 \T1/cmtt/m/n/10 in the supplied Frame. Each new CmpMap is simplified using []as tSimplify[] before [197] Overfull \hbox (33.1768pt too wide) in paragraph at lines 11431--11431 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11431--11431 [][]\T1/cmtt/m/n/10 Unlike columns, the definition of a parameter does not spec ify its type, size [198] Overfull \hbox (16.11847pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 Pointer to a Mapping which describes how to convert coordinates from the current Overfull \hbox (0.37231pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 Frame to the new variant of the current Frame. If NULL is suppl ied, then the Overfull \hbox (10.86975pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 name associated with the currently selected variant of the curr ent Frame is set Overfull \hbox (0.10988pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 The name to associate with the new variant Mapping (or the curr ently selected Overfull \hbox (10.86975pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 The newly added Variant becomes the current variant on exit (this is equivalent Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 An error is reported if a variant with the supplied name al ready exists in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 [][]\T1/cmtt/m/n/10 An error is reported if the current Frame is a mirror for t he variant Mappings Overfull \hbox (5.62103pt too wide) in paragraph at lines 11491--11491 \T1/cmtt/m/n/10 in another Frame. This is only the case if the []astMirrorVaria nts[] function has [199] Overfull \hbox (18.48322pt too wide) in paragraph at lines 11558--11558 []\T1/cmtt/m/n/10 double astAngle( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const double a[], const double b[], const double c[] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Naxes[] attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11558--11558 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (15.38524pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 The angle in radians, from the line AB to the line CB. If the F rame is 2-dimensional, Overfull \hbox (39.68927pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 it will be in the range $$\OMS/zplm/m/n/10 n$\T1/cmtt/m/n/10 pm $\OMS/zplm/m/n/10 n$\T1/cmtt/m/n/10 pi$, and positive rotation is in the same sense as rotation Overfull \hbox (2.52588pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 from the positive direction of axis 2 to the positive direction of axis 1. If the Overfull \hbox (23.52075pt too wide) in paragraph at lines 11558--11558 \T1/cmtt/m/n/10 Frame has more than 2 axes, a positive value will always be ret urned in the range zero Overfull \hbox (10.60732pt too wide) in paragraph at lines 11558--11558 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if points A and B are co-incident, or Overfull \hbox (5.62103pt too wide) in paragraph at lines 11558--11558 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if this function is invoked with the [200] Overfull \hbox (31.60219pt too wide) in paragraph at lines 11615--11615 [][]\T1/cmtt/m/n/10 This function will attempt to annul the pointer even if the Object is not currently Overfull \hbox (8.24539pt too wide) in paragraph at lines 11615--11615 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 11615--11615 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Overfull \hbox (13.49411pt too wide) in paragraph at lines 11615--11615 \T1/cmtt/m/n/10 circumstances. In particular, it will fail if the pointer suppl ed is not valid, [201] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11682--11682 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Naxes[] attribute) containing Overfull \hbox (42.36206pt too wide) in paragraph at lines 11682--11682 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (31.60219pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 The number of the Frame axis from which the angle is to be meas ured (axis numbering Overfull \hbox (12.76088pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 The angle in radians, from the positive direction of the specif ied axis, to the line Overfull \hbox (26.35948pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 AB. If the Frame is 2-dimensional, it will be in the range [-PI /2,$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 PI/2], and positive Overfull \hbox (2.52588pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 rotation is in the same sense as rotation from the positive dir ection of axis 2 to Overfull \hbox (23.52075pt too wide) in paragraph at lines 11682--11682 \T1/cmtt/m/n/10 the positive direction of axis 1. If the Frame has more than 2 axes, a positive value Overfull \hbox (21.36719pt too wide) in paragraph at lines 11682--11682 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 11682--11682 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [202] Overfull \hbox (0.10988pt too wide) in paragraph at lines 11742--11742 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has Overfull \hbox (5.62103pt too wide) in paragraph at lines 11742--11742 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 11742--11742 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [203] Overfull \hbox (39.63802pt too wide) in paragraph at lines 11816--11816 []\T1/cmtt/m/n/10 void astAxNorm( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, int axis, int oper, int nval, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 values, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 status Overfull \hbox (0.10988pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has Overfull \hbox (68.60565pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 Indicates the type of normalisation to be applied. If zero is s upplied, the normalisation Overfull \hbox (5.3586pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 will be the same as that performed by function []astNorm[]. If 1 is supplied, the Overfull \hbox (0.37231pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 normalisation will be chosen automatically so that the resultin g list has the Overfull \hbox (37.11334pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 On entry, the axis values to be normalised. Modified on exit to hold the normalised Overfull \hbox (7.98578pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 If " oper" is 0, longitude values are returned in the range [0, 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 PI]. If " oper" is Overfull \hbox (18.22078pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 1, longitude values are returned in either the range [0,2$\OMS/ zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 PI] or [-PI,PI]. The choice Overfull \hbox (13.02332pt too wide) in paragraph at lines 11816--11816 \T1/cmtt/m/n/10 is made so that that the resulting list has the smallest range. Latitude values are [204] Overfull \hbox (0.10988pt too wide) in paragraph at lines 11876--11876 \T1/cmtt/m/n/10 The index of the axis to which the supplied values refer. The f irst axis has Overfull \hbox (5.62103pt too wide) in paragraph at lines 11876--11876 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 11876--11876 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [205] Overfull \hbox (10.86975pt too wide) in paragraph at lines 11909--11909 [][]\T1/cmtt/m/n/10 The nature of the buffering is determined by the underlying graphics system (as Overfull \hbox (16.11847pt too wide) in paragraph at lines 11909--11909 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function to this function [206] [207] Overfull \hbox (34.01819pt too wide) in paragraph at lines 12012--12012 \T1/cmtt/m/n/10 Zero is returned if the plotting space is completely filled by valid, unclipped physical Overfull \hbox (5.15024pt too wide) in paragraph at lines 12012--12012 \T1/cmtt/m/n/10 coordinates (so that only a rectangular box was drawn around th e edge). Otherwise, Overfull \hbox (10.60732pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (0.37231pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 An error results if either the current Frame or the base Fr ame of the Plot is Overfull \hbox (10.86975pt too wide) in paragraph at lines 12012--12012 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames [208] Overfull \hbox (15.85603pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 A two element array in which is returned the lower limits of th e bounding box on Overfull \hbox (0.37231pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e []Frame[] of the Overfull \hbox (15.85603pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 A two element array in which is returned the upper limits of th e bounding box on Overfull \hbox (0.37231pt too wide) in paragraph at lines 12057--12057 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e Frame of the [209] Overfull \hbox (31.55376pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 AstBox $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astBox( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double point1[], const double point2[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (16.11847pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 Indicates how the box is described by the remaining parameters. A value of zero Overfull \hbox (7.19565pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 indicates that the box is specified by a centre position and a corner position. Overfull \hbox (43.67424pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 A value of one indicates that the box is specified by a two opp osite corner positions. Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute). If Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 " form" is zero, this array should contain the coordinates at t he centre of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 box. If " form" is one, it should contain the coordinates at th e corner of the Overfull \hbox (42.09962pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (47.34834pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 with the boundary of the Box being created. The uncertainty in any point on the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 boundary of the Box is found by shifting the supplied " uncerta inty" Region so Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 that it is centred at the boundary point being considered. The area covered by Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the shifted uncertainty Region then represents the uncertainty in the boundary Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, []Circle[], []Ellipse[], etc.) o r be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 will have no effect on the created Box. Alternatively, a NULL [ ]Object[] pointer may Overfull \hbox (31.86462pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 be supplied, in which case a default uncertainty is used equiva lent to a box 1.0E-6 Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [210] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (0.10988pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Bo x. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 12195--12195 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 12195--12195 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 12195--12195 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 12195--12195 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [211] Overfull \hbox (8.56807pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 AstChannel $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChannel( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/cm tt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink)( const char $\OMS/zplm/m/n/10 ^^C$ Overfull \hbox (0.37231pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (21.36719pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 this function will be used by the Channel to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 invocation, it should return a pointer to the next input line r ead from some external Overfull \hbox (16.11847pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 this function will be used by the Channel to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 12294--12294 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the Overfull \hbox (10.86975pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ch annel. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 12294--12294 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (26.6159pt too wide) in paragraph at lines 12294--12294 [][]\T1/cmtt/m/n/10 Application code can pass arbitrary data (such as file desc riptors, etc) to source Overfull \hbox (42.36206pt too wide) in paragraph at lines 12294--12294 \T1/cmtt/m/n/10 and sink functions using the []astPutChannelData[] function. Th e source or sink function [212] Overfull \hbox (5.62103pt too wide) in paragraph at lines 12294--12294 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [213] Overfull \hbox (28.2446pt too wide) in paragraph at lines 12336--12336 \T1/cmtt/m/n/10 The pointer previously stored with the Channel using astPutChan nelData. A NULL pointer [214] Overfull \hbox (36.8509pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 A non-zero value indicates that the domain of the ChebyMap' s f orward transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 is to be returned, while a zero value indicates that the domain of the inverse Overfull \hbox (33.43924pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 Pointer to an array in which to return the lower axis bounds of the ChebyMap domain. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 The number of elements should be at least equal to the number o f ChebyMap inputs Overfull \hbox (33.43924pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 Pointer to an array in which to return the upper axis bounds of the ChebyMap domain. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 The number of elements should be at least equal to the number o f ChebyMap inputs Overfull \hbox (26.6159pt too wide) in paragraph at lines 12402--12402 [][]\T1/cmtt/m/n/10 If the requested transformation is undefined (i.e. no trans formation coefficients Overfull \hbox (31.60219pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 were specified when the ChebyMap was created), this method retu rns a box determined Overfull \hbox (63.35693pt too wide) in paragraph at lines 12402--12402 \T1/cmtt/m/n/10 using the []astMapBox[] method on the opposite transformation, if the opposite transformation Overfull \hbox (0.37231pt too wide) in paragraph at lines 12402--12402 [][]\T1/cmtt/m/n/10 If the above procedure fails to determine a bounding box, t he supplied arrays [215] Overfull \hbox (23.4695pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 AstChebyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChebyMap ( int nin, int nout, int ncoeff_f, const double coeff_f[], int Overfull \hbox (18.27203pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ncoeff_i, const double coeff_i[], const double lbnd_f[], const double ubnd_f[], const Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the for ward transformation Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the ChebyMap. If zero is supplied, the forward transformatio n will be undefined. Overfull \hbox (17.02083pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing " ncoeff_f$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" Overfull \hbox (1.94693pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the forward transformation. Overfull \hbox (36.8509pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 Within each such group, the first element is the coefficient va lue; the next element Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 is the integer index of the ChebyMap output which uses the coef ficient within Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 its defining expression (the first output has index 1); the rem aining elements Overfull \hbox (37.11334pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the group give the integer powers to use with each input coo rdinate value (powers Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). [216] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 For instance, if the ChebyMap has 3 inputs and 2 outputs, eac h group consisting Overfull \hbox (37.11334pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of 5 elements, A groups such as " (1.2, 2.0, 1.0, 3.0, 0.0)" de scribes a coefficient Overfull \hbox (21.10475pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 with value 1.2 which is used within the definition of output 2. The output value Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 is incremented by the product of the coefficient value, the val ue of the Chebyshev Overfull \hbox (42.09962pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 polynomial of power 1 evaluated at input coordinate 1, and the value of the Chebyshev Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 polynomial of power 3 evaluated at input coordinate 2. Input co ordinate 3 is Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 not used since its power is specified as zero. As another examp le, the group Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 " (-1.0, 1.0, 0.0, 0.0, 0.0 )" adds a constant value -1.0 onto output 1 (it is Overfull \hbox (16.11847pt too wide) in paragraph at lines 12615--12615 []\T1/cmtt/m/n/10 Each final output coordinate value is the sum of the " ncoeff _f" terms described Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the inv erse transformation Overfull \hbox (33.43924pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of the ChebyMap. If zero is supplied, the inverse transformatio n will be undefined. Overfull \hbox (27.51826pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing " ncoeff_i$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" Overfull \hbox (2.99667pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the inverse transformation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 using the same schame as " coeff_f" , except that " inputs" and " outputs" are Overfull \hbox (26.6159pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the lower bounds of the input bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_f is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the upper bounds of the input bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_f is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (15.85603pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the lower bounds of the output bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_i is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (15.85603pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 An array containing the upper bounds of the output bounding box within which the Overfull \hbox (13.49411pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 ChebyMap is defined. This argument is not used or accessed if n coeff_i is zero, Overfull \hbox (0.37231pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 and so a NULL pointer may be supplied. If supplied, the array s hould contain Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ch ebyMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format [217] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12615--12615 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12615--12615 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 12615--12615 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [218] Overfull \hbox (13.18324pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 AstCircle $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCircle( As tFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double cent re[], const double Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 Indicates how the circle is described by the remaining paramete rs. A value of Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 zero indicates that the circle is specified by a centre positio n and a position Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 on the circumference. A value of one indicates that the circle is specified by Overfull \hbox (42.09962pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute) containing Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 If " form" is zero, then this array should have one element for each Frame axis Overfull \hbox (10.34488pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 (Naxes attribute), and should be supplied holding the coordinat es at a point on Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the circumference of the circle or sphere. If " form" is one, t hen this array Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 should have one element only which should be supplied holding t he scalar radius Overfull \hbox (47.34834pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 with the boundary of the Circle being created. The uncertainty in any point on Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 the boundary of the Circle is found by shifting the supplied " uncertainty" Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 so that it is centred at the boundary point being considered. T he area covered Overfull \hbox (21.10475pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 by the shifted uncertainty Region then represents the uncertain ty in the boundary Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 are centro-symetric (e.g. []Box[], Circle, []Ellipse[], etc.) o r be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (15.5936pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 will have no effect on the created Circle. Alternatively, a NUL L []Object[] pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ci rcle. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format [219] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12738--12738 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 12738--12738 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 12738--12738 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [220] Overfull \hbox (21.36719pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 Pointer to an array in which to return the coordinates of the C ircle centre. The Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 length of this array should be no less than the number of axes in the associated Overfull \hbox (37.11334pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 Returned holding the radius of the Circle, as an geodesic dista nce in the associated Overfull \hbox (47.61078pt too wide) in paragraph at lines 12796--12796 [] \T1/cmtt/m/n/10 Pointer to an array in which to return the coordinates of a point on the circumference Overfull \hbox (0.37231pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 of the Circle. The length of this array should be no less than the number of Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 axes in the associated coordinate system. A NULL pointer can be supplied if the Overfull \hbox (16.11847pt too wide) in paragraph at lines 12796--12796 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Circle has been changed since it was Overfull \hbox (34.48898pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 first created, the returned parameters refer to the new (change d) coordinate system, Overfull \hbox (37.11334pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 rather than the original coordinate system. Note however that i f the transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 12796--12796 \T1/cmtt/m/n/10 from original to new coordinate system is non-linear, the shape represented by [221] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12849--12849 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (49.1854pt too wide) in paragraph at lines 12849--12849 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to clear the val ue of a read-only attribute. [222] Overfull \hbox (42.36206pt too wide) in paragraph at lines 12872--12872 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (0.10988pt too wide) in paragraph at lines 12872--12872 \T1/cmtt/m/n/10 will not execute and will simply return without action. Using a stClearStatus [223] Overfull \hbox (6.6736pt too wide) in paragraph at lines 12984--12984 []\T1/cmtt/m/n/10 void astClip( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, int iframe, const double lbnd[], const double ubnd[] ) Overfull \hbox (10.60732pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 The index of the []Frame[] within the Plot to which the clippin g limits supplied in Overfull \hbox (37.11334pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 " lbnd" and " ubnd" (below) refer. Clipping may be applied to a ny of the coordinate Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 systems associated with a Plot (as defined by the Frames it con tains), so this Overfull \hbox (49.1854pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index may take any value from 1 to the number of Frames in the Plot ([]Nframe[] attribute). Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 In addition, the values AST__BASE and AST__CURRENT may be used to specify the Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 []\T1/cmtt/m/n/10 For example, a value of AST__CURRENT causes clipping to be pe rformed in physical Overfull \hbox (47.61078pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 coordinates, while a value of AST__BASE would clip in graphical coordinates. Clipping Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 may also be removed completely by giving a value of AST__NOFRAM E. In this case Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 An array with one element for each axis of the clipping Frame ( identified by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index " iframe" ). This should contain the lower bound, on each axis, of the Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 An array with one element for each axis of the clipping Frame ( identified by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 index " iframe" ). This should contain the upper bound, on each axis, of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 Only one clipping Frame may be active at a time. This funct ion will deactivate Overfull \hbox (12.44437pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 any previously-established clipping Frame before setting up new clipping limits. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 The clipping produced by this function is in addition to th at specified by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 Clip attribute which occurs at the edges of the plotting area e stablished when Overfull \hbox (26.6159pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the Plot is created (see []astPlot[]). The underlying graphics system may also impose Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 When testing a graphical position for clipping, it is first transformed into the Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 clipping Frame. The resulting coordinate on each axis is then c hecked against Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the clipping limits (given by " lbnd" and " ubnd" ). By default , a position is Overfull \hbox (26.6159pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 clipped if any coordinate lies outside these limits. However, i f a non-zero value Overfull \hbox (10.86975pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 is assigned to the Plot' s []ClipOp[] attribute, then a positio n is only clipped if Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 If the lower clipping limit exceeds the upper limit for any axis, then the sense Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 of clipping for that axis is reversed (so that coordinate value s lying between Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 the limits are clipped instead of those lying outside the limit s). To produce Overfull \hbox (0.37231pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 a " hole" in a coordinate space (that is, an internal region wh ere nothing is Overfull \hbox (16.11847pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 plotted), you should supply all the bounds in reversed order, a nd set the ClipOp [224] Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 Either clipping limit may be set to the value AST__BAD, whi ch is equivalent to Overfull \hbox (5.62103pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 setting it to infinity (or minus infinity for a lower bound) so that it is not Overfull \hbox (58.10822pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 If a graphical position results in any bad coordinate value s (AST__BAD) when transformed Overfull \hbox (37.11334pt too wide) in paragraph at lines 12984--12984 \T1/cmtt/m/n/10 into the clipping Frame, then it is treated (for the purposes o f producing graphical Overfull \hbox (15.85603pt too wide) in paragraph at lines 12984--12984 [][]\T1/cmtt/m/n/10 When a Plot is used as a []Mapping[] to transform points (e .g. using []astTran2[]), any [225] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13032--13032 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [226] Overfull \hbox (0.48381pt too wide) in paragraph at lines 13120--13120 []\T1/cmtt/m/n/10 AstCmpFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpFrame ( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame1, AstFrame $\OMS/zplm/m/ n/10 ^^C$\T1/cmtt/m/n/10 frame2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 options, Overfull \hbox (10.86975pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13120--13120 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 13120--13120 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 13120--13120 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 13120--13120 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [227] Overfull \hbox (42.47356pt too wide) in paragraph at lines 13239--13239 []\T1/cmtt/m/n/10 AstCmpMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpMap( As tMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map1, AstMapping $\OMS/zplm/m/n/ 10 ^^C$\T1/cmtt/m/n/10 map2, int series, const char $\OMS/zplm/m/n/10 ^^C$\T1/c mtt/m/n/10 options, Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 If a non-zero value is given for this parameter, the two compon ent Mappings will Overfull \hbox (28.19052pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 be connected in series. A zero value requests that they are con nected in parallel. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 If the component Mappings are connected in series, then usi ng the resulting CmpMap Overfull \hbox (0.37231pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 to transform coordinates will cause the first Mapping to be app lied, followed Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 by the second Mapping. If the inverse CmpMap transformation is requested, the Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 two component Mappings will be applied in both the reverse orde r and the reverse Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 When connecting two component Mappings in series, the numbe r of output coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 generated by the first Mapping (its []Nout[] attribute) must eq ual the number of input Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 If the component Mappings of a CmpMap are connected in para llel, then the first Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 Mapping will be used to transform the earlier input coordinates for each point Overfull \hbox (5.09616pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 (and to produce the earlier output coordinates) and the second Mapping will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 used simultaneously to transform the remaining input coordinate s (to produce the Overfull \hbox (10.86975pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 remaining output coordinates for each point). If the inverse tr ansformation is Overfull \hbox (0.37231pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 requested, each Mapping will still be applied to the same coord inates, but in [228] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 When connecting two component Mappings in parallel, there i s no restriction on Overfull \hbox (5.3586pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astCmpMap (the new Overfull \hbox (0.10988pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 CmpMap simply retains a reference to them). They may continue t o be used for Overfull \hbox (16.11847pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a CmpMap containi ng a copy of its Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 \T1/cmtt/m/n/10 component Mappings is required, then a copy of the CmpMap shoul d be made using Overfull \hbox (5.62103pt too wide) in paragraph at lines 13239--13239 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [229] Overfull \hbox (8.1457pt too wide) in paragraph at lines 13353--13353 []\T1/cmtt/m/n/10 AstCmpRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astCmpRegi on( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region1, AstRegion $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 region2, int oper, const Overfull \hbox (0.37231pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 Pointer to the second component Region. This Region will be tra nsformed into Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 the coordinate Frame of the first region before use. An error w ill be reported Overfull \hbox (0.10988pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 The boolean operator with which to combine the two Regions. Thi s must be one Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Cm pRegion. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 13353--13353 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [230] Overfull \hbox (5.3586pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 If one of the supplied Regions has an associated uncertaint y, that uncertainty Overfull \hbox (52.59706pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 will also be used for the returned CmpRegion. If both supplied Regions have associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 uncertainties, the uncertainty associated with the first Region will be used for Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no Overfull \hbox (5.62103pt too wide) in paragraph at lines 13353--13353 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [231] Overfull \hbox (21.10475pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 The index into the list of columns. The first column has index one, and the last Overfull \hbox (0.37231pt too wide) in paragraph at lines 13414--13414 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 13414--13414 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 13414--13414 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [232] Overfull \hbox (8.19696pt too wide) in paragraph at lines 13532--13532 []\T1/cmtt/m/n/10 int astColumnNull( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int set , int newval, int Overfull \hbox (22.67937pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 [] \T1/cmtt/m/n/10 If non-zero, the value supplied for parameter " newval" w ill be stored as the Overfull \hbox (12.44437pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 current null value, replacing any value set by a previous call to this function. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 If zero, the value supplied for parameter " newval" is ignored and the current Overfull \hbox (21.10475pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The new null value to use. Ignored if " set" is zero. An error will be reported Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 if the supplied value is outside the range of values that can b e stored in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 Pointer to an int that will be returned non-zero if the returne d null value was Overfull \hbox (49.1854pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 set previously via an earlier invocation of this function. Zero is returned otherwise. Overfull \hbox (33.43924pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 If the named column does not exist, or an error occurs, a value of zero is returned. Overfull \hbox (16.11847pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 Pointer to an int that will be returned non-zero if and only if the named column Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 currently contains any values equal to the null value on exit ( i.e. " newval" Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 if " set" is non-zero, or the returned function value otherwise ), or contains Overfull \hbox (21.36719pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 any empty cells. If the named column does not exist, or an erro r occurs, a value Overfull \hbox (0.10988pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 of zero is returned. If a NULL pointer is supplied for " hasnul l" , no check Overfull \hbox (7.51216pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 The null value that was in use on entry to this function. If a null value has been Overfull \hbox (2.52588pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 set by a previous invocation of this function, it will be retur ned. Otherwise, if Overfull \hbox (7.7746pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 " set" is non-zero, the supplied " newval" value is returned. O therwise, a default Overfull \hbox (12.76088pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 value is chosen (if possible) that does not currently occur in the named column. If Overfull \hbox (2.52588pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 all available values are in use in the column, an error is repo rted if and only if Overfull \hbox (23.52075pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 the column contains any empty cells. Otherwise, a value of zero is returned. A value [233] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13532--13532 [][]\T1/cmtt/m/n/10 The FITS binary table definition allows only integer-valued columns to have an Overfull \hbox (0.37231pt too wide) in paragraph at lines 13532--13532 \T1/cmtt/m/n/10 associated null value. This routine will return without action if the column [234] Overfull \hbox (2.89699pt too wide) in paragraph at lines 13597--13597 []\T1/cmtt/m/n/10 void astColumnShape( AstTable $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int mxdim , int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ndim, int Overfull \hbox (15.85603pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces Overfull \hbox (10.86975pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 Pointer to an int in which to return the number of dimensions s panned by values Overfull \hbox (16.11847pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 Pointer to an array in which to return the length of each dimen sion. Any excess Overfull \hbox (12.44437pt too wide) in paragraph at lines 13597--13597 [][]\T1/cmtt/m/n/10 No error is reported if the requested column cannot be foun d in the given Table. Overfull \hbox (5.3586pt too wide) in paragraph at lines 13597--13597 \T1/cmtt/m/n/10 A value of zero is returned for " ndim" and the supplied values in " dims" are [235] Overfull \hbox (22.67937pt too wide) in paragraph at lines 13643--13643 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Underfull \hbox (badness 10000) in paragraph at lines 13643--13643 Overfull \hbox (1.94693pt too wide) in paragraph at lines 13643--13643 [][]\T1/cmtt/m/n/10 An error will be reported if the named column does not exis t in the []FitsTable[]. [236] Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Pointer to a Frame which represents the " source" coordinate sy stem. This is Overfull \hbox (25.56616pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is given, its current Frame (as determined by i ts []Current[] attribute) Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is taken to describe the source coordinate system. Note that th e []Base[] attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of this FrameSet may be modified by this function to indicate w hich intermediate Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system was used (see under " FrameSets" in the " App licability" section Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Pointer to a Frame which represents the " destination" co ordinate system. This Overfull \hbox (25.56616pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is given, its current Frame (as determined by i ts Current attribute) Overfull \hbox (42.36206pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is taken to describe the destination coordinate system. Note th at the Base attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of this FrameSet may be modified by this function to indicate w hich intermediate Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system was used (see under " FrameSets" in the " App licability" section Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 of Frame domains. This may be used to define a priority order f or the different Overfull \hbox (57.84578pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The function will first try to obtain a conversion by making use only of an intermediate Overfull \hbox (7.19565pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system whose Domain attribute matches the first doma in in this list. Overfull \hbox (47.61078pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If this fails, the second domain in the list will be used, and so on, until conversion Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is achieved. A blank domain (e.g. two consecutive commas) indic ates that all Overfull \hbox (21.10475pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 This list is case-insensitive and all white space is ignored. If you do not wish Overfull \hbox (10.86975pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to restrict the domain in this way, you should supply an empty string. This is Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 normally appropriate if either of the source or destination coo rdinate systems Overfull \hbox (21.10475pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are described by Frames (rather than FrameSets), since there is then usually only [237] Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If the []AlignSideBand[] attribute is non-zero, alignment occur s in the upper sideband Overfull \hbox (39.2669pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 expressed within the spectral system and standard of rest given by attributes []AlignSystem[] Overfull \hbox (7.7746pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 and []AlignStdOfRest[]. If AlignSideBand is zero, the two DSBSp ecFrames are aligned as Overfull \hbox (7.51216pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 This function applies to all Frames. Alignment occurs within th e coordinate system Overfull \hbox (34.01819pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If either of the " from" or " to" parameters is a pointer to a FrameSet, then astConvert Overfull \hbox (12.76088pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 will attempt to convert from the coordinate system described by the current Frame of Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 To achieve this, it will consider all of the Frames within ea ch FrameSet as a possible Overfull \hbox (19.58421pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 way of reaching an intermediate coordinate system that can be u sed for the conversion. Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 There is then the possibility that more than one conversion pat h may exist and, unless Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the choice is sufficiently restricted by the " domainlist" stri ng, the sequence in Overfull \hbox (54.75063pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 which the Frames are considered can be important. In this case, the search for a conversion Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 The Frames within each FrameSet are considered in a specifi c order: (1) the base Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame is always considered first, (2) after this come all the o ther Frames in Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame-index order (but omitting the base and current Frames), ( 3) the current Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame is always considered last. However, if either FrameSet' s []Invert[] attribute Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is set to a non-zero value (so that the FrameSet is inverted), then its Frames Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are considered in reverse order. (Note that this still means th at the base Frame Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 is considered first and the current Frame last, because the Inv ert value will Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 All source Frames are first considered (in the appropriate order) for conversion Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to the first destination Frame. If no suitable intermediate coo rdinate system Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 emerges, they are then considered again for conversion to the s econd destination Overfull \hbox (39.7377pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 Generally, the first suitable intermediate coordinate syste m found is used. However, Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the overall Mapping between the source and destination coordina te systems is also Overfull \hbox (68.60565pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 examined. Preference is given to cases where both the forward a nd inverse transformations Overfull \hbox (0.37231pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 are defined (as indicated by the []TranForward[] and []TranInve rse[] attributes). If Overfull \hbox (42.36206pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 If the domain of the intermediate coordinate system matches the current " domainlist" Overfull \hbox (16.11847pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 field, the conversion path is accepted. Otherwise, the next " d omainlist" field Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If conversion is possible, the Base attributes of the two Frame Sets will be modified Overfull \hbox (23.52075pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 on exit to identify the Frames used to access the intermediate coordinate system which Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that it is possible to force a particular Frame within a FrameSet to be used as Overfull \hbox (18.27203pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the basis for the intermediate coordinate system, if it is suit able, by (a) focussing Overfull \hbox (7.7746pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 attention on it by specifying its domain in the " domainlist" s tring, or (b) making [238] Overfull \hbox (12.76088pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Alignment occurs within the spectral system and standard of res t given by attributes Overfull \hbox (23.25832pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Alignment occurs within the time system and time scale given by attributes AlignSystem Overfull \hbox (2.26344pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If the requested coordinate conversion is possible, the functio n returns a pointer Overfull \hbox (48.7146pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to a FrameSet which describes the conversion. Otherwise, a null []Object[] pointer (AST__NULL) Overfull \hbox (27.71973pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If a FrameSet is returned, it will contain two Frames. Frame number 1 (its base Frame) Overfull \hbox (3.83806pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 will describe the source coordinate system, corresponding to th e " from" parameter. Overfull \hbox (5.15024pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frame number 2 (its current Frame) will describe the destinatio n coordinate system, Overfull \hbox (28.76947pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 corresponding to the " to" parameter. The Mapping which inter-r elates these two Frames Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that a FrameSet may be used both as a Mapping and as a F rame. If the result is Overfull \hbox (49.76434pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 used as a Mapping (e.g. with []astTran2[]), then it provides a means of converting coordinates Overfull \hbox (2.52588pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 from the source to the destination coordinate system (or vice v ersa if its inverse Overfull \hbox (13.02332pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 transformation is selected). If it is used as a Frame, its attr ibutes will describe Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Attempts to convert between the coordinate systems represent ed by " a" and " Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 b" (assumed to be Frames). If successful, a FrameSet is returne d via the " cvt" Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 pointer which may be used to apply the conversion to sets of co ordinates (e.g. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Creates a FrameSet which describes precession in the default FK5 celestial Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate system between equinoxes J2000 (also the default) an d J2005. The Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 returned " cvt" pointer may then be passed to astTran2 to apply this precession Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 Note that the returned FrameSet also contains information abo ut how to format Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 coordinate values. This means that setting its []Report[] attri bute to 1 is a simple Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 way to obtain printed output (formatted in sexagesimal notation ) to show the Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 [] \T1/cmtt/m/n/10 Attempts to convert between the coordinate systems represent ed by the current Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 Frames of " a" and " b" (now assumed to be FrameSets), via the intermediate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 " SKY" coordinate system. This, by default, is the Domain assoc iated with a Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 If this fails (for example, because either FrameSet lacks cel estial coordinate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 information), then the user-defined " DETECTOR" coordinate syst em is used instead. Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 If this also fails, then all other possible ways of achieving c onversion are Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The returned pointer " cvt" indicates whether conversion was possible and will Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 have the value AST__NULL if it was not. If conversion was possi ble, " cvt" will [239] Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 []\T1/cmtt/m/n/10 The Base attributes of the two FrameSets will be set by astCo nvert to indicate Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 which of their Frames was used for the intermediate coordinate system. This Underfull \hbox (badness 10000) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 means that you can subsequently determine which coordinate syst em was used by Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 The Mapping represented by the returned FrameSet results in alignment taking place Overfull \hbox (28.19052pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 in the coordinate system specified by the AlignSystem attribute of the " to" Frame. Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 When aligning (say) two images, which have been calibrated by attaching FrameSets Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 to them, it is usually necessary to convert between the base Fr ames (representing Overfull \hbox (26.6159pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 " native" pixel coordinates) of both FrameSets. This may be ach ieved by inverting Overfull \hbox (21.36719pt too wide) in paragraph at lines 13940--13940 \T1/cmtt/m/n/10 the FrameSets (e.g. using []astInvert[]) so as to interchange t heir base and current Overfull \hbox (5.62103pt too wide) in paragraph at lines 13940--13940 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [240] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14127. Overfull \hbox (5.33546pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astConvex$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( $\OML /zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 valu e, int oper, const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 array[], const Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the requ ired pixels. It Overfull \hbox (37.11334pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to a 2-dimensional array containing the data to be proc essed. The numerical Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 type of this array should match the 1- or 2-character type code appended to the Overfull \hbox (16.11847pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 function name (e.g. if you are using astConvexF, the type of ea ch array element Overfull \hbox (15.85603pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the second dimension least Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the coordinates of the centre of Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the coordinates of the centre of Overfull \hbox (0.37231pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (37.11334pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 coordinate values at its centre or upper corner, as selected by parameter " starpix" [241] Overfull \hbox (15.85603pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 A flag indicating the nature of the pixel coordinate system use d to describe the Overfull \hbox (57.84578pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 vertex positions in the returned Polygon. If non-zero, the stan dard Starlink definition Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 of pixel coordinate is used in which a pixel with integer index I spans a range Overfull \hbox (64.93155pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 of pixel coordinate from (I-1) to I (i.e. pixel corners have in tegral pixel coordinates). Overfull \hbox (10.86975pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 If zero, the definition of pixel coordinate used by other AST f unctions such as Overfull \hbox (5.3586pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 astResample, astMask, etc., is used. In this definition, a pixe l with integer Overfull \hbox (8.7222pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 index I spans a range of pixel coordinate from (I-0.5) to (I$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 0.5) (i.e. pixel Overfull \hbox (33.75575pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 A pointer to the required Polygon. NULL is returned without err or if the array contains Overfull \hbox (5.62103pt too wide) in paragraph at lines 14127--14127 [][]\T1/cmtt/m/n/10 NULL will be returned if this function is invoked with the global error status Overfull \hbox (3.21706pt too wide) in paragraph at lines 14127--14127 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (8.72821pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 function name astConvex$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (28.76947pt too wide) in paragraph at lines 14127--14127 \T1/cmtt/m/n/10 For example, astConvexD would be used to process " double" data , while astConvexS would [242] Overfull \hbox (5.62103pt too wide) in paragraph at lines 14175--14175 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [243] Overfull \hbox (24.5254pt too wide) in paragraph at lines 14243--14243 []\T1/cmtt/m/n/10 void astCreatedAt( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, const char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 routine, cons t char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 file, int $\OMS/zplm/m/n/10 ^ ^C$\T1/cmtt/m/n/10 line Overfull \hbox (21.10475pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of a pointer to a null terminated C string in which to return the routine Overfull \hbox (15.85603pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 name (the string will reside in static memory). The pointer wil l be set to NULL Overfull \hbox (5.3586pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of a pointer to a null terminated C string in which to return the file Overfull \hbox (15.85603pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 name (the string will reside in static memory). The pointer wil l be set to NULL Overfull \hbox (10.34488pt too wide) in paragraph at lines 14243--14243 \T1/cmtt/m/n/10 Address of an int in which to store the line number in the file . A line number Overfull \hbox (42.36206pt too wide) in paragraph at lines 14243--14243 [][]\T1/cmtt/m/n/10 NULL pointers and a line number of zero are returned if an error has already occurred [244] Overfull \hbox (26.35347pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 It is assumes that the system time (returned by the C time( ) function) follows Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 the POSIX standard, representing a continuous monotonic increas ing count of SI Overfull \hbox (5.62103pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 seconds since the epoch 00:00:00 UTC 1 January 1970 AD (equival ent to TAI with Overfull \hbox (0.37231pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 An error will be reported if the TimeFrame has a TimeScale value which cannot Overfull \hbox (12.44437pt too wide) in paragraph at lines 14299--14299 \T1/cmtt/m/n/10 be converted to TAI (e.g. " angular" systems such as UT1, GMST, LMST and LAST). Overfull \hbox (0.10988pt too wide) in paragraph at lines 14299--14299 [][]\T1/cmtt/m/n/10 Any inaccuracy in the system clock will be reflected in the value returned by [245] Overfull \hbox (42.09962pt too wide) in paragraph at lines 14372--14372 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (42.09962pt too wide) in paragraph at lines 14372--14372 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (58.10822pt too wide) in paragraph at lines 14372--14372 [][]\T1/cmtt/m/n/10 No curve is drawn if either of the " start" or " finish" ar rays contains any coordinates Overfull \hbox (10.86975pt too wide) in paragraph at lines 14372--14372 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [246] Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new DS BSpecFrame. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 syntax used is identical to that for the []astSet[] function an d may include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 14446--14446 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 14446--14446 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 14446--14446 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [247] Overfull \hbox (27.14977pt too wide) in paragraph at lines 14572--14572 []\T1/cmtt/m/n/10 void astDecompose( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map1, AstMap ping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map2, int $\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 series, Overfull \hbox (0.10988pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 Address of a location to receive a value indicating if the comp onent Mappings Overfull \hbox (37.11334pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 are applied in series or parallel. A non-zero value means that the supplied Mapping Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 is equivalent to applying map1 followed by map2 in series. A ze ro value means Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 that the supplied Mapping is equivalent to applying map1 to the lower numbered Overfull \hbox (39.2669pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpMap, then map1 and map2 will be returned holding pointers Overfull \hbox (36.64255pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 to the component Mappings used to create the CmpMap, either in series or parallel. Note, Overfull \hbox (13.02332pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 changing the Invert attribute of either of the component Mappin gs using the returned Overfull \hbox (44.51563pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 pointers will have no effect on the supplied CmpMap. This is be cause the CmpMap remembers Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 and uses the original settings of the Invert attributes (that i s, the values of the Overfull \hbox (2.52588pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 Invert attributes when the CmpMap was first created). These are the Invert values Overfull \hbox (44.51563pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a TranMap, then map1 and map2 will b e returned holding pointers Overfull \hbox (18.27203pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 to the forward and inverse Mappings represented by the TranMap (zero will be returned Overfull \hbox (18.27203pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 for series). Note, changing the Invert attribute of either of t he component Mappings Overfull \hbox (39.2669pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 using the returned pointers will have no effect on the supplied TranMap. This is because Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 the TranMap remembers and uses the original settings of the Inv ert attributes (that Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 is, the values of the Invert attributes when the TranMap was fi rst created). These Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 For any class of Mapping other than a CmpMap, map1 will be retu rned holding a clone Overfull \hbox (49.5019pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 of the supplied Mapping pointer, and map2 will be returned hold ing a NULL pointer. Invert1 Overfull \hbox (7.51216pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 will be returned holding the current value of the Invert attrib ute for the supplied [248] Overfull \hbox (2.52588pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpFrame, then map1 and map2 will be returned holding Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 pointers to the component Frames used to create the CmpFrame. T he component Frames Overfull \hbox (7.7746pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 For any class of Frame other than a CmpFrame, map1 will be retu rned holding a clone Overfull \hbox (0.37231pt too wide) in paragraph at lines 14572--14572 [][]\T1/cmtt/m/n/10 The returned Invert values should be used in preference to the current values Overfull \hbox (0.10988pt too wide) in paragraph at lines 14572--14572 \T1/cmtt/m/n/10 of the Invert attribute in map1 and map2. This is because the a ttributes may Overfull \hbox (5.62103pt too wide) in paragraph at lines 14572--14572 [][]\T1/cmtt/m/n/10 Any changes made to the component Mappings using the return ed pointers will be [249] Overfull \hbox (10.86975pt too wide) in paragraph at lines 14611--14611 [][]\T1/cmtt/m/n/10 This function returns without action if the FitsChan is ini tially positioned at Overfull \hbox (5.62103pt too wide) in paragraph at lines 14611--14611 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the Card attribute exceeds the numb er of cards in Overfull \hbox (21.36719pt too wide) in paragraph at lines 14611--14611 [][]\T1/cmtt/m/n/10 If there are no subsequent cards in the FitsChan, then the Card attribute is left Overfull \hbox (16.11847pt too wide) in paragraph at lines 14611--14611 \T1/cmtt/m/n/10 pointing at the " end-of-file" after deletion (i.e. is set to o ne more than the [250] Overfull \hbox (8.24539pt too wide) in paragraph at lines 14662--14662 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 14662--14662 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these [251] Overfull \hbox (1.68732pt too wide) in paragraph at lines 14722--14722 []\T1/cmtt/m/n/10 double astDistance( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, const double point1[], const double point2[] ) Overfull \hbox (42.09962pt too wide) in paragraph at lines 14722--14722 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute) containing Overfull \hbox (31.60219pt too wide) in paragraph at lines 14722--14722 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis contai ning the coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 14722--14722 [][]\T1/cmtt/m/n/10 This function will return a " bad" result value (AST__BAD) if any of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 14722--14722 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [252] Overfull \hbox (42.09962pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 The maximum allowed discrepancy between the supplied and return ed Polygons, expressed Overfull \hbox (10.86975pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 as a geodesic distance within the Polygon' s coordinate frame. If this is zero Overfull \hbox (33.43924pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 or less, the returned Polygon will have the number of vertices specified by maxvert. Overfull \hbox (15.85603pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 The maximum allowed number of vertices in the returned Polygon. If this is less Overfull \hbox (21.36719pt too wide) in paragraph at lines 14781--14781 \T1/cmtt/m/n/10 than 3, the number of vertices in the returned Polygon will be the minimum needed Overfull \hbox (5.62103pt too wide) in paragraph at lines 14781--14781 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [253] Overfull \hbox (10.86975pt too wide) in paragraph at lines 14813--14813 [][]\T1/cmtt/m/n/10 The nature of the buffering is determined by the underlying graphics system (as Overfull \hbox (5.62103pt too wide) in paragraph at lines 14813--14813 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function simply invokes [254] Overfull \hbox (28.9294pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 AstEllipse $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astEllipse( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int form, const double ce ntre[2], const double Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. It must have exactly 2 Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 axes. A deep copy is taken of the supplied Frame. This means th at any subsequent Overfull \hbox (33.43924pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 changes made to the Frame using the supplied pointer will have no effect the Region. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Indicates how the ellipse is described by the remaining paramet ers. A value of Overfull \hbox (31.86462pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 zero indicates that the ellipse is specified by a centre positi on and two positions Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the circumference. A value of one indicates that the ellipse is specified Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 by its centre position, the half-lengths of its two axes, and t he orientation Overfull \hbox (6.93321pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles, containing the coordinates at the centre of the ellipse. Overfull \hbox (42.09962pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles. If " form" is zero, this array should co ntain the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of one of the four points where an axis of the ellipse crosses the circumference Overfull \hbox (10.60732pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of the ellipse. If " form" is one, it should contain the length s of semi-major Overfull \hbox (17.69308pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 and semi-minor axes of the ellipse, given as geodesic distances within the Frame. Overfull \hbox (57.84578pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An array of 2 doubles. If " form" is zero, this array should co ntaining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 at some other point on the circumference of the ellipse, distin ct from " point1" Overfull \hbox (31.86462pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 . If " form" is one, the first element of this array should hol d the angle between Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 the second axis of the Frame and the first ellipse axis (i.e. t he ellipse axis Overfull \hbox (0.10988pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 which is specified first in the " point1" array), and the secon d element will Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 be ignored. The angle should be given in radians, measured posi tive in the same Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 sense as rotation from the positive direction of the second Fra me axis to the Overfull \hbox (47.34834pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 with the boundary of the Ellipse being created. The uncertainty in any point Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the boundary of the Ellipse is found by shifting the supplie d " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 are centro-symetric (e.g. []Box[], []Circle[], Ellipse, etc.) o r be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 will have no effect on the created Ellipse. Alternatively, a NU LL []Object[] pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [255] Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new El lipse. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 14953--14953 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 14953--14953 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 14953--14953 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [256] Overfull \hbox (18.64314pt too wide) in paragraph at lines 15033--15033 []\T1/cmtt/m/n/10 void astEllipsePars( AstEllipse $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, double centre[2], double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a , double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 b, double Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 If the coordinate system in which the Ellipse is defined has ax es (X,Y), then Overfull \hbox (21.57837pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 angle" is returned hold ing the angle from the positive direction of the Y axis Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 to the first axis of the ellipse, in radians. Positive rotation is in the same Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 sense as rotation from the positive direction of Y to the posit ive direction of Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 [] \T1/cmtt/m/n/10 An array in which to return the coordinates at one of the two ends of the first Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (16.11847pt too wide) in paragraph at lines 15033--15033 [] \T1/cmtt/m/n/10 An array in which to return the coordinates at one of the two ends of the second Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Ellipse has bee n changed since it Overfull \hbox (15.85603pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 was first created, the returned parameters refer to the new (ch anged) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 15033--15033 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (10.86975pt too wide) in paragraph at lines 15033--15033 [][]\T1/cmtt/m/n/10 Values of AST__BAD are returned for the parameters without error if the ellipse [257] Overfull \hbox (39.7377pt too wide) in paragraph at lines 15069--15069 [][]\T1/cmtt/m/n/10 This method simply deletes the cards currently in the FitsC han. Unlike []astWriteFits[], [258] [259] Overfull \hbox (27.92809pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 A flag which indicates if escapes sequences should be included in returned strings. Overfull \hbox (26.6159pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 If zero is supplied, escape sequences will be stripped out of a ll strings returned Overfull \hbox (16.11847pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 by any AST function. If a positive value is supplied, then any escape sequences Overfull \hbox (0.10988pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 will be retained in the value returned to the caller. If a nega tive value is Overfull \hbox (10.86975pt too wide) in paragraph at lines 15171--15171 [][]\T1/cmtt/m/n/10 This function also controls whether the []astStripEscapes[] function removes escape Overfull \hbox (22.9418pt too wide) in paragraph at lines 15171--15171 \T1/cmtt/m/n/10 sequences from the supplied string, or returns the supplied str ing without change. [260] [261] Overfull \hbox (0.37231pt too wide) in paragraph at lines 15247--15247 [][]\T1/cmtt/m/n/10 It is only sensible to apply this function to pointers that have been created Overfull \hbox (0.10988pt too wide) in paragraph at lines 15247--15247 \T1/cmtt/m/n/10 within (or exported to) the current context and have not been r endered exempt [262] Overfull \hbox (31.86462pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a temp late for the keyword Overfull \hbox (10.86975pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 to be found. In the simplest case, this should simply be the ke yword name (the Overfull \hbox (37.11334pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 search is case insensitive and trailing spaces are ignored). Ho wever, this template Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 may also contain " field specifiers" which are capable of match ing a range of Overfull \hbox (21.36719pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 characters (see the " Keyword Templates" section for details). In this case, the Overfull \hbox (16.11847pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 first card with a keyword which matches the template will be fo und. To find the Overfull \hbox (26.35347pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 An array of at least 81 characters (to allow room for a termina ting null) in which Overfull \hbox (10.86975pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the FITS card which is found will be returned. If the search is not successful Overfull \hbox (37.11334pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 If this value is zero (and the search is successful), the FitsC han' s Card attribute Overfull \hbox (18.4804pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 will be set to the index of the card that was found. If it is n on-zero, however, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the Card attribute will be incremented to identify the card whi ch follows the Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Returns the current card in a FitsChan and advances the Card attribute to Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Searches a FitsChan for a FITS card with the " BITPIX" keywo rd and returns that Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 card. The Card attribute is then incremented to identify the ca rd that follows Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Sets the Card attribute of a FitsChan to identify the next C OMMENT card (if [263] Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 [] \T1/cmtt/m/n/10 Searches a FitsChan for the next card with a keyword of the form " CRVALi" (for Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 example, any of the keywords " CRVAL1" , " CRVAL2" or " CRVAL3" would be matched). Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 The card found (if any) is returned, and the Card attribute is then incremented Underfull \hbox (badness 10000) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 to identify the following card (ready to search for another key word with the same Overfull \hbox (33.43924pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The search always starts with the current card, as identifi ed by the Card attribute. Overfull \hbox (5.09616pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 To ensure you search the entire contents of a FitsChan, you sho uld first clear Overfull \hbox (7.19565pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the Card attribute (using []astClear[]). This effectively " rew inds" the FitsChan. Overfull \hbox (22.9418pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 If a search is unsuccessful, the Card attribute is set to t he " end-of-file" (i.e. Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (20.63396pt too wide) in paragraph at lines 15439--15439 []\T1/cmtt/m/n/10 The templates used to match FITS keywords are normally compos ed of literal characters, Overfull \hbox (18.0096pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 which must match the keyword exactly (apart from case). However , a template may also Overfull \hbox (34.01819pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 contain " field specifiers" which can match a range of possible characters. This allows Overfull \hbox (44.51563pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 you to search for keywords that contain (for example) numbers, where the digits comprising Overfull \hbox (28.50703pt too wide) in paragraph at lines 15439--15439 []\T1/cmtt/m/n/10 A field specifier starts with a " %" character. This is follo wed by an optional single Overfull \hbox (13.02332pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 digit (0 to 9) specifying a field width. Finally, there is a si ngle character which Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 " f" : matches all characters which are permitted within a FITS keyword (upper Overfull \hbox (23.52075pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 If the field width is omitted, the field specifier matches one or more characters. If Overfull \hbox (7.7746pt too wide) in paragraph at lines 15439--15439 \T1/cmtt/m/n/10 the field width is zero, it matches zero or more characters. Ot herwise, it matches Overfull \hbox (0.37231pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " %f" will match a blank FITS keyword consisti ng of 8 spaces (as Overfull \hbox (10.60732pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " crpix%1d" will match keywords consisting of " CRPIX" followed by [264] Overfull \hbox (0.10988pt too wide) in paragraph at lines 15439--15439 [][]\T1/cmtt/m/n/10 The template " P%c" will match any keyword starting with " P" and followed by [265] Overfull \hbox (29.35176pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFindFram e( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 target, AstFrame $\OMS/zplm/m /n/10 ^^C$\T1/cmtt/m/n/10 template, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 domainlist Overfull \hbox (13.49411pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Note that if a FrameSet is supplied (and a suitable coordinat e system is found), Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 then its Current attribute will be modified to indicate which F rame was used to Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 obtain attribute values which were not specified by the templat e. This Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 will, in some sense, represent the " closest" non-virtual coord inate system to [266] Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Pointer to the template Frame, which should be an instance of t he type of Frame Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 you wish to find. If you wanted to find a Frame describing a ce lestial coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 system, for example, then you might use a []SkyFrame[] here. Se e the " Examples" Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (31.86462pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 of Frame domains. This may be used to establish a priority orde r for the different Overfull \hbox (0.10988pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 The function will first try to find a suitable coordinate sys tem whose []Domain[] Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 attribute equals the first domain in this list. If this fails, the second domain Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the list will be used, and so on, until a result is obtained . A blank domain Overfull \hbox (20.84232pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 (e.g. two consecutive commas) indicates that any coordinate sys tem is acceptable Overfull \hbox (21.10475pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 This list is case-insensitive and all white space is ignored. If you do not wish Overfull \hbox (18.27203pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If the target is a FrameSet, the possibility exists that severa l of the Frames within Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it might be matched by the template. Unless the choice is suffi ciently restricted Overfull \hbox (23.52075pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 by the " domainlist" string, the sequence in which Frames are s earched can then become Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 An attempt is made to match the template to each of the tar get' s Frames in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 order: (1) the current Frame, (2) the base Frame, (3) each rema ining Frame in Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Generally, the first match found is used. However, the Mapp ing between the target Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system and the resulting Frame is also examined. Pre ference is given Overfull \hbox (42.36206pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to cases where both the forward and inverse transformations are defined (as indicated Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 by the []TranForward[] and []TranInverse[] attributes). If only one transformation is Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If a match is found and the domain of the resulting Frame a lso matches the current Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " domainlist" field, it is accepted. Otherwise, the next " doma inlist" field Overfull \hbox (23.52075pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If a suitable coordinate system is found, the Current attribute of the target FrameSet Overfull \hbox (38.74203pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 will be modified on exit to identify the Frame whose match with the target was eventually Overfull \hbox (34.01819pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 If the search is successful, the function returns a pointer to a FrameSet which contains Overfull \hbox (28.76947pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the Frame found and a description of how to convert to (and fro m) the coordinate system Overfull \hbox (25.09537pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it represents. Otherwise, a null []Object[] pointer (AST__NULL) is returned without error. [267] Overfull \hbox (27.71973pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If a FrameSet is returned, it will contain two Frames. Frame number 1 (its base Frame) Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 represents the target coordinate system and will be the same as the (base Frame of Overfull \hbox (55.01306pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the) target. Frame number 2 (its current Frame) will be a Frame representing the coordinate Overfull \hbox (2.52588pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 system which the function found. The Mapping which inter-relate s these two Frames Overfull \hbox (13.02332pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Note that a FrameSet may be used both as a Mapping and as a F rame. If the result is Overfull \hbox (49.76434pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 used as a Mapping (e.g. with []astTran2[]), then it provides a means of converting coordinates Overfull \hbox (13.02332pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 from the target coordinate system into the new coordinate syste m that was found (and Overfull \hbox (18.0096pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 vice versa if its inverse transformation is selected). If it is used as a Frame, its Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a 3-dimensional coordinate system in the target Frame (or FrameSet). Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 No attributes have been set in the template Frame (created by a stFrame), so no Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 restriction has been placed on the required coordinate system, other than that Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 it should have 3 dimensions. The first suitable Frame found wil l be returned as Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a celestial coordinate system in the target Fra me (or FrameSet). Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 The type of celestial coordinate system is unspecified, so astF indFrame will Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 return the first one found as part of the " result" FrameSet. I f the target is a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 FrameSet, then its Current attribute will be updated to identif y the Frame that Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If no celestial coordinate system can be found, a value of AS T__NULL will be Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This is like the last example, except that in the event of t he target being a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 CmpFrame[], the component Frames encapsulated by the CmpFrame will be searched for Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 a SkyFrame. If found, the returned Mapping will included a []Pe rmMap[] which selects Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 This is acomplished by setting the MaxAxes attribute of the t emplate SkyFrame Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to a large number (larger than or equal to the number of axes i n the target Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 CmpFrame). This allows the SkyFrame to be used as a match for F rames containing Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for an equatorial (FK5) coordinate system in the ta rget. The []Equinox[] Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 value for the coordinate system has not been specified, so will be obtained from Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the target. If the target is a FrameSet, its Current attribute will be updated Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for a 2-dimensional coordinate system in the target . Initially, a Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 search is made for a suitable coordinate system whose Domain at tribute has the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 value " SKY" . If this search fails, a search is then made for one with the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 domain " PIXEL" . If this also fails, then any 2-dimensional co ordinate system [268] Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 Only if no 2-dimensional coordinate systems can be reached by applying built-in Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 conversions to any of the Frames in the target will a value of AST__NULL be Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for any 1-dimensional coordinate system in the targ et which has the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This example has exactly the same effect as that above. It i llustrates Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the equivalence of the template' s Domain attribute and the fie lds in the " Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 This is a more advanced example which will search for any co ordinate system Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the target having 1, 2 or 3 dimensions. The Frame returned ( as part of the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " result" FrameSet) will always be 1-dimensional, but will be r elated to the Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system that was found by a suitable Mapping (e.g. a PermMap) which Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 If we had wanted a Frame representing the actual (1, 2 or 3-d imensional) Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 coordinate system found, we could set the []PreserveAxes[] attr ibute to a non-zero Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 [] \T1/cmtt/m/n/10 Searches for any celestial coordinate system in the target, but only finds one Underfull \hbox (badness 10000) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 if its axes are in the conventional (longitude,latitude) order and have not been Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 The Mapping represented by the returned FrameSet results in alignment taking place Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the coordinate system specified by the []AlignSystem[] attri bute of the " template" Overfull \hbox (42.36206pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Beware of setting the Domain attribute of the template and then using a " domainlist" Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 string which does not include the template' s domain (or a blan k field). If you Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (12.76088pt too wide) in paragraph at lines 15834--15834 []\T1/cmtt/m/n/10 A Frame (describing a coordinate system) will be found by thi s function if (a) it is Overfull \hbox (34.01819pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 " matched" by the template you supply, and (b) the value of its Domain attribute appears Overfull \hbox (40.84152pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the " domainlist" string (except that a blank field in this string permits any domain). Overfull \hbox (20.63396pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 A successful match by the template depends on a number of crite ria, as outlined below: [269] Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 In general, a template will only match another Frame which belongs to the same Overfull \hbox (2.99667pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 class as the template, or to a derived (more specialised) class . For example, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 a SkyFrame template will match any other SkyFrame, but will not match a basic Overfull \hbox (29.24026pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 The exception to this is that a Frame of any class can be u sed to match a CmpFrame, Overfull \hbox (29.24026pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 if that CmpFrame contains a Frame of the same class as the temp late. Note however, Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the MaxAxes and []MinAxes[] attributes of the template must be set to suitable values Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to allow it to match the CmpFrame. That is, the MinAxes attribu te must be less Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 than or equal to the number of axes in the target, and the MaxA xes attribute must Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If using a CmpFrame as a template frame, the MinAxes and Ma xAxes for the template Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 are determined by the MinAxes and MaxAxes values of the compone nt Frames within Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the template. So if you want a template CmpFrame to be able to match Frames with Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 different numbers of axes, then you must set the MaxAxes and/or MinAxes attributes Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 in the component template Frames, before combining them togethe r into the template Overfull \hbox (10.60732pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 If a template has a value set for any of its main attribute s, then it will only Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 match Frames which have an identical value for that attribute ( or which can be Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 transformed, using a built-in conversion, so that they have the required value Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 for that attribute). If any attribute in the template is un-set , however, then Overfull \hbox (21.36719pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Frames are matched regardless of the value they may have for th at attribute. You Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 may therefore make a template more or less specific by choosing the attributes Overfull \hbox (52.8595pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 for which you set values. This requirement does not apply to ' descriptive' attributes Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 An important application of this principle involves the Dom ain attribute. Setting Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the Domain attribute of the template has the effect of restrict ing the search Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to a particular type of Frame (with the domain you specify). Co nversely, if the Overfull \hbox (10.86975pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 Domain attribute is not set in the template, then the domain of the Frame found Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 is not relevant, so all Frames are searched. Note that the " do mainlist" string Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 provides an alternative way of restricting the search in the sa me manner, but Overfull \hbox (5.3586pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 is a more convenient interface if you wish to search automatica lly for another Overfull \hbox (5.62103pt too wide) in paragraph at lines 15834--15834 [][]\T1/cmtt/m/n/10 Normally, a template will only match a Frame which has the same number of axes Overfull \hbox (0.10988pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 as itself. However, for some classes of template, this default behaviour may Overfull \hbox (23.99155pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 be changed by means of the MinAxes, MaxAxes and []MatchEnd[] at tributes. In addition, Overfull \hbox (0.37231pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 the behaviour of a template may be influenced by its Permute an d PreserveAxes Overfull \hbox (23.99155pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 attributes, which control whether it matches Frames whose axes have been permuted, Overfull \hbox (31.86462pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 and whether this permutation is retained in the Frame which is returned (as opposed Overfull \hbox (26.6159pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 to returning the axes in the order specified in the template, w hich is the default Overfull \hbox (16.11847pt too wide) in paragraph at lines 15834--15834 \T1/cmtt/m/n/10 behaviour). You should consult the descriptions of these attrib utes for details [270] [271] Overfull \hbox (8.09445pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFitsChan ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/ cmtt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink) ( const char Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a source function which takes no arguments and retur ns a pointer to Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 a null-terminated string. This function will be used by the Fit sChan to obtain Overfull \hbox (16.11847pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 input FITS header cards. On each invocation, it should read the next input card Overfull \hbox (88.55078pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 from some external source (such as a FITS file), and return a p ointer to the (null-terminated) Overfull \hbox (0.37231pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contents of the card. It should return a NULL pointer when ther e are no more Overfull \hbox (10.60732pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 If " source" is NULL, the FitsChan will remain empty until ca rds are explicitly Overfull \hbox (28.19052pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 stored in it (e.g. using astPutCards, astPutFits or via the Sou rceFile attribute). Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 this function will be used by the FitsChan to deliver any FITS header cards it Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contains when it is finally deleted. On each invocation, it sho uld deliver the Overfull \hbox (37.11334pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 contents of the character string passed to it as a FITS header card to some external Overfull \hbox (0.37231pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fi tsChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 Note, the FITSCHAN_OPTIONS environment variable may be used t o specify default Overfull \hbox (10.86975pt too wide) in paragraph at lines 16010--16010 [][]\T1/cmtt/m/n/10 No FITS " END" card will be written via the sink function. You should add this Overfull \hbox (5.62103pt too wide) in paragraph at lines 16010--16010 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 16010--16010 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 16010--16010 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [272] Overfull \hbox (17.69308pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 Pointer to an optional FitsChan containing headers to be stored in the FitsTable. Overfull \hbox (16.11847pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 NULL may be supplied if the new FitsTable is to be left empty. If supplied, and Overfull \hbox (9.82pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 if the headers describe columns of a FITS binary table, then eq uivalent (empty) Overfull \hbox (37.11334pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 columns are added to the FitsTable. Each column has the same in dex in the FitsTable Overfull \hbox (10.86975pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fi tsTable. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 16089--16089 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 16089--16089 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 16089--16089 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 16089--16089 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [273] Overfull \hbox (26.51622pt too wide) in paragraph at lines 16187--16187 []\T1/cmtt/m/n/10 AstFluxFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astFluxFra me( double specval, AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 specfrm, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, Overfull \hbox (31.60219pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 The spectral value to which the flux values refer, given in the spectral coordinate Overfull \hbox (21.10475pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 system specified by " specfrm" . The value supplied for the " s pecval" parameter Overfull \hbox (0.10988pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 becomes the default value for the SpecVal attribute. A value of AST__BAD may Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 be supplied if the spectral position is unknown, but this may r esult in it not Overfull \hbox (0.37231pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 being possible for the []astConvert[] function to determine a [ ]Mapping[] between the Overfull \hbox (10.60732pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 A pointer to a []SpecFrame[] describing the spectral coordinate system in which the Overfull \hbox (47.61078pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 " specval" parameter is given. A deep copy of this object is ta ken, so any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 changes to the SpecFrame using the supplied pointer will have n o effect on the Overfull \hbox (42.36206pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 new FluxFrame. A NULL pointer can be supplied if AST__BAD is su pplied for " specval" Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fl uxFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (21.36719pt too wide) in paragraph at lines 16187--16187 [][]\T1/cmtt/m/n/10 When conversion between two FluxFrames is requested (as whe n supplying FluxFrames Overfull \hbox (26.6159pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 to astConvert), account will be taken of the nature of the flux coordinate systems Overfull \hbox (58.10822pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 they represent, together with any qualifying attribute values, including the []AlignSystem[] Overfull \hbox (0.37231pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 attribute. The results will therefore fully reflect the relatio nship between Overfull \hbox (10.86975pt too wide) in paragraph at lines 16187--16187 \T1/cmtt/m/n/10 positions measured in the two systems. In addition, any differe nce in the Unit [274] Overfull \hbox (5.62103pt too wide) in paragraph at lines 16187--16187 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [275] Overfull \hbox (36.8509pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 The number of the Frame axis for which formatting is to be perf ormed (axis numbering Overfull \hbox (0.37231pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 16250--16250 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (0.37231pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 A formatted value may be converted back into a numerical (d ouble) value using Overfull \hbox (5.3586pt too wide) in paragraph at lines 16250--16250 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [276] Overfull \hbox (15.85603pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 The number of Frame axes (i.e. the number of dimensions of the coordinate space Overfull \hbox (10.86975pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fr ame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 Creates a new 2-dimensional Frame and initialises its Title attribute to the Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 \T1/cmtt/m/n/10 string " Energy Spectrum: Plot $\OML/zplm/m/it/10 <$\T1/cmtt/m/ n/10 n$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 " , where $\OML/zplm/m/it/10 <$\T1/c mtt/m/n/10 n$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 takes the value of the int Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 Underfull \hbox (badness 10000) in paragraph at lines 16339--16339 [] \T1/cmtt/m/n/10 Creates a new 2-dimensional Frame and initialises its axis L abel attributes Overfull \hbox (5.62103pt too wide) in paragraph at lines 16339--16339 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [277] [278] Overfull \hbox (37.11334pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Pointer to the first Frame to be inserted into the FrameSet. Th is initially becomes Overfull \hbox (58.10822pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 both the base and the current Frame. (Further Frames may be add ed using the []astAddFrame[] Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Fr ameSet. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [279] Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 [][]\T1/cmtt/m/n/10 If a pointer to an existing FrameSet is given for the " fra me" parameter, then Overfull \hbox (31.86462pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 the new FrameSet will (as a special case) be initialised to con tain the same Frames Overfull \hbox (10.86975pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 and Mappings, and to have the same attribute values, as the one supplied. This Overfull \hbox (16.11847pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 process is similar to making a copy of a FrameSet (see []astCop y[]), except that the Overfull \hbox (16.11847pt too wide) in paragraph at lines 16453--16453 \T1/cmtt/m/n/10 Frames and Mappings contained in the original are not themselve s copied, but are Overfull \hbox (5.62103pt too wide) in paragraph at lines 16453--16453 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [280] Overfull \hbox (5.3586pt too wide) in paragraph at lines 16482--16482 \T1/cmtt/m/n/10 Pointer to a text string holding an Object serialisation create d previously by Overfull \hbox (60.26178pt too wide) in paragraph at lines 16482--16482 \T1/cmtt/m/n/10 Pointer to a new Object created from the supplied serialisation , or NULL if the serialisation [281] Overfull \hbox (10.86975pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 Pointer to a Mapping. This Mapping should have 1 input coordina te representing Overfull \hbox (0.37231pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 offset along the required curve, normalized so that the start o f the curve is Overfull \hbox (21.36719pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 at offset 0.0, and the end of the curve is at offset 1.0. Note, this offset does Overfull \hbox (26.6159pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 not need to be linearly related to distance along the curve. Th e number of output Overfull \hbox (26.6159pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 coordinates should equal the number of axes in the current []Fr ame[] of the Plot. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 Mapping should map a specified offset along the curve, into the corresponding Overfull \hbox (5.62103pt too wide) in paragraph at lines 16536--16536 \T1/cmtt/m/n/10 coordinates in the current Frame of the Plot. The inverse trans formation need Overfull \hbox (10.86975pt too wide) in paragraph at lines 16536--16536 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [282] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16618. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the attribute whose Overfull \hbox (32.085pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 The attribute value, in the data type corresponding to $\OML/zp lm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 (or, in the case of astGetC, Overfull \hbox (13.02332pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 a pointer to a constant null-terminated character string contai ning this value). Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 Underfull \hbox (badness 10000) in paragraph at lines 16618--16618 [] \T1/cmtt/m/n/10 Obtains a pointer to a null-terminated character string cont aining the Title Overfull \hbox (5.62103pt too wide) in paragraph at lines 16618--16618 [][]\T1/cmtt/m/n/10 An appropriate " null" value will be returned if this funct ion is invoked with Overfull \hbox (10.86975pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 the AST error status set, or if it should fail for any reason. This null value Overfull \hbox (10.86975pt too wide) in paragraph at lines 16618--16618 [][]\T1/cmtt/m/n/10 The pointer returned by astGetC is guaranteed to remain val id and the string to Overfull \hbox (21.10475pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 which it points will not be over-written for a total of 50 succ essive invocations Overfull \hbox (8.24539pt too wide) in paragraph at lines 16618--16618 \T1/cmtt/m/n/10 of this function. After this, the memory containing the string may be re-used, [283] Overfull \hbox (31.86462pt too wide) in paragraph at lines 16656--16656 [][]\T1/cmtt/m/n/10 A zero value will be returned if this function is invoked w ith the AST error status [284] Overfull \hbox (2.6858pt too wide) in paragraph at lines 16752--16752 []\T1/cmtt/m/n/10 void astGetColumnData( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, flo at fnull, double Overfull \hbox (22.67937pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The value to return in " coldata" for any cells for which no va lue has been stored Overfull \hbox (47.61078pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the FitsTable. Ignored if the column' s data type is not AST __FLOATTYPE. Supplying Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The value to return in " coldata" for any cells for which no va lue has been stored Overfull \hbox (52.8595pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the FitsTable. Ignored if the column' s data type is not AST __DOUBLETYPE. Supplying Overfull \hbox (15.85603pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The size of the " coldata" array, in bytes. The amount of memor y needed to hold Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 the data from a column may be determined using []astColumnSize[ ]. If the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 array is too small to hold all the column data, trailing column values will be Overfull \hbox (26.35347pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 A pointer to an area of memory in which to return the data valu es currently stored Overfull \hbox (31.60219pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 in the column. The values are stored in row order. If the colum n holds non-scalar Overfull \hbox (15.85603pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 values, the elements of each value are stored in " Fortran" ord er. No data type Overfull \hbox (10.86975pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 conversion is performed - the data type of each returned value is the data type Overfull \hbox (21.36719pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 associated with the column when the column was added to the tab le. If the column Overfull \hbox (0.37231pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 holds strings, the returned strings will be null terminated. An y excess room Overfull \hbox (0.10988pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 The number of elements returned in the " coldata" array. This i s the product Overfull \hbox (7.19565pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 of the number of rows returned and the number of elements in ea ch column value. Underfull \hbox (badness 10000) in paragraph at lines 16752--16752 Overfull \hbox (0.10988pt too wide) in paragraph at lines 16752--16752 [][]\T1/cmtt/m/n/10 The " fnull" and " dnull" parameters specify the value to b e returned for any Overfull \hbox (5.62103pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 empty cells within columns holding floating point values. For c olumns holding Overfull \hbox (10.86975pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 integer values, the value returned for empty cells is the value returned by the Overfull \hbox (31.60219pt too wide) in paragraph at lines 16752--16752 \T1/cmtt/m/n/10 astColumNull function. For columns holding string values, the A SCII NULL character [285] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 16912. Overfull \hbox (7.19565pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (39.7377pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 from it. No more than 80 characters are read from this string. If NULL is supplied, Overfull \hbox (0.10988pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 A pointer to a buffer to receive the keyword value. The data ty pe depends on Overfull \hbox (11.82336pt too wide) in paragraph at lines 16912--16912 \OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 as d escribed above. The conents of the buffer on entry are left unchanged [286] Overfull \hbox (2.001pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 A value of zero is returned if the keyword was not found in the FitsChan (no error Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If a name is supplied, the card following the current card is checked first. If Overfull \hbox (26.6159pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 this is not the required card, then the rest of the FitsChan is searched, starting Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 with the first card added to the FitsChan. Therefore cards shou ld be accessed Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 in the order they are stored in the FitsChan (if possible) as t his will minimise Overfull \hbox (26.6159pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the requested card is found, it becomes the current card , otherwise the current Overfull \hbox (5.62103pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the stored keyword value is not of the requested type, i t is converted into Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 If the keyword is found in the FitsChan, but has no associa ted value, an error Overfull \hbox (0.37231pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 is reported. If necessary, the []astTestFits[] function can be used to determine Overfull \hbox (22.9418pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 if the keyword has a defined value in the FitsChan prior to cal ling this function. Overfull \hbox (33.43924pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. Overfull \hbox (5.3586pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 .FALSE. is returned as the function value if an error has a lready occurred, or Overfull \hbox (16.11847pt too wide) in paragraph at lines 16912--16912 [][]\T1/cmtt/m/n/10 The FITS standard says that string keyword values should be padded with trailing Overfull \hbox (10.86975pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 spaces if they are shorter than 8 characters. For this reason, trailing spaces Overfull \hbox (42.36206pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 are removed from the string returned by astGetFitsS if the orig inal string (including Overfull \hbox (0.37231pt too wide) in paragraph at lines 16912--16912 \T1/cmtt/m/n/10 any trailing spaces) contains 8 or fewer characters. Trailing s paces are not [287] Overfull \hbox (5.3586pt too wide) in paragraph at lines 16964--16964 \T1/cmtt/m/n/10 The index of the required Frame within the FrameSet. This value should lie in Overfull \hbox (16.11847pt too wide) in paragraph at lines 16964--16964 \T1/cmtt/m/n/10 the range from 1 to the number of Frames in the FrameSet (as gi ven by its []Nframe[] Overfull \hbox (0.10988pt too wide) in paragraph at lines 16964--16964 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter Overfull \hbox (5.62103pt too wide) in paragraph at lines 16964--16964 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [288] Overfull \hbox (2.26344pt too wide) in paragraph at lines 16997--16997 \T1/cmtt/m/n/10 A pointer to the graphics context KeyMap. The returned pointer should be annulled [289] Overfull \hbox (26.35347pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 The index of the first []Frame[] in the FrameSet. This Frame de scribes the coordinate Overfull \hbox (31.60219pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 The index of the second Frame in the FrameSet. This Frame descr ibes the coordinate Overfull \hbox (18.27203pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 Pointer to a Mapping whose forward transformation converts coor dinates from the first Overfull \hbox (44.51563pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 coordinate system to the second one, and whose inverse transfor mation converts coordinates Overfull \hbox (15.85603pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 The returned Mapping will include the clipping effect of an y Regions which occur Overfull \hbox (26.6159pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 on the path between the two supplied Frames (this includes the two supplied Frames Overfull \hbox (10.86975pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 The values given for the " iframe1" and " iframe2" paramete rs should lie in the Overfull \hbox (54.43411pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 range from 1 to the number of Frames in the FrameSet (as given by its []Nframe[] attribute). Overfull \hbox (13.75655pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may also be given to ident ify the FrameSet' Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 s base Frame or current Frame respectively. It is permissible f or both these Overfull \hbox (43.93668pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 parameters to have the same value, in which case a unit Mapping ([]UnitMap[]) is returned. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 It should always be possible to generate the Mapping reques ted, but this does Overfull \hbox (0.37231pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 necessarily guarantee that it will be able to perform the requi red coordinate Overfull \hbox (42.36206pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 conversion. If necessary, the []TranForward[] and []TranInverse [] attributes of the returned Overfull \hbox (38.68796pt too wide) in paragraph at lines 17072--17072 \T1/cmtt/m/n/10 Mapping should be inspected to determine if the required transf ormation is available. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17072--17072 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [290] Overfull \hbox (7.30714pt too wide) in paragraph at lines 17128--17128 []\T1/cmtt/m/n/10 void astGetRefPos( AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, AstSkyFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frm, double $\ OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 lon, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 lat ) Overfull \hbox (7.19565pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 Pointer to the SkyFrame which defines the required celestial co ordinate system. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 If NULL is supplied, then the longitude and latitude values are returned as FK5 Overfull \hbox (15.85603pt too wide) in paragraph at lines 17128--17128 \T1/cmtt/m/n/10 A pointer to a double in which to store the longitude of the re ference point, in Overfull \hbox (10.86975pt too wide) in paragraph at lines 17128--17128 [] \T1/cmtt/m/n/10 A pointer to a double in which to store the latitude of t he reference point, in Overfull \hbox (26.35347pt too wide) in paragraph at lines 17128--17128 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error [291] Overfull \hbox (28.19052pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 Pointer to an array in which to return the lower axis bounds co vered by the Region. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 It should have at least as many elements as there are axes in t he Region. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 an axis has no lower limit, the returned value will be the larg est possible negative Overfull \hbox (28.19052pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 Pointer to an array in which to return the upper axis bounds co vered by the Region. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 It should have at least as many elements as there are axes in t he Region. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 an axis has no upper limit, the returned value will be the larg est possible positive Overfull \hbox (26.6159pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 The value of the Negated attribute is ignored (i.e. it is a ssumed that the Region Overfull \hbox (15.85603pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 If an axis has no extent on an axis then the lower limit wi ll be returned larger Overfull \hbox (5.62103pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 than the upper limit. Note, this is different to an axis which has a constant Overfull \hbox (36.8509pt too wide) in paragraph at lines 17188--17188 \T1/cmtt/m/n/10 value (in which case both lower and upper limit will be returne d set to the constant Overfull \hbox (26.35347pt too wide) in paragraph at lines 17188--17188 [][]\T1/cmtt/m/n/10 If the bounds on an axis cannot be determined, AST__BAD is returned for both upper [292] Overfull \hbox (12.49844pt too wide) in paragraph at lines 17226--17226 \T1/cmtt/m/n/10 A pointer to a deep copy of the Frame represented by the Region . Using this pointer Overfull \hbox (18.27203pt too wide) in paragraph at lines 17226--17226 \T1/cmtt/m/n/10 to modify the Frame will have no effect on the Region. To modif y the Region, use the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17226--17226 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [293] Overfull \hbox (28.2446pt too wide) in paragraph at lines 17267--17267 \T1/cmtt/m/n/10 A pointer to a deep copy of the FrameSet represented by the Reg ion. Using this pointer Overfull \hbox (5.62103pt too wide) in paragraph at lines 17267--17267 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [294] Overfull \hbox (12.97206pt too wide) in paragraph at lines 17348--17348 []\T1/cmtt/m/n/10 void astGetRegionMesh( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cm tt/m/n/10 this, int surface, int maxpoint, int maxcoord, int Overfull \hbox (23.99155pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 If non-zero, the returned points will cover the surface or the Region. Otherwise, Overfull \hbox (21.57837pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 If zero, the number of points in the mesh is returned in " $\OM S/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 npoint" , but no axis Overfull \hbox (36.8509pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 values are returned and all other parameters are ignored. If no t zero, the supplied Overfull \hbox (5.3586pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 value should be the length of the second dimension of the " poi nts" array. An Overfull \hbox (10.60732pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 The length of the first dimension of the " points" array. An er ror is reported Overfull \hbox (10.60732pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 A pointer to an integer in which to return the number of points in the returned Overfull \hbox (68.34322pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [maxcoord][maxpoint]" Overfull \hbox (31.86462pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 , in which to return the coordinate values at the mesh position s. These are stored Overfull \hbox (5.62103pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 such that the value of coordinate number " coord" for point num ber " point" is Overfull \hbox (16.11847pt too wide) in paragraph at lines 17348--17348 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Region has been changed since it was Overfull \hbox (0.37231pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 first created, the returned axis values refer to the new (chang ed) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (36.8509pt too wide) in paragraph at lines 17348--17348 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [295] Overfull \hbox (32.0758pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 If zero, the number of points needed to define the Region is re turned in " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 npoint" Overfull \hbox (10.86975pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 , but no axis values are returned and all other parameters are ignored. If not Overfull \hbox (5.62103pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 zero, the supplied value should be the length of the second dim ension of the " Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 points" array. An error is reported if the number of points nee ded to define Overfull \hbox (10.60732pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The length of the first dimension of the " points" array. An er ror is reported Overfull \hbox (33.1768pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 A pointer to an integer in which to return the number of points defining the Region. Overfull \hbox (68.34322pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [maxcoord][maxpoint]" Overfull \hbox (28.19052pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 , in which to return the coordinate values at the positions tha t define the Region. Overfull \hbox (31.33975pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 These are stored such that the value of coordinate number " coo rd" for point number Overfull \hbox (2.26344pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first returned position is the Circle centre, and the secon d is a point on the Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. Overfull \hbox (33.75575pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 To find the points defining a CmpRegion, use this method on the component Regions, which Overfull \hbox (7.51216pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first returned position is the Ellipse centre. The second i s the end of one of Overfull \hbox (7.7746pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 the axes of the ellipse. The third is some other point on the c ircumference of the Overfull \hbox (44.25319pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The first point corresponds to the lower bounds position, and t he second point corresponds Overfull \hbox (7.7746pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 to the upper bounds position. These are reversed to indicate an extcluded interval Overfull \hbox (14.59793pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 rather than an included interval. See the Interval constructor for more information. [296] Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. Overfull \hbox (24.83293pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The positions returned are those that were supplied when the Po intList was constructed. Overfull \hbox (7.51216pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 The positions returned are the vertex positions that were suppl ied when the Polygon Overfull \hbox (30.55527pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 Returns a value of zero for " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 npoint" and leaves the supplied array contents unchanged. Overfull \hbox (12.76088pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 To find the points defining a Prism, use this method on the com ponent Regions, which Overfull \hbox (16.11847pt too wide) in paragraph at lines 17497--17497 [][]\T1/cmtt/m/n/10 If the coordinate system represented by the Region has been changed since it was Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 first created, the returned axis values refer to the new (chang ed) coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 system, rather than the original coordinate system. Note howeve r that if the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 transformation from original to new coordinate system is non-li near, the shape Overfull \hbox (36.8509pt too wide) in paragraph at lines 17497--17497 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [297] Overfull \hbox (0.10988pt too wide) in paragraph at lines 17552--17552 \T1/cmtt/m/n/10 The index of the AstroCoords element required. The first has in dex one. The Overfull \hbox (43.93668pt too wide) in paragraph at lines 17552--17552 \T1/cmtt/m/n/10 number of AstroCoords elements in the Stc can be found using fu nction astGetStcNcoord. Underfull \hbox (badness 10000) in paragraph at lines 17552--17552 Overfull \hbox (5.62103pt too wide) in paragraph at lines 17552--17552 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [298] Overfull \hbox (13.49411pt too wide) in paragraph at lines 17588--17588 [][]\T1/cmtt/m/n/10 Zero will be returned if this function is invoked with the AST error status set, [299] Overfull \hbox (5.62103pt too wide) in paragraph at lines 17625--17625 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [300] Overfull \hbox (28.19052pt too wide) in paragraph at lines 17668--17668 [][]\T1/cmtt/m/n/10 The returned pointer should be annulled using []astAnnul[] when it is no longer needed. Overfull \hbox (33.43924pt too wide) in paragraph at lines 17668--17668 [][]\T1/cmtt/m/n/10 Changing the contents of the returned FitsChan will have no effect on the FitsTable. Overfull \hbox (5.3586pt too wide) in paragraph at lines 17668--17668 \T1/cmtt/m/n/10 To modify the FitsTable, the modified FitsChan must be stored i n the FitsTable [301] Overfull \hbox (10.13652pt too wide) in paragraph at lines 17724--17724 \T1/cmtt/m/n/10 A pointer to a deep copy of the KeyMap holding the tables curre ntly in the FitsChan, Overfull \hbox (13.02332pt too wide) in paragraph at lines 17724--17724 \T1/cmtt/m/n/10 or NULL if the FitsChan does not contain any tables. The return ed pointer should be Overfull \hbox (5.62103pt too wide) in paragraph at lines 17724--17724 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [302] Overfull \hbox (47.34834pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 Controls what is returned if no uncertainty information has bee n associated explicitly Overfull \hbox (57.58334pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 with the supplied Region. If a non-zero value is supplied, then the default uncertainty Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 Region used internally within AST is returned (see " Applicabil ity" below). If Overfull \hbox (24.83293pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 The default uncertainty for a CmpRegion is taken from one of th e two component Regions. Overfull \hbox (7.7746pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 If the first component Region has a non-default uncertainty, th en it is used as the Overfull \hbox (34.01819pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 default uncertainty for the parent CmpRegion. Otherwise, if the second component Region Overfull \hbox (34.01819pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 has a non-default uncertainty, then it is used as the default u ncertainty for the parent Overfull \hbox (18.27203pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 CmpRegion. If neither of the component Regions has non-default uncertainty, then the Overfull \hbox (14.59793pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 default uncertainty for the CmpRegion is 1.0E-6 of the bounding box of the CmpRegion. Overfull \hbox (18.0096pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 The default uncertainty for a Prism is formed by combining the uncertainties from the Overfull \hbox (20.8964pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 two component Regions. If a component Region does not have a no n-default uncertainty, Overfull \hbox (28.76947pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 then its default uncertainty will be used to form the default u ncertainty of the parent Overfull \hbox (2.26344pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 For other classes of Region, the default uncertainty is 1.0E-6 of the bounding box Overfull \hbox (12.76088pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 of the Region. If the bounding box has zero width on any axis, then the uncertainty Overfull \hbox (21.36719pt too wide) in paragraph at lines 17815--17815 [][]\T1/cmtt/m/n/10 If uncertainty information is associated with a Region, and the coordinate system Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 described by the Region is subsequently changed (e.g. by changi ng the value of Overfull \hbox (10.60732pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 its []System[] attribute, or using the []astMapRegion[] functio n), then the uncertainty Overfull \hbox (10.86975pt too wide) in paragraph at lines 17815--17815 \T1/cmtt/m/n/10 information returned by this function will be modified so that it refers to the Overfull \hbox (5.62103pt too wide) in paragraph at lines 17815--17815 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (NULL) will be returned if this f unction is invoked with [303] Overfull \hbox (5.62103pt too wide) in paragraph at lines 17852--17852 [][]\T1/cmtt/m/n/10 This function returns without action if there are no snapsh ots to restore. No [304] [305] Overfull \hbox (31.60219pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 A name indicating the graphics function to be replaced. Various graphics functions Overfull \hbox (26.6159pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 are used by the Plot class, and any combination of them may be supplied by calling Overfull \hbox (47.61078pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 this function once for each function to be replaced. If any of the graphics functions Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 are not replaced in this way, the corresponding functions in th e graphics interface Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 selected at link-time (using the ast_link command) are used. Th e allowed names Overfull \hbox (13.23167pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The string is case insensitive. For details of the interface re quired for each, Overfull \hbox (5.09616pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 A Pointer to the function to be used to provide the functionali ty indicated by Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 parameter name. The interface for each function is described be low, but the function Overfull \hbox (21.36719pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 Once a function has been provided, a null pointer can be supp lied in a subsequent Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 call to astGrfSet to reset the function to the corresponding fu nction in the graphics Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 All the functions listed below (except for " Cap" ) should re turn an integer value Overfull \hbox (60.26178pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of 0 if an error occurs, and 1 otherwise. All x and y values re fer to " graphics cordinates" Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The first parameter (" grfcon" ) for each function is an AST []KeyMap[] pointer that can Overfull \hbox (9.34921pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 be used by the called function to establish the context in whic h it is being called. Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The contents of the KeyMap are determined by the calling applic ation, which should Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 obtain a pointer to the KeyMap using the []astGetGrfContext[] f unction, and then store Overfull \hbox (15.64767pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 any necessary information in the KeyMap using the methods of th e KeyMap class. Note, Overfull \hbox (9.34921pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the functions listed below should never annul or delete the sup plied KeyMap pointer. [306] Overfull \hbox (18.0096pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Attr" function returns the current value of a specified graphics attribute, and Overfull \hbox (2.26344pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 optionally establishes a new value. The supplied value is conve rted to an integer Overfull \hbox (1.8985pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int Attr( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 grf con, int attr, double value, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 old_v alue, int prim ) Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 attr - An integer value identifying the required attribute. The following symbolic Overfull \hbox (7.98296pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 values are defined in grf.h: GRF__STYLE (Line style), GRF__WIDT H (Line width), Overfull \hbox (8.24539pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 GRF__SIZE (Character and marker size scale factor), GRF__FONT ( Character font), Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 value - A new value to store for the attribute. If this is AST__BAD no value Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 old_value - A pointer to a double in which to return the at tribute value. If Overfull \hbox (42.36206pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 prim - The sort of graphics primitive to be drawn with the new attribute. Identified Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " BBuf" function should start a new graphics buffering co ntext. A matching call Overfull \hbox (28.76947pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 to the function " EBuf" should be used to end the context. The nature of the buffering Overfull \hbox (10.13652pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Cap" function is called to determine if the grf module has a given capability, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 cap - The capability being inquired about. This will be one of the following Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 GRF__SCALES: This function should return a non-zero value if th e " Scales" function Overfull \hbox (19.84665pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 is implemented, and zero otherwise. The supplied " value" argum ent should be ignored. Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 GRF__MJUST: This function should return a non-zero value if t he " Text" and " TxExt" Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 functions recognise " M" as a character in the justification st ring. If the first Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 character of a justification string is " M" , then the text sho uld be justified with Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the given reference point at the bottom of the bounding box. Th is is different to Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 " B" justification, which requests that the reference point be put on the baseline Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of the text, since some characters hang down below the baseline . If the " Text" or Overfull \hbox (34.01819pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 " TxExt" function cannot differentiate between " M" and " B" , then this function should Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 return zero, in which case " M" justification will never be req uested by Plot. The [307] Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 GRF__ESC: This function should return a non-zero value if the " Text" and " TxExt" Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 functions can recognise and interpret graphics escape sequences within the supplied Overfull \hbox (2.52588pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 string (see attribute []Escape[]). Zero should be returned if e scape sequences cannot Overfull \hbox (4.1005pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 be interpreted (in which case the Plot class will interpret the m itself if needed). Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 The supplied " value" argument should be ignored only if escape sequences cannot be Overfull \hbox (13.02332pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 interpreted by " Text" and " TxExt" . Otherwise, " value" indic ates whether " Text" Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 and " TxExt" should interpret escape sequences in subsequent ca lls. If " value" is Overfull \hbox (41.89127pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 non-zero then escape sequences should be interpreted by " Text" and " TxExt" . Otherwise, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 value - The use of this parameter depends on the value of " cap" as described Overfull \hbox (21.36719pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 Returned Function Value: The value returned by the function depends on the value Overfull \hbox (21.10475pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of " cap" as described above. Zero should be returned if the su pplied capability Overfull \hbox (54.75063pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " EBuf" function should end the current graphics bufferin g context. See the description Overfull \hbox (12.49844pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Flush" function ensures that the display device is up-t o-date, by flushing any Overfull \hbox (44.25319pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Line" function displays lines joining the given positio ns and requires the following Overfull \hbox (33.75575pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Mark" function displays markers at the given positions. It requires the following [308] Overfull \hbox (28.19052pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 type - An integer which can be used to indicate the type of marker symbol required. Overfull \hbox (28.2446pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Qch" function returns the heights of characters drawn v ertically and horizontally Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 chv - A pointer to the float which is to receive the height of characters drawn Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 chh - A pointer to the float which is to receive the height of characters drawn Overfull \hbox (12.76088pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Scales" function returns two values (one for each axis) which scale increments Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 on the corresponding axis into a " normal" coordinate system in which: 1) the axes Overfull \hbox (23.52075pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 have equal scale in terms of (for instance) millimetres per uni t distance, 2) X values Overfull \hbox (23.52075pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 increase from left to right, and 3) Y values increase from bott om to top. It requires Overfull \hbox (17.69308pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 alpha - A pointer to the float which is to receive the scal e for the X axis (i.e. Overfull \hbox (12.44437pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 beta - A pointer to the float which is to receive the scale for the Y axis (i.e. Overfull \hbox (23.25832pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " Text" function displays a character string at a given p osition using a specified Overfull \hbox (0.53506pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int Text( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 grf con, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, float x, float y, c onst char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 just, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 just - A character string which specifies the location with in the text string Overfull \hbox (47.0859pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 which is to be placed at the reference position given by x and y. The first character Overfull \hbox (31.86462pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 may be ' T' for " top" , ' C' for " centre" , or ' B' for " bot tom" , and specifies Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 the vertical location of the reference position. Note, " bottom " corresponds Overfull \hbox (9.82pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 to the base-line of normal text. Some characters (eg " y" , " g " , " p" , etc) Overfull \hbox (3.52155pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 descend below the base-line. The second character may be ' L' f or " left" , ' Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 C' for " centre" , or ' R' for " right" , and specifies the hor izontal location Overfull \hbox (3.52155pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 of the reference position. If the string has less than 2 charac ters then ' C' Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 upx - The x component of the up-vector for the text. If nec essary the supplied Overfull \hbox (36.8509pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements [309] Overfull \hbox (10.86975pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 upy - The y component of the up-vector for the text. If nec essary the supplied Overfull \hbox (36.8509pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements Overfull \hbox (7.51216pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 The " TxExt" function returns the corners of a box which woul d enclose the supplied Overfull \hbox (7.7746pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 character string if it were displayed using the Text function d escribed above. The Overfull \hbox (47.13998pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 returned box includes any leading or trailing spaces. It requir es the following interface: Overfull \hbox (5.78378pt too wide) in paragraph at lines 18354--18354 []\T1/cmtt/m/n/10 int TxExt( AstObject $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 gr fcon, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, float x, float y, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 just, Overfull \hbox (0.37231pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 just - A character string which specifies the location with in the text string Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 \T1/cmtt/m/n/10 which is to be placed at the reference position given by x and y. See " Text" Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 xb - An array of 4 elements in which to return the x coordi nate of each corner Overfull \hbox (5.3586pt too wide) in paragraph at lines 18354--18354 [][]\T1/cmtt/m/n/10 yb - An array of 4 elements in which to return the y coordi nate of each corner [310] Overfull \hbox (47.61078pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 If the supplied Plot is a []Plot3D[], the axes will be anno tated using three 2-dimensional Overfull \hbox (21.36719pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 Plots, one for each 2D plane in the 3D current coordinate syste m. The plots will Overfull \hbox (21.36719pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 be " pasted" onto 3 faces of the cuboid graphics volume specifi ed when the Plot3D Overfull \hbox (0.10988pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 was constructed. The faces to be used can be controlled by the " []RootCorner[]" Overfull \hbox (0.37231pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 An error results if either the current []Frame[] or the bas e Frame of the Plot is Overfull \hbox (10.86975pt too wide) in paragraph at lines 18399--18399 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames Overfull \hbox (0.37231pt too wide) in paragraph at lines 18399--18399 \T1/cmtt/m/n/10 of the Plot is not defined in either direction (i.e. the Plot' s []TranForward[] [311] Overfull \hbox (15.85603pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 The index of the Plot axis whose physical coordinate value is t o be varied along Overfull \hbox (5.62103pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 the length of the curve (all other coordinates will remain fixe d). This value Overfull \hbox (42.09962pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (26.35347pt too wide) in paragraph at lines 18466--18466 \T1/cmtt/m/n/10 The length of curve to be drawn, given as an increment along th e selected physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 18466--18466 [][]\T1/cmtt/m/n/10 No curve is drawn if the " start" array contains any coordi nates with the value Overfull \hbox (10.86975pt too wide) in paragraph at lines 18466--18466 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [312] Overfull \hbox (10.86975pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Gr ismMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 18533--18533 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 18533--18533 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 18533--18533 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [313] Overfull \hbox (10.60732pt too wide) in paragraph at lines 18581--18581 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [314] Overfull \hbox (15.85603pt too wide) in paragraph at lines 18618--18618 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces [315] Overfull \hbox (31.60219pt too wide) in paragraph at lines 18655--18655 \T1/cmtt/m/n/10 The character string holding the upper case name of the paramet er. Trailing spaces [316] [317] Overfull \hbox (28.71822pt too wide) in paragraph at lines 18775--18775 []\T1/cmtt/m/n/10 void astIntersect( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const double a1[2], const double a2[2], const double Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Naxes[] attribute). This Overfull \hbox (1.94693pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (7.19565pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (1.94693pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the second geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (31.86462pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 For SkyFrames each curve will be a great circle, and in gen eral each pair of curves Overfull \hbox (0.10988pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 will intersect at two diametrically opposite points on the sky. The returned Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input Overfull \hbox (0.37231pt too wide) in paragraph at lines 18775--18775 \T1/cmtt/m/n/10 coordinates has this value, or if the two points defining eithe r geodesic are Overfull \hbox (21.36719pt too wide) in paragraph at lines 18775--18775 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between [318] Overfull \hbox (10.55888pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 AstInterval $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astInterval ( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const double lbnd[], co nst double ubnd[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (42.09962pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute) containing Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the lower limits on each axis. Set a value to AST__BAD to indic ate that the axis Overfull \hbox (42.09962pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the upper limits on each axis. Set a value to AST__BAD to indic ate that the axis Overfull \hbox (47.34834pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 with the boundary of the Interval being created. The uncertaint y in any point Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 on the boundary of the Interval is found by shifting the suppli ed " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 are centro-symetric (e.g. Box, []Circle[], []Ellipse[], etc.) o r be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (26.09103pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 will have no effect on the created Interval. Alternatively, a N ULL []Object[] pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [319] Overfull \hbox (10.86975pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new In terval. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 18908--18908 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 18908--18908 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 18908--18908 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 18908--18908 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [320] Overfull \hbox (5.52135pt too wide) in paragraph at lines 19000--19000 []\T1/cmtt/m/n/10 AstIntraMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astIntraMap ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int nin, int nout, con st char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the transformation Overfull \hbox (17.69308pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 function to use (which should previously have been registered u sing astIntraReg). Overfull \hbox (26.35347pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 The number of input coordinates. This must be compatible with t he number of input Overfull \hbox (37.11334pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 coordinates accepted by the transformation function (as specifi ed when this function Overfull \hbox (0.10988pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 The number of output coordinates. This must be compatible with the number of Overfull \hbox (0.37231pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 output coordinates produced by the transformation function (as specified when Overfull \hbox (10.86975pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new In traMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19000--19000 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19000--19000 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 19000--19000 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [321] [322] Overfull \hbox (5.78378pt too wide) in paragraph at lines 19183--19183 []\T1/cmtt/m/n/10 astIntraReg( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, int nin, int nout, void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 tran)( A stMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 , int, Overfull \hbox (26.77866pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 int, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 [], int , int, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 [] ), unsigned int flags, c onst char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 purpose, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing a unique name to be associated Overfull \hbox (48.92296pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 with the transformation function in order to identify it. This name is case sensitive. Overfull \hbox (26.35347pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 The number of input coordinates accepted by the transformation function (i.e. the Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 number of dimensions of the space in which the input points res ide). A value Overfull \hbox (21.10475pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of AST__ANY may be given if the function is able to accommodate a variable number Overfull \hbox (1.6845pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 The number of output coordinates produced by the transformation function (i.e. Overfull \hbox (26.6159pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the number of dimensions of the space in which the output point s reside). A value Overfull \hbox (0.10988pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of AST__ANY may be given if the function is able to produce a v ariable number Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to the transformation function to be registered. This f unction should Overfull \hbox (42.36206pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 perform whatever coordinate transformations are required and sh ould have an interface Overfull \hbox (21.10475pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 This value may be used to supply a set of flags which describe the transformation Overfull \hbox (23.99155pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function and which may affect the behaviour of any IntraMap whi ch uses it. Often, Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 a value of zero will be given here, but you may also supply the bitwise OR of Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing a short (one lin e) textual comment Overfull \hbox (73.85437pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing the name of the author of the transformation Overfull \hbox (0.10988pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing contact details for the author Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 of the transformation function (e.g. an e-mail or WWW address). If any IntraMap Overfull \hbox (5.3586pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses this transformation function is exported as part of a dataset to an Overfull \hbox (26.6159pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 external user who does not have access to the function, then th ese contact details [323] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 Beware that an external representation of an IntraMap (crea ted by writing it to Overfull \hbox (18.74283pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 a Channel) will not include the coordinate transformation funct ion which it uses, Overfull \hbox (7.19565pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 so will only refer to the function by its name (as assigned usi ng astIntraReg). Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 Consequently, the external representation cannot be utilised by another program Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 unless that program has also registered the same transformation function with Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the same name using an identical invocation of astIntraReg. If no such registration Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 has been performed, then attempting to read the external repres entation will result Overfull \hbox (16.11847pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 You may use astIntraReg to register a transformation functi on with the same name Overfull \hbox (21.36719pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 more than once, but only if the arguments supplied are identica l on each occasion Overfull \hbox (57.58334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 (i.e there is no way of changing things once a function has bee n successfully registered Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 under a given name, and attempting to do so will result in an e rror). This feature Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 simply allows registration to be performed independently, but c onsistently, at Overfull \hbox (26.35347pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 several places within your program, without having to check whe ther it has already Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 If an error occurs in the transformation function, this may be indicated by setting Overfull \hbox (1.94693pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the AST error status to an error value (using []astSetStatus[]) before it returns. Overfull \hbox (47.34834pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 This will immediately terminate the current AST operation. The error value AST__ITFER Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 is available for this purpose, but other values may also be use d (e.g. if you Overfull \hbox (18.0096pt too wide) in paragraph at lines 19183--19183 []\T1/cmtt/m/n/10 The following flags are defined in the ``ast.h' ' header file and allow you to provide Overfull \hbox (18.27203pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 further information about the nature of the transformation func tion. Having selected Overfull \hbox (18.27203pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 the set of flags which apply, you should supply the bitwise OR of their values as the Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__NOFWD: If this flag is set, it indicates that the tran sformation function Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 does not implement a forward coordinate transformation. In this case, any IntraMap Overfull \hbox (36.8509pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses it will have a []TranForward[] attribute value of ze ro and the transformation Overfull \hbox (31.86462pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function itself will not be invoked with its ``forward' ' argum ent set to a non-zero Overfull \hbox (5.62103pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__NOINV: If this flag is set, it indicates that the tran sformation function Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 does not implement an inverse coordinate transformation. In thi s case, any IntraMap Overfull \hbox (36.8509pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 which uses it will have a []TranInverse[] attribute value of ze ro and the transformation Overfull \hbox (1.94693pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 function itself will not be invoked with its ``forward' ' argum ent set to zero. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__SIMPFI: You may set this flag if applying the transfor mation function' s Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 transformation, should always restore the original set of coord inates. It indicates Overfull \hbox (41.31232pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 that AST may replace such a sequence of operations by an identi ty Mapping (a []UnitMap[]) Overfull \hbox (33.43924pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using []astSimplify[]). Overfull \hbox (0.37231pt too wide) in paragraph at lines 19183--19183 [][]\T1/cmtt/m/n/10 AST__SIMPIF: You may set this flag if applying the transfor mation function' s Overfull \hbox (10.86975pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 transformation, should always restore the original set of coord inates. It indicates Overfull \hbox (41.31232pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 that AST may replace such a sequence of operations by an identi ty Mapping (a UnitMap) Overfull \hbox (33.43924pt too wide) in paragraph at lines 19183--19183 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using astSimplify). [324] [325] [326] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19271. Overfull \hbox (3.47949pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 One if the Object belongs to the class called $\OML/zplm/m/it/1 0 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 (or to a class d erived from Underfull \hbox (badness 10000) in paragraph at lines 19271--19271 Underfull \hbox (badness 10000) in paragraph at lines 19271--19271 [] \T1/cmtt/m/n/10 Tests whether Object " obj" is a member of the []Frame[] cla ss, or of any class Overfull \hbox (23.27441pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 Every AST class provides a function (astIsA$\OML/zplm/m/it/ 10 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ) of this form, where $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Class$\OML/zplm/m/it/10 >$ Overfull \hbox (8.24539pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Overfull \hbox (21.36719pt too wide) in paragraph at lines 19271--19271 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function should fa il for any reason. In Overfull \hbox (10.86975pt too wide) in paragraph at lines 19271--19271 \T1/cmtt/m/n/10 particular, it will fail if the pointer supplied does not ident ify an Object of [327] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ke yMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19346--19346 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 19346--19346 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 19346--19346 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 19346--19346 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [328] Overfull \hbox (18.90558pt too wide) in paragraph at lines 19456--19456 []\T1/cmtt/m/n/10 int astLinearApprox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmt t/m/n/10 this, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 lbnd, const d ouble $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ubnd, double Overfull \hbox (26.6159pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the lower bounds of a box defined within Overfull \hbox (21.10475pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the input coordinate system of the Mapping. The number of eleme nts in this array Overfull \hbox (15.85603pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 should equal the value of the Mapping' s []Nin[] attribute. Thi s box should specify Overfull \hbox (16.11847pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 [] \T1/cmtt/m/n/10 The maximum permitted deviation from linearity, expressed as a positive Cartesian Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 displacement in the output coordinate space of the Mapping. If a linear fit to Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the forward transformation of the Mapping deviates from the tru e transformation Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 by more than this amount at any point which is tested, then no fit coefficients Overfull \hbox (21.10475pt too wide) in paragraph at lines 19456--19456 [] \T1/cmtt/m/n/10 Pointer to an array of doubles in which to return the co- efficients of the linear Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 approximation to the specified transformation. This array shoul d have at least Overfull \hbox (40.42569pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 " ( Nin $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 1 ) $\OMS/zplm/m/n /10 ^^C$ []\T1/cmtt/m/n/10 Nout[]" , elements. The first Nout elements hold the constant offsets Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 for the transformation outputs. The remaining elements hold the gradients. So Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 if the Mapping has 2 inputs and 3 outputs the linear approximat ion to the forward Overfull \hbox (4.1005pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 If the forward transformation is sufficiently linear, a non-zer o value is returned. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 This function fits the Mapping' s forward transformation. T o fit the inverse Overfull \hbox (5.62103pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using []astInver t[] before invoking Overfull \hbox (0.37231pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 If a Mapping output is found to have a bad value (AST__BAD) at one or more of Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the test points used in the linearity test, then all the values in the returned Overfull \hbox (5.62103pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 fit that correspond to that output are set to AST__BAD. However , this does not Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 affect the linearity tests on the other Mapping outputs - if th ey are all found Overfull \hbox (10.86975pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 to be linear then usable coefficients will be returned for them in the fit, and Overfull \hbox (0.10988pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 the function will return a non-zero value. Consequently, it may be necessary Overfull \hbox (12.44437pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 to check that the values in the returned fit are not AST__BAD b efore using them. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19456--19456 \T1/cmtt/m/n/10 If all Mapping outputs generate bad values, then zero is return ed as the function [329] Overfull \hbox (26.35347pt too wide) in paragraph at lines 19456--19456 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [330] Overfull \hbox (21.10475pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 If the Object is curently locked by another thread then this fu nction will either Overfull \hbox (37.11334pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 report an error or block. If a non-zero value is supplied for " wait" , the calling Overfull \hbox (5.3586pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 thread waits until the object is available for it to use. Other wise, an error Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 is reported and the function returns immediately without lockin g the Object. Overfull \hbox (31.86462pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 The []astAnnul[] function is exceptional in that it can be used on pointers for Objects Overfull \hbox (0.37231pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 that are not currently locked by the calling thread. All other AST functions Overfull \hbox (31.86462pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 This function returns without action if the Object is alrea dy locked by the calling Overfull \hbox (26.35347pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 If simultaneous use of the same object is required by two o r more threads, []astCopy[] Overfull \hbox (0.37231pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 should be used to to produce a deep copy of the Object for each thread. Each Overfull \hbox (16.11847pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 copy should then be unlocked by the parent thread (i.e. the thr ead that created Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 the copy), and then locked by the child thread (i.e. the thread that wants to Overfull \hbox (5.62103pt too wide) in paragraph at lines 19534--19534 [][]\T1/cmtt/m/n/10 This function returns without action if the AST library has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 19534--19534 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [331] Overfull \hbox (7.72334pt too wide) in paragraph at lines 19645--19645 []\T1/cmtt/m/n/10 AstLutMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astLutMap( in t nlut, const double lut[], double start, double inc, const Overfull \hbox (36.8509pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 The lookup table spacing (the increment in input coordinate val ue between successive Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 lookup table entries). This value may be positive or negative, but must not be Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Lu tMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 19645--19645 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (26.6159pt too wide) in paragraph at lines 19645--19645 [][]\T1/cmtt/m/n/10 If the entries in the lookup table either increase or decre ase monotonically, then Overfull \hbox (21.36719pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the new LutMap' s []TranInverse[] attribute will have a value o f one, indicating that Overfull \hbox (0.37231pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the inverse transformation can be performed. Otherwise, it will have a value Overfull \hbox (0.37231pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 of zero, so that any attempt to use the inverse transformation will result in [332] Overfull \hbox (5.62103pt too wide) in paragraph at lines 19645--19645 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 19645--19645 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 19645--19645 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [333] Overfull \hbox (18.22078pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 void astMapBox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, const double lbnd_in[], const double ubnd_in[], int Overfull \hbox (13.44568pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 forward, int coord_out, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 lbnd_out, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ubnd_out, double x l[], double xu[] Overfull \hbox (22.9418pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to an array of double, with one element for each Mappin g input coordinate. Overfull \hbox (22.9418pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to an array of double, with one element for each Mappin g input coordinate. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 Note that it is permissible for the upper bound to be less th an the corresponding Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 If this value is non-zero, then the Mapping' s forward transfor mation will be Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 used to transform the input box. Otherwise, its inverse transfo rmation will be Overfull \hbox (41.83719pt too wide) in paragraph at lines 19788--19788 []\T1/cmtt/m/n/10 (If the inverse transformation is selected, then references t o " input" and " output" Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinates in this description should be transposed. For examp le, the size of Overfull \hbox (29.24026pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 the " lbnd_in" and " ubnd_in" arrays should match the number of output coordinates, Overfull \hbox (23.99155pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 as given by the Mapping' s []Nout[] attribute. Similarly, the " coord_out" parameter, Overfull \hbox (38.42552pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 The index of the output coordinate for which the lower and uppe r bounds are required. Overfull \hbox (26.35347pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 This value should be at least one, and no larger than the numbe r of Mapping output Overfull \hbox (5.62103pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to a double in which to return the lowest value taken b y the nominated Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 [] \T1/cmtt/m/n/10 An optional pointer to an array of double, with one eleme nt for each Mapping input Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinate. If given, this array will be filled with the coordi nates of an input Overfull \hbox (52.8595pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [334] Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 [] \T1/cmtt/m/n/10 An optional pointer to an array of double, with one eleme nt for each Mapping input Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 coordinate. If given, this array will be filled with the coordi nates of an input Overfull \hbox (52.8595pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate Overfull \hbox (16.11847pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 Any input points which are transformed by the Mapping to gi ve output coordinates Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 containing the value AST__BAD are regarded as invalid and are i gnored. They will Overfull \hbox (26.6159pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 make no contribution to determining the output bounds, even alt hough the nominated Overfull \hbox (2.99667pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 An error will occur if the required output bounds cannot be found. Typically, Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 this might happen if all the input points which the function co nsiders turn out Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 to be invalid (see above). The number of points considered befo re generating Overfull \hbox (0.37231pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 such an error is quite large, so this is unlikely to occur by a ccident unless Overfull \hbox (17.43065pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 valid points are restricted to a very small subset of the input coordinate space. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19788--19788 [][]\T1/cmtt/m/n/10 The values returned via " lbnd_out" , " ubnd_out" , " xl" a nd " xu" will be set Overfull \hbox (21.36719pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 to the value AST__BAD if this function should fail for any reas on. Their initial Overfull \hbox (20.84232pt too wide) in paragraph at lines 19788--19788 \T1/cmtt/m/n/10 values on entry will not be altered if the function is invoked with the AST error [335] Overfull \hbox (31.86462pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 Entries from the source KeyMap will replace any existing en tries in the destination Overfull \hbox (10.60732pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 The one exception to the above rule is that if a source ent ry contains a scalar Overfull \hbox (5.62103pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 KeyMap entry, and the destination contains a scalar KeyMap entr y with the same Overfull \hbox (26.35347pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 key, then the source KeyMap entry will be copied into the desti nation KeyMap entry Overfull \hbox (7.19565pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 using this function, rather than simply replacing the destinati on KeyMap entry. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19834--19834 [][]\T1/cmtt/m/n/10 If the destination entry has a non-zero value for its []Map Locked[] attribute, then Overfull \hbox (36.8509pt too wide) in paragraph at lines 19834--19834 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [336] Overfull \hbox (15.85603pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (7.51216pt too wide) in paragraph at lines 19872--19872 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name is prese nt in the KeyMap and [337] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 19999. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (10.60732pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 A pointer to a buffer in which to return the requested value. I f the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see []astMapPutU[]), Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (29.24026pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 exit. For pointer types (" A" and " C" ), the buffer should be a suitable pointer, Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 and the address of this pointer should be supplied as the " val ue" parameter. Overfull \hbox (7.51216pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (0.10988pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied buffer Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 If the stored value is a vector value, then the first value in the vector will Overfull \hbox (5.62103pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 A string pointer returned by astMapGet0C is guaranteed to r emain valid and the Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 string to which it points will not be over-written for a total of 50 successive Overfull \hbox (10.60732pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 invocations of this function. After this, the memory containing the string may Overfull \hbox (0.10988pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 be re-used, so a copy of the string should be made if it is nee ded for longer Overfull \hbox (5.3586pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 [][]\T1/cmtt/m/n/10 If the returned value is an AST []Object[] pointer, the Obj ect' s reference count Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 is incremented by this call. Any subsequent changes made to the Object using Overfull \hbox (10.86975pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 the returned pointer will be reflected in any any other active pointers for the Overfull \hbox (0.37231pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 Object. The returned pointer should be annulled using []astAnnu l[] when it is no [338] Overfull \hbox (8.46577pt too wide) in paragraph at lines 19999--19999 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 name astMapGet0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (2.52588pt too wide) in paragraph at lines 19999--19999 \T1/cmtt/m/n/10 For example, astMapGet0D would be used to get a " double" value , while astMapGet0I [339] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20143. Overfull \hbox (15.56409pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 int astMapGet1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zpl m/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int mxval, int $\OMS /zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nval, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\ OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type Overfull \hbox (32.23856pt too wide) in paragraph at lines 20143--20143 \OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value ) int astMapGet1C( AstKeyMap $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 key, int l, int mxval, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nval, Overfull \hbox (15.85603pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (5.3586pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the Overfull \hbox (15.85603pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 A pointer to an array in which to return the requested values. If the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see []astMapPutU[]), Overfull \hbox (5.62103pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (7.51216pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20143--20143 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (21.36719pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied array will Overfull \hbox (0.37231pt too wide) in paragraph at lines 20143--20143 [][]\T1/cmtt/m/n/10 If the stored value is a scalar value, then the value will be returned in the Overfull \hbox (49.23947pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 The " value" buffer supplied to the astMapGet1C function shou ld be a pointer to a character Overfull \hbox (2.73706pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 array with " mxval$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l" elem ents, where " l" is the maximum length of a string to be Overfull \hbox (23.52075pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 returned. The value of " l" should be supplied as an extra para meter following " key" Overfull \hbox (14.3355pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 when invoking astMapGet1C, and should include space for a termi nating null character. [340] Overfull \hbox (8.46577pt too wide) in paragraph at lines 20143--20143 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 name astMapGet1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (28.76947pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 For example, astMapGet1D would be used to get " double" values, while astMapGet1I would Overfull \hbox (23.52075pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 be used to get " int" values, etc. For D or I, the supplied " v alue" parameter should Overfull \hbox (39.2669pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 be a pointer to an array of doubles or ints, with " mxval" elem ents. For C, the supplied Overfull \hbox (20.05783pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 " value" parameter should be a pointer to a character string wi th " mxval$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l" elements. Overfull \hbox (7.7746pt too wide) in paragraph at lines 20143--20143 \T1/cmtt/m/n/10 For A, the supplied " value" parameter should be a pointer to a n array of AstObject [341] Overfull \hbox (15.85603pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (36.8509pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 Address at which to return a pointer to the required string val ue. If the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see []astMapPutU[]), Overfull \hbox (7.51216pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20213--20213 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (0.10988pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 but a zero value will be returned as the function value. The su pplied buffer Overfull \hbox (10.86975pt too wide) in paragraph at lines 20213--20213 [][]\T1/cmtt/m/n/10 The string pointer returned by astMapGetC is guaranteed to remain valid and the Overfull \hbox (10.86975pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 string to which it points will not be over-written for a total of 50 successive Overfull \hbox (10.60732pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 invocations of this function. After this, the memory containing the string may Overfull \hbox (0.10988pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 be re-used, so a copy of the string should be made if it is nee ded for longer Overfull \hbox (5.3586pt too wide) in paragraph at lines 20213--20213 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer [342] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20344. Overfull \hbox (5.06665pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 int astMapGetElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/ zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int elem, $\OML/z plm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type $\OMS/ zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value Overfull \hbox (13.65686pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 ) int astMapGetElemC( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int l, int e lem, char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 value Overfull \hbox (15.85603pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (0.10988pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 The index of the required vector element, starting at zero. An error will be Overfull \hbox (10.60732pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 A pointer to a buffer in which to return the requested value. I f the requested Overfull \hbox (13.49411pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 key is not found, or if it is found but has an undefined value (see []astMapPutU[]), Overfull \hbox (5.62103pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 then the contents of the buffer on entry to this function will be unchanged on Overfull \hbox (7.51216pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name was foun d, and does not have Overfull \hbox (2.99667pt too wide) in paragraph at lines 20344--20344 [][]\T1/cmtt/m/n/10 No error is reported if the requested key cannot be found i n the given KeyMap, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 or if it has an undefined value, but a zero value will be retur ned as the function Overfull \hbox (2.26344pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 The " value" buffer supplied to the astMapGetElemC function s hould be a pointer to Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 a character array with " l" elements, where " l" is the maximum length of the string Overfull \hbox (18.27203pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 to be returned. The value of " l" should be supplied as an extr a parameter following Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 " key" when invoking astMapGetElemC, and should include space f or a terminating null Overfull \hbox (8.46577pt too wide) in paragraph at lines 20344--20344 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (24.47437pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 name astMapGetElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to matc h the data type [343] Overfull \hbox (34.01819pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 For example, astMapGetElemD would be used to get a " double" va lue, while astMapGetElemI Overfull \hbox (28.2446pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 would be used to get an " int" value, etc. For D or I, the supp lied " value" parameter Overfull \hbox (23.52075pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 should be a pointer to a double or int. For C, the supplied " v alue" parameter should Overfull \hbox (13.02332pt too wide) in paragraph at lines 20344--20344 \T1/cmtt/m/n/10 be a pointer to a character string with " l" elements. For A, t he supplied " value" [344] Overfull \hbox (12.18193pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e []KeyCase[] attribute Overfull \hbox (26.6159pt too wide) in paragraph at lines 20396--20396 [][]\T1/cmtt/m/n/10 A non-zero function value is returned if the key exists but has an undefined value Overfull \hbox (10.34488pt too wide) in paragraph at lines 20396--20396 \T1/cmtt/m/n/10 (that is, the returned value does not depend on whether the ent ry has a defined Overfull \hbox (5.3586pt too wide) in paragraph at lines 20396--20396 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [345] Overfull \hbox (26.09103pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 The index into the KeyMap. The first entry has index zero, and the last has index Overfull \hbox (0.37231pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 " size-1" , where " size" is the value returned by the astMapSi ze function. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20456--20456 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 20456--20456 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 20456--20456 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [346] Overfull \hbox (12.18193pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e []KeyCase[] attribute Overfull \hbox (23.25832pt too wide) in paragraph at lines 20508--20508 \T1/cmtt/m/n/10 The length (i.e. number of characters) of the longest formatted value associated with Overfull \hbox (21.36719pt too wide) in paragraph at lines 20508--20508 [][]\T1/cmtt/m/n/10 A function value of zero will be returned without error if the named entry cannot Overfull \hbox (5.3586pt too wide) in paragraph at lines 20508--20508 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [347] Overfull \hbox (12.18193pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e []KeyCase[] attribute Overfull \hbox (7.51216pt too wide) in paragraph at lines 20553--20553 \T1/cmtt/m/n/10 The length of the entry. One for a scalar, greater than one for a vector. A value Overfull \hbox (5.3586pt too wide) in paragraph at lines 20553--20553 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [348] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20663. Overfull \hbox (46.79396pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 void astMapPut0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 comment Overfull \hbox (31.33975pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 A character string to be stored with the value, which can later be used to identify Overfull \hbox (0.37231pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 the value. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (20.84232pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 The value to be stored. The data type of this value should matc h the 1-character Overfull \hbox (16.11847pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 type code appended to the function name (e.g. if you are using astMapPut0A, the Overfull \hbox (26.09103pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the value. A NULL Overfull \hbox (10.86975pt too wide) in paragraph at lines 20663--20663 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the ne w value will replace Overfull \hbox (5.62103pt too wide) in paragraph at lines 20663--20663 [][]\T1/cmtt/m/n/10 If the stored value is an AST []Object[] pointer, the Objec t' s reference count is Overfull \hbox (5.62103pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 incremented by this call. Any subsequent changes made to the Ob ject using the Overfull \hbox (29.24026pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 returned pointer will be reflected in any any other active poin ters for the Object, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 including any obtained later using astMapget0A. The reference c ount for the Object Overfull \hbox (63.0945pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 will be decremented when the KeyMap is destroyed, or the entry is removed or over-written Overfull \hbox (8.46577pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 name astMapPut0$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type [349] Overfull \hbox (13.02332pt too wide) in paragraph at lines 20663--20663 \T1/cmtt/m/n/10 For example, astMapPut0D would be used to store a " double" val ue, while astMapPut0I Overfull \hbox (7.98578pt too wide) in paragraph at lines 20663--20663 []\T1/cmtt/m/n/10 Note that KeyMaps containing generic " void $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " pointers cannot be written out using [350] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20767. Overfull \hbox (33.46098pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 void astMapPut1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int size, const $\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type va lue[], Overfull \hbox (36.58847pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 A character string to be stored with the values, which can late r be used to identify Overfull \hbox (5.62103pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 the values. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (10.60732pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 The array of values to be stored. The data type of this value s hould match the Overfull \hbox (55.22142pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 1-character type code appended to the function name (e.g. if yo u are using astMapPut1A, Overfull \hbox (5.09616pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the values. A Overfull \hbox (16.11847pt too wide) in paragraph at lines 20767--20767 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the ne w values will replace Overfull \hbox (8.46577pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (8.72821pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 name astMapPut1$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to match t he data type Overfull \hbox (7.7746pt too wide) in paragraph at lines 20767--20767 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I Overfull \hbox (7.98578pt too wide) in paragraph at lines 20767--20767 []\T1/cmtt/m/n/10 Note that KeyMaps containing generic " void $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " pointers cannot be written out using [351] [352] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20892. Overfull \hbox (4.59303pt too wide) in paragraph at lines 20892--20892 []\T1/cmtt/m/n/10 void astMapPutElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML /zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 key, int elem, $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value Overfull \hbox (15.85603pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (23.52075pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 If the " elem" index is outside the range of the vector, the le ngth of the vector will Overfull \hbox (7.7746pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 be increased by one element and the supplied value will be stor ed at the end of the Overfull \hbox (4.1005pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 If the " elem" index is outside the range of the vector, an err or will be reported. Overfull \hbox (28.50703pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 The number of elements in each cell of a column is specified wh en the column is created Overfull \hbox (5.3586pt too wide) in paragraph at lines 20892--20892 [][]\T1/cmtt/m/n/10 If the entry originally holds a scalar value, it will be tr eated like a vector Overfull \hbox (0.37231pt too wide) in paragraph at lines 20892--20892 [][]\T1/cmtt/m/n/10 If the specified key cannot be found in the given KeyMap, o r is found but has Overfull \hbox (21.36719pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 an undefined value, a new vector entry with the given name, and data type implied Overfull \hbox (8.46577pt too wide) in paragraph at lines 20892--20892 []\T1/cmtt/m/n/10 To select the appropriate function, you should replace $\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the ge neric function Overfull \hbox (24.47437pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 name astMapPutElem$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1-character data type code, so as to matc h the data type [353] Overfull \hbox (34.01819pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 For example, astMapPutElemD would be used to put a " double" va lue, while astMapPutElemI Overfull \hbox (28.2446pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 would be used to put an " int" value, etc. For D or I, the supp lied " value" parameter Overfull \hbox (23.25832pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 should be a double or int. For C, the supplied " value" paramet er should be a pointer Overfull \hbox (18.27203pt too wide) in paragraph at lines 20892--20892 \T1/cmtt/m/n/10 to a character string. For A, the supplied " value" parameter s hould be an AstObject [354] Overfull \hbox (31.33975pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 A character string to be stored with the value, which can later be used to identify Overfull \hbox (0.37231pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 the value. Trailing spaces are ignored. The supplied string is converted to Overfull \hbox (26.09103pt too wide) in paragraph at lines 20942--20942 \T1/cmtt/m/n/10 A pointer to a null-terminated comment string to be stored with the value. A NULL Overfull \hbox (5.62103pt too wide) in paragraph at lines 20942--20942 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the va lue associated with [355] Overfull \hbox (47.61078pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Pointer to a Mapping which transforms positions from the coordi nate system represented Overfull \hbox (42.36206pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 by the supplied Region to the coordinate system specified by " frame" . The supplied Overfull \hbox (63.35693pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Mapping should define both forward and inverse transformations, and these transformations Overfull \hbox (10.86975pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 should form a genuine inverse pair. That is, transforming a pos ition using the Overfull \hbox (10.86975pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 forward transformation and then using the inverse transformatio n should produce Overfull \hbox (41.31232pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 the original input position. Some Mapping classes (such as []Pe rmMap[], []MathMap[], []SphMap[]) Overfull \hbox (5.62103pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 Pointer to a []Frame[] describing the coordinate system in whic h the new Region is Overfull \hbox (18.0096pt too wide) in paragraph at lines 21010--21010 \T1/cmtt/m/n/10 A pointer to a new Region. This Region will represent the area within the coordinate Overfull \hbox (26.6159pt too wide) in paragraph at lines 21010--21010 [][]\T1/cmtt/m/n/10 The uncertainty associated with the supplied Region is modi fied using the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 21010--21010 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [356] Overfull \hbox (15.85603pt too wide) in paragraph at lines 21039--21039 \T1/cmtt/m/n/10 The character string identifying the value to be retrieved. Tra iling spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 21039--21039 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] [357] Overfull \hbox (5.3586pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 The character string identifying the entry to be renamed. Trail ing spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (10.60732pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 The new character string to associated with the renamed entry. Trailing spaces Overfull \hbox (5.62103pt too wide) in paragraph at lines 21076--21076 \T1/cmtt/m/n/10 are ignored. The supplied string is converted to upper case bef ore use if the [358] Overfull \hbox (5.3586pt too wide) in paragraph at lines 21110--21110 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [359] Overfull \hbox (24.31422pt too wide) in paragraph at lines 21193--21193 []\T1/cmtt/m/n/10 void astMapSplit( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int nin, const int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 in, int $\ OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 out, AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$ \T1/cmtt/m/n/10 map Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 [] \T1/cmtt/m/n/10 Pointer to an array holding the indices within the suppli ed Mapping of the inputs Overfull \hbox (17.43065pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 which are to be picked from the Mapping. This array should have " nin" elements. Overfull \hbox (31.86462pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 If " []Nin[]" is the number of inputs of the supplied Mapping, then each element should Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Pointer to an array in which to return the indices of the outpu ts of the supplied Overfull \hbox (10.86975pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Mapping which are fed by the picked inputs. A value of one is u sed to refer to Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 the first Mapping output. The supplied array should have a leng th at least equal Overfull \hbox (5.62103pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 to the number of outputs in the supplied Mapping. The number of values stored Overfull \hbox (1.94693pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 in the array on exit will equal the number of outputs in the re turned Mapping. Overfull \hbox (31.60219pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 The i' th element in the returned array holds the index within the supplied Mapping Overfull \hbox (21.10475pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Address of a location at which to return a pointer to the retur ned Mapping. This Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 Mapping will have " nin" inputs (the number of outputs may be d ifferent to " nin" Overfull \hbox (26.6159pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 ). NULL is returned if the supplied Mapping has no subset of ou tputs which depend Overfull \hbox (21.36719pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 only on the selected inputs. The returned Mapping is a deep cop y of the required Overfull \hbox (0.37231pt too wide) in paragraph at lines 21193--21193 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t, or if it should Overfull \hbox (7.19565pt too wide) in paragraph at lines 21193--21193 \T1/cmtt/m/n/10 fail for any reason, then a NULL value will be returned for the " map" pointer. [360] Overfull \hbox (12.18193pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 The character string identifying the KeyMap entry. Trailing spa ces are ignored. Overfull \hbox (26.35347pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 The supplied string is converted to upper case before use if th e []KeyCase[] attribute Overfull \hbox (12.76088pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__BYTETYPE (for Overfull \hbox (79.10309pt too wide) in paragraph at lines 21252--21252 [][]\T1/cmtt/m/n/10 i.e. unsigned chars ) AST__DOUBLETYPE (for double precision floating point), AST__FLOATTYPE Overfull \hbox (2.4718pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 (for single precision floating point), AST__STRINGTYPE (for cha racter string), Overfull \hbox (35.80116pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 AST__OBJECTTYPE (for AST []Object[] pointer), AST__POINTERTYPE (for arbitrary C pointer) Overfull \hbox (10.86975pt too wide) in paragraph at lines 21252--21252 \T1/cmtt/m/n/10 or AST__UNDEFTYPE (for undefined values created by []astMapPutU []). AST__BADTYPE is Overfull \hbox (29.24026pt too wide) in paragraph at lines 21252--21252 [][]\T1/cmtt/m/n/10 A function value of AST__BADTYPE will be returned if an err or has already occurred, [361] Overfull \hbox (13.18324pt too wide) in paragraph at lines 21338--21338 []\T1/cmtt/m/n/10 void astMark( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, int nmark, int ncoord, int indim, const double $\OMS/zplm/m/n/10 ^^C$\T1/c mtt/m/n/10 in, int Overfull \hbox (10.60732pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of markers to draw. This may be zero, in which case nothing will be Overfull \hbox (15.85603pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of coordinates being supplied for each mark (i.e. th e number of axes Overfull \hbox (36.8509pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (5.62103pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 the marker coordinates). This value is required so that the coo rdinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 21338--21338 [] \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of shape " [ncoord][indim]" Overfull \hbox (31.86462pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 giving the physical coordinates of the points where markers are to be drawn. These Overfull \hbox (21.10475pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 should be stored such that the value of coordinate number " coo rd" for input mark Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 A value specifying the type (e.g. shape) of marker to be drawn. The set of values Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 which may be used (and the shapes that will result) is determin ed by the underlying Overfull \hbox (10.86975pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 Markers are not drawn at positions which have any coordinat e equal to the value Overfull \hbox (31.60219pt too wide) in paragraph at lines 21338--21338 \T1/cmtt/m/n/10 AST__BAD (or where the transformation into graphical coordinate s yields coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 If any marker position is clipped (see []astClip[]), then t he entire marker is not Overfull \hbox (10.86975pt too wide) in paragraph at lines 21338--21338 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [362] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21538. Overfull \hbox (3.90186pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 int astMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m /it/10 >$\T1/cmtt/m/n/10 ( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this , AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, int inside, int ndim, c onst int Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to a []Mapping[]. The forward transformation should map positions in the Overfull \hbox (0.10988pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 coordinate system of the supplied Region into pixel coordinates as defined by Overfull \hbox (42.36206pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the " lbnd" and " ubnd" parameters. A NULL pointer can be suppl ied if the coordinate Overfull \hbox (31.86462pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 system of the supplied Region corresponds to pixel coordinates. This is equivalent Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 The number of inputs for this Mapping (as given by its []Nin[ ] attribute) should match Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the number of axes in the supplied Region (as given by the []Na xes[] attribute of Overfull \hbox (36.0636pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the Region). The number of outputs for the Mapping (as given by its []Nout[] attribute) Overfull \hbox (7.19565pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 should match the number of grid dimensions given by the value o f " ndim" below. Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 A boolean value which indicates which pixel are to be masked. I f a non-zero value Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 is supplied, then all grid pixels with centres inside the suppl ied Region are Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 assigned the value given by " val" , and all other pixels are l eft unchanged. If Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 zero is supplied, then all grid pixels with centres not inside the supplied Region Overfull \hbox (17.69308pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 are assigned the value given by " val" , and all other pixels a re left unchanged. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Note, the []Negated[] attribute of the Region is used to determ ine which pixel are Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 inside the Region and which are outside. So the inside of a Reg ion which has Overfull \hbox (12.44437pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 not been negated is the same as the outside of the correspondin g negated Region. Overfull \hbox (16.11847pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 For types of Region such as []PointList[] which have zero vol ume, pixel centres will Overfull \hbox (16.11847pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 rarely fall exactly within the Region. For this reason, the inc lusion criterion Overfull \hbox (10.86975pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 is changed for zero-volume Regions so that pixels are included (or excluded) if Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 any part of the Region passes through the pixel. For a PointLis t, this means Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 that pixels are included (or excluded) if they contain at least one of the points Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates [363] Overfull \hbox (0.37231pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 21538--21538 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (10.60732pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 the data to be masked. The numerical type of this array should match the 1- or Overfull \hbox (39.7377pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 2-character type code appended to the function name (e.g. if yo u are using astMaskF, Overfull \hbox (15.85603pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (21.36719pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 On exit, the samples specified by " inside" are set to the va lue of " val" . All Overfull \hbox (10.60732pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.35347pt too wide) in paragraph at lines 21538--21538 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (5.62103pt too wide) in paragraph at lines 21538--21538 [][]\T1/cmtt/m/n/10 An error will be reported if the overlap of the Region and the array cannot be Overfull \hbox (3.21706pt too wide) in paragraph at lines 21538--21538 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 function name astMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OM L/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so a s to match the Overfull \hbox (7.7746pt too wide) in paragraph at lines 21538--21538 \T1/cmtt/m/n/10 For example, astMaskD would be used to process " double" data, while astMaskS would [364] Overfull \hbox (5.62103pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 Pointer to an integer array in which to return the indices of t he axes (within Overfull \hbox (37.11334pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 the first Frame) that correspond to each axis within the second Frame. []Axis[] indices Overfull \hbox (10.86975pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 start at 1. A value of zero will be stored in the returned arra y for each axis Overfull \hbox (15.5936pt too wide) in paragraph at lines 21600--21600 []\T1/cmtt/m/n/10 The number of elements in this array must be greater than or equal to the number Overfull \hbox (21.36719pt too wide) in paragraph at lines 21600--21600 [][]\T1/cmtt/m/n/10 Corresponding axes are identified by the fact that a []Mapp ing[] can be found between Overfull \hbox (52.59706pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 them using []astFindFrame[] or []astConvert[]. Thus, " correspo nding axes" are not necessarily Overfull \hbox (0.10988pt too wide) in paragraph at lines 21600--21600 \T1/cmtt/m/n/10 identical. For instance, []SkyFrame[] axes in two Frames will m atch even if they [365] Overfull \hbox (28.9294pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 AstMathMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMathMap( int nin, int nout, int nfwd, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 f wd[], int ninv, const Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Number of input variables for the MathMap. This determines the value of its []Nin[] Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Number of output variables for the MathMap. This determines the value of its Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 The number of forward transformation functions being supplied. This must be at Overfull \hbox (52.8595pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 least equal to " nout" , but may be increased to accommodate an y additional expressions Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which define intermediate variables for the forward transformat ion (see the " Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 An array (with " nfwd" elements) of pointers to null terminated strings which Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 contain the expressions defining the forward transformation. Th e syntax of these Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 The number of inverse transformation functions being supplied. This must be at Overfull \hbox (47.61078pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 least equal to " nin" , but may be increased to accommodate any additional expressions Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which define intermediate variables for the inverse transformat ion (see the " Overfull \hbox (0.10988pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 An array (with " ninv" elements) of pointers to null terminated strings which Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 contain the expressions defining the inverse transformation. Th e syntax of these Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ma thMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [366] Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 The sequence of numbers produced by the random number funct ions available within Overfull \hbox (26.6159pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 a MathMap is normally unpredictable and different for each Math Map. However, this Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 Normally, compound Mappings (CmpMaps) which involve MathMap s will not be subject Overfull \hbox (21.36719pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 to simplification (e.g. using []astSimplify[]) because AST cann ot know how different Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 MathMaps will interact. However, in the special case where a Ma thMap occurs in Overfull \hbox (63.35693pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 series with its own inverse, then simplification may be possibl e. Whether simplification Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 does, in fact, occur under these circumstances is controlled by the MathMap' s Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (22.99588pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 A MathMap' s transformation functions are supplied as a set o f expressions in an array Overfull \hbox (7.51216pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of character strings. Normally you would supply the same number of expressions for Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 the forward transformation, via the " fwd" parameter, as there are output variables Overfull \hbox (9.87408pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 (given by the MathMap' s Nout attribute). For instance, if Nout is 2 you might use: Overfull \hbox (33.75575pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which defines a transformation from Cartesian to polar coordina tes. Here, the variables Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 that appear on the left of each expression (" r" and " theta" ) provide names for the Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 output variables and those that appear on the right (" x" and " y" ) are references Overfull \hbox (7.51216pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 To complement this, you must also supply expressions for the inverse transformation Overfull \hbox (28.2446pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 via the " inv" parameter. In this case, the number of expressio ns given would normally Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 match the number of MathMap input coordinates (given by the Nin attribute). If Nin Overfull \hbox (2.26344pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 which expresses the transformation from polar to Cartesian coor dinates. Note that Overfull \hbox (5.15024pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 here the input variables (" x" and " y" ) are named on the left of each expression, Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Normally, you cannot refer to a variable on the right of an e xpression unless it is Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 named on the left of an expression in the complementary set of functions. Therefore Overfull \hbox (39.2669pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 both sets of functions (forward and inverse) must be formulated using the same consistent Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 set of variable names. This means that if you wish to leave one of the transformations Overfull \hbox (18.0096pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 undefined, you must supply dummy expressions which simply name each of the output (or [367] Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 for the inverse transformation above, which serves to name the input variables but Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 It is sometimes useful to calculate intermediate values and t hen to use these in the Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 final expressions for the output (or input) variables. This may be done by supplying Overfull \hbox (2.26344pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 additional expressions for the forward (or inverse) transformat ion functions. For Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 instance, the following array of five expressions describes 2-d imensional pin-cushion Overfull \hbox (1.47614pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Here, we first calculate three intermediate results (" r" , " r out" and " theta" ) Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 and then use these to calculate the final results (" xout" and " yout" ). The MathMap Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 knows that only the final two results constitute values for the output variables because Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 its Nout attribute is set to 2. You may define as many intermed iate variables in this Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 way as you choose. Having defined a variable, you may then refe r to it on the right Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Note that when defining the inverse transformation you may on ly refer to the output Overfull \hbox (28.50703pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 variables " xout" and " yout" . The intermediate variables " r" , " rout" and " theta" Overfull \hbox (2.001pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 (above) are private to the forward transformation and may not b e referenced by the Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 inverse transformation. The inverse transformation may, however , define its own private Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The expressions given for the forward and inverse transformat ions closely follow the Overfull \hbox (46.09024pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 syntax of the C programming language (with some extensions for compatibility with Fortran). Overfull \hbox (36.38011pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 They may contain references to variables and literal constants, together with arithmetic, Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 boolean, relational and bitwise operators, and function invocat ions. A set of symbolic Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 constants is also available. Each of these is described in deta il below. Parentheses Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 may be used to over-ride the normal order of evaluation. There is no built-in limit Overfull \hbox (49.76434pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 to the length of expressions and they are insensitive to case o r the presence of additional Overfull \hbox (23.25832pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Variable names must begin with an alphabetic character and ma y contain only alphabetic Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 characters, digits, and the underscore character " _" . There i s no built-in limit Overfull \hbox (52.3887pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Literal constants, such as " 0" , " 1" , " 0.007" or " 2.505e -16" may appear in expressions, Overfull \hbox (44.25319pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 with the decimal point and exponent being optional (a " D" may also be used as an exponent Overfull \hbox (25.09537pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 character for compatibility with Fortran). A unary minus " -" m ay be used as a prefix. Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Unless indicated otherwise, if any argument of a function or operator has the value Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 AST__BAD (indicating missing data), then the result of that fun ction or operation is Overfull \hbox (23.52075pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 also AST__BAD, so that such values are propagated automatically through all operations Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 performed by MathMap transformations. The special value AST__BA D can be represented [368] Overfull \hbox (29.46065pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 A $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 result (i.e. equal to AST__BAD) is also produced in response to any numerical Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 error (such as division by zero or numerical overflow), or if a n invalid argument value Overfull \hbox (13.02332pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Boolean values are represented using zero to indicate false a nd non-zero to indicate Overfull \hbox (39.2669pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 true. In addition, the value AST__BAD is taken to mean " unknow n" . The values returned Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 by boolean operators may therefore be 0, 1 or AST__BAD. Where a ppropriate, " tri-state" Overfull \hbox (24.55203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 logic is implemented. For example, " a$\OMS/zplm/m/n/10 j$$j$\T 1/cmtt/m/n/10 b" may evaluate to 1 if " a" is non-zero, even Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 if " b" has the value AST__BAD. This is because the result of t he operation would not Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 && x2: Boolean AND between " x1" and " x2" , returning 1 if both " x1" and Overfull \hbox (7.19565pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 " x2" are non-zero, and 0 otherwise. This operator implements t ri-state logic. Overfull \hbox (1.14116pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OMS/zplm/m/n/10 j$$j$ \T1/cmtt/m/n/10 x2: Boolean OR b etween " x1" and " x2" , returning 1 if either " x1" or Overfull \hbox (7.19565pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 " x2" are non-zero, and 0 otherwise. This operator implements t ri-state logic. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $[]$$[]$ x2: Boolean exclusive OR (XOR) between " x1" an d " x2" , returning 1 if Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 exactly one of " x1" and " x2" is non-zero, and 0 otherwise. Tr i-state logic Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 is not used with this operator. (The synonyms " .neqv." and " . xor." are also Overfull \hbox (51.80975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 provided for compatibility with Fortran, although the second of these is not standard.) Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 .eqv. x2: This is provided only for compatibility with F ortran and tests Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 whether the boolean states of " x1" and " x2" (i.e. true/false) are equal. It Overfull \hbox (16.11847pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 is the negative of the exclusive OR (XOR) function. Tri-state l ogic is not used Overfull \hbox (17.69308pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 ! x: Boolean unary NOT operation, returning 1 if " x" is ze ro, and 0 otherwise. Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Relational operators return the boolean result (0 or 1) of co mparing the values of Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 two floating point values for equality or inequality. The value AST__BAD may also Overfull \hbox (37.11334pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 == x2: Tests whether " x1" equals " x1" . (The synonym " .eq." is also provided Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 != x2: Tests whether " x1" is unequal to " x2" . (The sy nonym " .ne." is [369] Overfull \hbox (8.7222pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 x2: Tests whether " x1" is greater than " x2" . (The synonym " .gt." is Overfull \hbox (19.21964pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 = x2: Tests whether " x1" is greater than or equal to " x2" . (The synonym Overfull \hbox (19.21964pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$ \T1/cmtt/m/n/10 x2: Tests whether " x1" is less than " x2" . (The synonym " .lt." is also Overfull \hbox (3.47348pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 = x2: Tests whether " x1" is less than or equal to " x2" . (The synonym Overfull \hbox (34.9718pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Note that relational operators cannot usefully be used to compa re values with the $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 > $ Overfull \hbox (12.66475pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 value (representing missing data), because the result is always $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 . The isbad() Overfull \hbox (14.3355pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The bitwise operators provided by C are often useful when ope rating on raw data (e.g. Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 from instruments), so they are also provided for use in MathMap expressions. In this Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 case, however, the values on which they operate are floating po int values rather than Overfull \hbox (2.52588pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 pure integers. In order to produce results which match the pure integer case, the Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 operands are regarded as fixed point binary numbers (i.e. with the binary equivalent Overfull \hbox (14.59793pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 of a decimal point) with negative numbers represented using two s-complement notation. Overfull \hbox (7.7746pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 For integer values, the resulting bit pattern corresponds to th at of the equivalent Overfull \hbox (18.27203pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 signed integer (digits to the right of the point being zero). O perations on the bits Overfull \hbox (11.82336pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 >$$>$ \T1/cmtt/m/n/10 x2: Rightward b it shift. The integer value of " x2" is taken (rounding Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 towards zero) and the bits representing " x1" are then shifted this number of Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 places to the right (or to the left if the number of places is negative). This Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OML/zplm/m/it/10 <$$<$ \T1/cmtt/m/n/10 x2: Leftward bi t shift. The integer value of " x2" is taken (rounding Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 towards zero), and the bits representing " x1" are then shifted this number of Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 places to the left (or to the right if the number of places is negative). This Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 & x2: Bitwise AND between the bits of " x1" and those of " x2" (equivalent Overfull \hbox (14.00975pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $\OMS/zplm/m/n/10 j$ \T1/cmtt/m/n/10 x2: Bitwise OR betw een the bits of " x1" and those of " x2" (equivalent to Overfull \hbox (0.37231pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 x1 $[]$ x2: Bitwise exclusive OR (XOR) between the bits of " x1" and those of " Overfull \hbox (31.87064pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 Note that no bit inversion operator (" $\OMS/zplm/m/n/10 ^^X$\T 1/cmtt/m/n/10 " in C) is provided. This is because inverting Overfull \hbox (34.01819pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 the bits of a twos-complement fixed point binary number is equi valent to simply negating Overfull \hbox (12.76088pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 it. This differs from the pure integer case because bits to the right of the binary Overfull \hbox (10.39896pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 point are also inverted. To invert only those bits to the left of the binary point, [370] Overfull \hbox (22.9418pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 ceil(x): Smallest integer value not less then " x" (round t owards plus infinity). Overfull \hbox (12.44437pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 floor(x): Largest integer not greater than " x" (round towa rds minus infinity). Overfull \hbox (1.94693pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 fmod(x1, x2): Remainder when " x1" is divided by " x2" , sa me as mod(x1, x2). Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 gauss(x1, x2): Random sample from a Gaussian distribution w ith mean " x1" and Overfull \hbox (1.94693pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 mod(x1, x2): Remainder when " x1" is divided by " x2" , sam e as fmod(x1, x2). Overfull \hbox (10.86975pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 poisson(x): Random integer-valued sample from a Poisson dis tribution with mean Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 rand(x1, x2): Random sample from a uniform distribution in the range " x1" to Overfull \hbox (17.69308pt too wide) in paragraph at lines 22337--22337 [][]\T1/cmtt/m/n/10 sign(x1, x2): Absolute value of " x1" with the sign of " x2 " (transfer of sign). [371] Overfull \hbox (3.21706pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 The following symbolic constants are available (the enclosing " $\OML/zplm/m/it/10 <$$>$\T1/cmtt/m/n/10 " brackets must Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : The " bad" value (AST__BAD) used to flag missing data. Note that you Overfull \hbox (5.62103pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 cannot usefully compare values with this constant because the r esult is always Overfull \hbox (42.26593pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 dig$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : Number of decimal digits of precision available in a floating point (double ) Overfull \hbox (26.37558pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 epsilon$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Smallest positive number such that 1.0$\OT1/zplm/m/n/10 +$$\OML/zplm/m/ it/10 <$\T1/cmtt/m/n/10 epsilon$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 is disting uishable Overfull \hbox (44.26929pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 mant_dig$\OML/zplm/m/it/10 >$\T1/cmtt/ m/n/10 : The number of base $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zpl m/m/it/10 >$ \T1/cmtt/m/n/10 digits stored in the mantissa of a floating Overfull \hbox (38.06696pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 max_10_exp$\OML/zplm/m/it/10 >$\T1/cmt t/m/n/10 : Maximum integer such that 10 raised to that power can be represented Overfull \hbox (18.0257pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 max_exp$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Maximum integer such that $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 raised to that power minus 1 can Overfull \hbox (32.81824pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/1 0 : Smallest positive number which can be represented as a normalised floating Overfull \hbox (6.57465pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min_10_exp$\OML/zplm/m/it/10 >$\T1/cmt t/m/n/10 : Minimum negative integer such that 10 raised to that power can Overfull \hbox (2.0171pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 min_exp$\OML/zplm/m/it/10 >$\T1/cmtt/m /n/10 : Minimum negative integer such that $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 raised to that power Overfull \hbox (1.32593pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 radix$\OML/zplm/m/it/10 >$\T1/cmtt/m/n /10 : The radix (number base) used to represent the mantissa of floating Overfull \hbox (53.81311pt too wide) in paragraph at lines 22337--22337 [][]$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 rounds$\OML/zplm/m/it/10 >$\T1/cmtt/m/ n/10 : The mode used for rounding floating point results after addition. Possib le Overfull \hbox (10.60732pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 values include: -1 (indeterminate), 0 (toward zero), 1 (to near est), 2 (toward Overfull \hbox (47.61078pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 plus infinity) and 3 (toward minus infinity). Other values indi cate machine-dependent Overfull \hbox (28.76947pt too wide) in paragraph at lines 22337--22337 []\T1/cmtt/m/n/10 Items appearing in expressions are evaluated in the following order (highest precedence [372] Overfull \hbox (26.35948pt too wide) in paragraph at lines 22337--22337 \T1/cmtt/m/n/10 All operators associate from left-to-right, except for unary $\ OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 , unary -, !, .not. and [373] Overfull \hbox (18.22078pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 AstMatrixMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMatrixM ap( int nin, int nout, int form, const double matrix[], const Overfull \hbox (5.3586pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The number of input coordinates, which determines the number of columns in the Overfull \hbox (33.1768pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The number of output coordinates, which determines the number o f rows in the matrix. Overfull \hbox (22.67937pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 An integer which indicates the form in which the matrix element s will be supplied. Overfull \hbox (10.60732pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of zero indicates that a full " nout" x " nin" matrix of values will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 supplied via the " matrix" parameter (below). In this case, the elements should Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 be given in row order (the elements of the first row, followed by the elements Overfull \hbox (44.72398pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of 1 indicates that only the diagonal elements of the matrix will be supplied, Overfull \hbox (31.86462pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 and that all others should be zero. In this case, the elements of " matrix" should Overfull \hbox (21.10475pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 A value of 2 indicates that a " unit" matrix is required, who se diagonal elements Overfull \hbox (0.37231pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 are set to unity (with all other elements zero). In this case, the " matrix" Overfull \hbox (21.10475pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 The array of matrix elements to be used, stored according to th e value of " form" Overfull \hbox (10.86975pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ma trixMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 22458--22458 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 In general, a MatrixMap' s forward transformation will alwa ys be available (as Overfull \hbox (37.11334pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 indicated by its []TranForward[] attribute), but its inverse tr ansformation ([]TranInverse[] Overfull \hbox (43.93668pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 attribute) will only be available if the associated matrix is s quare and non-singular. [374] Overfull \hbox (21.36719pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 As an exception to this, the inverse transformation is alwa ys available if a unit Overfull \hbox (16.11847pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 or diagonal matrix is specified. In this case, if the matrix is not square, one Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 or more of the input coordinate values may not be recoverable f rom a set of output Overfull \hbox (26.6159pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 coordinates. Any coordinates affected in this way will simply b e set to the value Overfull \hbox (5.62103pt too wide) in paragraph at lines 22458--22458 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 22458--22458 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 22458--22458 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [375] Overfull \hbox (21.10475pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 The index of the Frame within the FrameSet which is to be mirro red by the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 Frame. This value should lie in the range from 1 to the number of Frames in the Overfull \hbox (0.10988pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 FrameSet (as given by its []Nframe[] attribute). If AST__NOFRAM E is supplied (or Overfull \hbox (0.37231pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 the current Frame is specified), then any mirroring established by a previous Overfull \hbox (2.99667pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Mirrors can be chained. That is, if Frame B is set to be a mirror of Frame A, Overfull \hbox (10.60732pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 and Frame C is set to be a mirror of Frame B, then Frame C will act as a mirror Overfull \hbox (15.85603pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Variant Mappings cannot be added to the current Frame if it is mirroring another Overfull \hbox (21.36719pt too wide) in paragraph at lines 22531--22531 \T1/cmtt/m/n/10 Frame. So calls to the []astAddVariant[] function will cause an error to be reported Overfull \hbox (21.36719pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 A value of AST__BASE may be given for the " iframe" paramet er to specify the base Overfull \hbox (5.62103pt too wide) in paragraph at lines 22531--22531 [][]\T1/cmtt/m/n/10 Any variant Mappings explicitly added to the current Frame using astAddVariant [376] [377] Overfull \hbox (49.9727pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute). Initially, Overfull \hbox (16.11847pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 this should contain a set of coordinate values representing a p oint in the space Overfull \hbox (5.09616pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 which the Frame describes. If these values lie outside the expe cted range for Overfull \hbox (44.98642pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 the Frame, they will be replaced with more acceptable (normalis ed) values. Otherwise, Overfull \hbox (42.36206pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 For some classes of Frame, whose coordinate values are not constrained, this function Overfull \hbox (15.85603pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 will never modify the values supplied. However, for Frames whos e axes represent Overfull \hbox (47.34834pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 cyclic quantities (such as angles or positions on the sky), coo rdinates will typically Overfull \hbox (0.37231pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 The []NormMap[] class is a []Mapping[] which can be used to normalise a set of points Overfull \hbox (16.11847pt too wide) in paragraph at lines 22611--22611 [][]\T1/cmtt/m/n/10 It is intended to be possible to put any set of coordinates into a form suitable Overfull \hbox (0.37231pt too wide) in paragraph at lines 22611--22611 \T1/cmtt/m/n/10 for display by using this function to normalise them, followed by appropriate [378] Overfull \hbox (17.43065pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 A pointer to the Frame which is to be used to normalise the sup plied axis values. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new No rmMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 22691--22691 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 22691--22691 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 22691--22691 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 22691--22691 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [379] Overfull \hbox (5.73253pt too wide) in paragraph at lines 22776--22776 []\T1/cmtt/m/n/10 AstNullRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astNullRe gion( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, AstRegion $\OMS/zpl m/m/n/10 ^^C$\T1/cmtt/m/n/10 unc, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 options, Overfull \hbox (10.60732pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 A pointer to the []Frame[] in which the region is defined. A de ep copy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (47.34834pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (15.85603pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 with positions in the supplied Frame. The uncertainty in any po int in the Frame Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 is found by shifting the supplied " uncertainty" Region so that it is centred Overfull \hbox (26.6159pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 at the point being considered. The area covered by the shifted uncertainty Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 then represents the uncertainty in the position. The uncertaint y is assumed to Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 are centro-symetric (e.g. []Box[], []Circle[], []Ellipse[], etc .) or be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (36.58847pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 will have no effect on the created NullRegion. Alternatively, a NULL []Object[] pointer Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Nu llRegion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 syntax used is identical to that for the []astSet[] function an d may include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 22776--22776 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 22776--22776 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 22776--22776 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [380] Overfull \hbox (42.36206pt too wide) in paragraph at lines 22809--22809 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (26.35347pt too wide) in paragraph at lines 22809--22809 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [381] Overfull \hbox (12.97206pt too wide) in paragraph at lines 22885--22885 []\T1/cmtt/m/n/10 void astOffset( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const double point1[], const double point2[], double Overfull \hbox (21.10475pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute). This Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 should contain the coordinates of the point marking the start o f the geodesic Overfull \hbox (15.85603pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis This s hould contain the Overfull \hbox (5.3586pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 The required offset from the first point along the geodesic cur ve. If this is Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 positive, it will be towards the second point. If it is negativ e, it will be Overfull \hbox (10.86975pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 in the opposite direction. This offset need not imply a positio n lying between Overfull \hbox (21.10475pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (21.36719pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input Overfull \hbox (0.37231pt too wide) in paragraph at lines 22885--22885 [][]\T1/cmtt/m/n/10 " Bad" coordinate values will also be returned if the two p oints supplied are Overfull \hbox (42.36206pt too wide) in paragraph at lines 22885--22885 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [382] Overfull \hbox (26.3563pt too wide) in paragraph at lines 22971--22971 []\T1/cmtt/m/n/10 double astOffset2( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const double point1[2], double angle, double offset, Overfull \hbox (21.10475pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute). This Overfull \hbox (0.37231pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 should contain the coordinates of the point marking the start o f the geodesic Overfull \hbox (0.10988pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The angle (in radians) from the positive direction of the secon d axis, to the Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 direction of the required position, as seen from the starting p osition. Positive Overfull \hbox (0.37231pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 rotation is in the sense of rotation from the positive directio n of axis 2 to Overfull \hbox (5.3586pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The required offset from the first point along the geodesic cur ve. If this is Overfull \hbox (16.11847pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 positive, it will be in the direction of the given angle. If it is negative, it Overfull \hbox (21.10475pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (22.20857pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 The direction of the geodesic curve at the end point. That is, the angle (in radians) Overfull \hbox (23.52075pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 between the positive direction of the second axis and the conti nuation of the geodesic Overfull \hbox (18.27203pt too wide) in paragraph at lines 22971--22971 \T1/cmtt/m/n/10 curve at the requested end point. Positive rotation is in the s ense of rotation from Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between Overfull \hbox (21.36719pt too wide) in paragraph at lines 22971--22971 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [383] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 23240. Overfull \hbox (10.58418pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astOutline$\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( $\OM L/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 val ue, int oper, const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/1 0 >$ \T1/cmtt/m/n/10 array[], const Overfull \hbox (13.02332pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 int lbnd[2], const int ubnd[2], double maxerr, int maxvert, con st int inside[2], int Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the outl ined pixels. It Overfull \hbox (37.11334pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to a 2-dimensional array containing the data to be proc essed. The numerical Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 type of this array should match the 1- or 2-character type code appended to the Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 function name (e.g. if you are using astOutlineF, the type of e ach array element Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the second dimension least Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the first pixel Overfull \hbox (16.11847pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [384] Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (34.70335pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel grid, its extent along a particular (j' th) dimension bei ng ubnd[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixels. For FITS images, the lbnd values will be 1 and the ubnd values will be Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 equal to the NAXISi header values. Other data systems, such as the Starlink NDF Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 system, allow an arbitrary pixel origin to be used (i.e. lbnd i s not necessarily Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 These bounds also define the input grid' s floating point coo rdinate system, each Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel having unit extent along each dimension with integral coo rdinate values Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Together with " maxvert" , this determines how accurately the r eturned Polygon Overfull \hbox (26.35347pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 represents the required region of the data array. It gives the target discrepancy Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 between the returned Polygon and the accurate outline in the da ta array, expressed Overfull \hbox (39.7377pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 as a number of pixels. Insignificant vertices are removed from the accurate outline, Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 one by one, until the number of vertices remaining in the retur ned Polygon equals Overfull \hbox (42.36206pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 " maxvert" , or the largest discrepancy between the accurate ou tline and the returned Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Polygon is greater than " maxerr" . If " maxerr" is zero or les s, its value is Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 ignored and the returned Polygon will have the number of vertic es specified by Overfull \hbox (0.10988pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Together with " maxerr" , this determines how accurately the re turned Polygon Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 represents the required region of the data array. It gives the maximum allowed Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 number of vertices in the returned Polygon. Insignificant verti ces are removed Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 from the accurate outline, one by one, until the number of vert ices remaining Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 in the returned Polygon equals " maxvert" , or the largest disc repancy between Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 the accurate outline and the returned Polygon is greater than " maxerr" . If Overfull \hbox (0.37231pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 " maxvert" is less than 3, its value is ignored and the number of vertices in Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 the returned Polygon will be the minimum needed to ensure that the discrepancy Overfull \hbox (1.94693pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 between the accurate outline and the returned Polygon is less t han " maxerr" . Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel indice s of a pixel known Overfull \hbox (21.10475pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 to be inside the required region. This is needed because the su pplied data array Overfull \hbox (21.36719pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 may contain several disjoint areas of pixels that satisfy the c riterion specified Overfull \hbox (37.11334pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 by " value" and " oper" . In such cases, the area described by the returned Polygon Overfull \hbox (26.35347pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 will be the one that contains the pixel specified by " inside" . If the specified Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 pixel is outside the bounds given by " lbnd" and " ubnd" , or h as a value that Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 does not meet the criterion specified by " value" and " oper" , then this function Overfull \hbox (0.10988pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 will search for a suitable pixel. The search starts at the cent ral pixel and Overfull \hbox (38.68796pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 proceeds in a spiral manner until a pixel is found that meets t he specified crierion. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 A flag indicating the nature of the pixel coordinate system use d to describe the Overfull \hbox (57.84578pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 vertex positions in the returned Polygon. If non-zero, the stan dard Starlink definition Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 of pixel coordinate is used in which a pixel with integer index I spans a range Overfull \hbox (64.93155pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 of pixel coordinate from (I-1) to I (i.e. pixel corners have in tegral pixel coordinates). Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 If zero, the definition of pixel coordinate used by other AST f unctions such as Overfull \hbox (5.3586pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 astResample, astMask, etc., is used. In this definition, a pixe l with integer Overfull \hbox (8.7222pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 index I spans a range of pixel coordinate from (I-0.5) to (I$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 0.5) (i.e. pixel [385] Overfull \hbox (26.6159pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 This function proceeds by first finding a very accurate pol ygon, and then removing Overfull \hbox (10.86975pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 The returned Polygon is the outer boundary of the contiguou s set of pixels that Overfull \hbox (33.43924pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 includes ths specified " inside" point, and satisfy the specifi ed value requirement. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 This set of pixels may potentially include " holes" where the p ixel values fail Overfull \hbox (43.93668pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 to meet the specified value requirement. Such holes will be ign ored by this function. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23240--23240 [][]\T1/cmtt/m/n/10 NULL will be returned if this function is invoked with the global error status Overfull \hbox (3.21706pt too wide) in paragraph at lines 23240--23240 []\T1/cmtt/m/n/10 To select the appropriate masking function, you should replac e $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 i n the generic Overfull \hbox (13.97693pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 function name astOutline$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$ \OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, s o as to match Overfull \hbox (7.7746pt too wide) in paragraph at lines 23240--23240 \T1/cmtt/m/n/10 For example, astOutlineD would be used to process " double" dat a, while astOutlineS [386] Overfull \hbox (12.76088pt too wide) in paragraph at lines 23306--23306 \T1/cmtt/m/n/10 A value indicating if there is any overlap between the two Regi ons. Possible values Overfull \hbox (2.52588pt too wide) in paragraph at lines 23306--23306 []\T1/cmtt/m/n/10 0 - The check could not be performed because the second Regio n could not be mapped Overfull \hbox (61.8364pt too wide) in paragraph at lines 23306--23306 []\T1/cmtt/m/n/10 6 - The second Region is the exact negation of the first Regi on to within their uncertainties. Overfull \hbox (0.37231pt too wide) in paragraph at lines 23306--23306 [][]\T1/cmtt/m/n/10 The returned values 5 and 6 do not check the value of the [ ]Closed[] attribute in Overfull \hbox (10.60732pt too wide) in paragraph at lines 23306--23306 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [387] Overfull \hbox (5.3586pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 The index into the list of parameters. The first parameter has index one, and Overfull \hbox (0.37231pt too wide) in paragraph at lines 23367--23367 [][]\T1/cmtt/m/n/10 The returned pointer is guaranteed to remain valid and the string to which it Overfull \hbox (16.11847pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 points will not be over-written for a total of 50 successive in vocations of this Overfull \hbox (21.10475pt too wide) in paragraph at lines 23367--23367 \T1/cmtt/m/n/10 function. After this, the memory containing the string may be r e-used, so a copy Overfull \hbox (5.3586pt too wide) in paragraph at lines 23367--23367 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [388] Overfull \hbox (9.50914pt too wide) in paragraph at lines 23470--23470 []\T1/cmtt/m/n/10 AstPcdMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPcdMap( do uble disco, const double pcdcen[2], const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 options, ... Overfull \hbox (0.10988pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 The distortion coefficient. Negative values give barrel distort ion, positive Overfull \hbox (10.86975pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pc dMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 23470--23470 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 23470--23470 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [389] Overfull \hbox (2.26344pt too wide) in paragraph at lines 23470--23470 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 23470--23470 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [390] Overfull \hbox (0.10988pt too wide) in paragraph at lines 23509--23509 \T1/cmtt/m/n/10 An array with one element for each axis of the Frame ([]Naxes[] attribute). This Overfull \hbox (21.36719pt too wide) in paragraph at lines 23509--23509 \T1/cmtt/m/n/10 should list the axes in their new order, using the original axi s numbering (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 23509--23509 [][]\T1/cmtt/m/n/10 Only genuine permutations of the axis order are permitted, so each axis must be Overfull \hbox (54.43411pt too wide) in paragraph at lines 23509--23509 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [391] Overfull \hbox (5.09898pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 AstPermMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPermMap( int nin, const int inperm[], int nout, const int outperm[], Overfull \hbox (10.60732pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array with " nin" elements which, for each input co ordinate, should Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 contain the number of the output coordinate whose value is to b e used (note that Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 this array therefore defines the inverse coordinate transformat ion). Coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 For details of additional special values that may be used in this array, see the Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, each input coordinate will Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 obtain its value from the corresponding output coordinate (or w ill be assigned Overfull \hbox (21.10475pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array with " nout" elements which, for each output coordinate, should Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 contain the number of the input coordinate whose value is to be used (note that Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 this array therefore defines the forward coordinate transformat ion). Coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 For details of additional special values that may be used in this array, see the Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, each outpu t coordinate will Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 obtain its value from the corresponding input coordinate (or wi ll be assigned Overfull \hbox (15.85603pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 An optional array containing values which may be assigned to in put and/or output Overfull \hbox (0.10988pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 coordinates instead of deriving them from other coordinate valu es. If either Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of the " inperm" or " outperm" arrays contains a negative value , it is used to Overfull \hbox (47.61078pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 address this " constant" array (such that -1 addresses the firs t element, -2 addresses Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 the second element, etc.) and the value obtained is used as the corresponding Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 Care should be taken to ensure that locations lying outside t he extent of this Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 array are not accidentally addressed. The array is not used if the " inperm" Overfull \hbox (0.37231pt too wide) in paragraph at lines 23647--23647 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [392] Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pe rmMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 23647--23647 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 If either of the " inperm" or " outperm" arrays contains a zero value (or a positive Overfull \hbox (7.98296pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 value which does not identify a valid output/input coordinate, as appropriate), Overfull \hbox (42.36206pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 This function does not attempt to ensure that the forward a nd inverse transformations Overfull \hbox (16.11847pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 performed by the PermMap are self-consistent in any way. You ar e therefore free Overfull \hbox (12.44437pt too wide) in paragraph at lines 23647--23647 \T1/cmtt/m/n/10 to supply coordinate permutation arrays that achieve whatever e ffect is desired. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23647--23647 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [393] Overfull \hbox (13.6056pt too wide) in paragraph at lines 23759--23759 []\T1/cmtt/m/n/10 AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPickAxes( A stFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, int naxes, const int axes[] , AstMapping $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 map Overfull \hbox (26.35347pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 An array, with " naxes" elements, which lists the axes to be co pied. These should Overfull \hbox (16.11847pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be given in the order required in the new Frame, using the axis numbering in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 original Frame (which starts at 1 for the first axis). Axes may be selected in Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 any order, but each may only be used once. If additional (defau lt) axes are also Overfull \hbox (7.19565pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 to be included, the corresponding elements of this array should be set to zero. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Address of a location in which to return a pointer to a new Map ping. This will Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be a []PermMap[] (or a []UnitMap[] as a special case) that desc ribes the axis permutation Overfull \hbox (21.36719pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 that has taken place between the original and new Frames. The M apping' s forward Overfull \hbox (18.74283pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 transformation will convert coordinates from the original Frame into the new one, Overfull \hbox (17.69308pt too wide) in paragraph at lines 23759--23759 []\T1/cmtt/m/n/10 If this Mapping is not required, a NULL value may be supplied for this parameter. Underfull \hbox (badness 10000) in paragraph at lines 23759--23759 Overfull \hbox (23.25832pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 This function applies to all Frames. The class of Frame returne d may differ from that Overfull \hbox (23.52075pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 of the original Frame, depending on which axes are selected. Fo r example, if a single Overfull \hbox (7.7746pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 axis is picked from a []SkyFrame[] (which must always have two axes) then the resulting Overfull \hbox (14.59793pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Frame cannot be a valid SkyFrame, so will revert to the parent class (Frame) instead. Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Using this function on a FrameSet is identical to using it on t he current Frame in Overfull \hbox (39.2669pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 If this function is used on a Region, an attempt is made to ret ain the bounds information Overfull \hbox (25.09537pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 on the selected axes. If succesful, the returned Frame will be a Region of some class. Overfull \hbox (49.76434pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 Otherwise, the returned Frame is obtained by calling this funct ion on the Frame represented Overfull \hbox (7.7746pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 by the supplied Region (the returned Frame will then not be a R egion). In order to Overfull \hbox (18.0096pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 be succesful, the selected axes in the Region must be independe nt of the others. For Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 instance, a []Box[] can be split in this way but a []Circle[] c annot. Another requirement Overfull \hbox (2.52588pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [394] Overfull \hbox (26.6159pt too wide) in paragraph at lines 23759--23759 [][]\T1/cmtt/m/n/10 The new Frame will contain a " deep" copy (c.f. []astCopy[] ) of all the data selected Overfull \hbox (5.62103pt too wide) in paragraph at lines 23759--23759 \T1/cmtt/m/n/10 from the original Frame. Modifying any aspect of the new Frame will therefore Overfull \hbox (5.62103pt too wide) in paragraph at lines 23759--23759 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [395] Overfull \hbox (7.93452pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPlot( AstFra me $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const float graphbox[ 4 ], cons t double basebox[ Overfull \hbox (1.94693pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 Pointer to a Frame describing the physical coordinate system in which to plot. Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 A pointer to a FrameSet may also be given, in which case its cu rrent Frame will Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 be used to define the physical coordinate system and its base F rame will be mapped Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 If a null []Object[] pointer (AST__NULL) is given, a default 2-dimensional Frame will Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 be used to describe the physical coordinate system. Labels, etc . may then be Overfull \hbox (15.06873pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 attached to this by setting the appropriate Frame attributes (e .g. []Label(axis)[]) Overfull \hbox (0.10988pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 An array giving the position and extent of the plotting area (o n the plotting Overfull \hbox (22.9418pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 surface of the underlying graphics system) in which graphical o utput is to appear. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 This must be specified using graphical coordinates appropriate to the underlying Overfull \hbox (5.09616pt too wide) in paragraph at lines 23932--23932 []\T1/cmtt/m/n/10 The first pair of values should give the coordinates of the b ottom left corner Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of the plotting area and the second pair should give the coordi nates of the top Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 right corner. The coordinate on the horizontal axis should be g iven first in Overfull \hbox (37.11334pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [396] Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 An array giving the coordinates of two points in the supplied F rame (or in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 base Frame if a FrameSet was supplied) which correspond to the bottom left and Overfull \hbox (47.61078pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 top right corners of the plotting area, as specified above. Thi s range of coordinates Overfull \hbox (21.10475pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 will be mapped linearly on to the plotting area. The coordinate s should be given Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pl ot. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (16.11847pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 The base Frame of the returned Plot will be a new Frame whi ch is created by this Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 function to represent the coordinate system of the underlying g raphics system Overfull \hbox (5.09616pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 (graphical coordinates). It is given a Frame index of 1 within the Plot. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 choice of base Frame ([]Base[] attribute) should not, in genera l, be changed once Overfull \hbox (37.11334pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 a Plot has been created (although you could use this as a way o f moving the plotting Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a Frame is supplied (via the " frame" pointer), then it becomes the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a FrameSet is supplied (via the " frame" pointer), then all the Frames within Overfull \hbox (26.6159pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 this FrameSet become part of the new Plot (where their Frame in dices are increased Overfull \hbox (17.69308pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 by 1), with the FrameSet' s current Frame becoming the current Frame of the Plot. Overfull \hbox (21.36719pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is supplied (via the " frame" pointer), then Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 the returned Plot will contain two Frames, both created by this function. The Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 base Frame will describe graphics coordinates (as above) and th e current Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 will be a basic Frame with no attributes set (this will therefo re give default Overfull \hbox (10.60732pt too wide) in paragraph at lines 23932--23932 \T1/cmtt/m/n/10 values for such things as the Plot []Title[] and the Label on e ach axis). Physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 An error will result if the Frame supplied (or the base Fra me if a FrameSet was Overfull \hbox (5.62103pt too wide) in paragraph at lines 23932--23932 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [397] Overfull \hbox (28.9294pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 AstPlot3D $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPlot3D( As tFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, const float graphbox[ 6 ], const double basebox[ Overfull \hbox (1.94693pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 Pointer to a []Frame[] describing the physical coordinate syste m in which to plot. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 A pointer to a []FrameSet[] may also be given, in which case it s current Frame will Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 be used to define the physical coordinate system and its base F rame will be mapped Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 If a null []Object[] pointer (AST__NULL) is given, a default 3-dimensional Frame will Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 be used to describe the physical coordinate system. Labels, etc . may then be Overfull \hbox (15.06873pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 attached to this by setting the appropriate Frame attributes (e .g. []Label(axis)[]) Overfull \hbox (31.60219pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 An array giving the position and extent of the plotting volume (within the plotting Overfull \hbox (12.44437pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 space of the underlying graphics system) in which graphical out put is to appear. Overfull \hbox (15.85603pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 This must be specified using graphical coordinates appropriate to the underlying Overfull \hbox (15.5936pt too wide) in paragraph at lines 24068--24068 []\T1/cmtt/m/n/10 The first triple of values should give the coordinates of the bottom left corner Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of the plotting volume and the second triple should give the co ordinates of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 top right corner. The coordinate on the horizontal axis should be given first Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 in each pair. Note that the order in which these points are giv en is important Overfull \hbox (12.44437pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 because it defines up, down, left and right for subsequent grap hical operations. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 An array giving the coordinates of two points in the supplied F rame (or in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 base Frame if a FrameSet was supplied) which correspond to the bottom left and Overfull \hbox (58.10822pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 top right corners of the plotting volume, as specified above. T his range of coordinates Overfull \hbox (21.10475pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 will be mapped linearly on to the plotting area. The coordinate s should be given Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pl ot3D. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [398] Overfull \hbox (0.10988pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 The base Frame of the returned Plot3D will be a new Frame w hich is created by Overfull \hbox (26.6159pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 this function to represent the coordinate system of the underly ing graphics system Overfull \hbox (10.34488pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 (graphical coordinates). It is given a Frame index of 1 within the Plot3D. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 choice of base Frame ([]Base[] attribute) should not, in genera l, be changed once Overfull \hbox (0.37231pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 a Plot3D has been created (although you could use this as a way of moving the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a Frame is supplied (via the " frame" pointer), then it becomes the current Overfull \hbox (16.11847pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a FrameSet is supplied (via the " frame" pointer), then all the Frames within Overfull \hbox (37.11334pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 this FrameSet become part of the new Plot3D (where their Frame indices are increased Overfull \hbox (28.19052pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 by 1), with the FrameSet' s current Frame becoming the current Frame of the Plot3D. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 At least one of the three axes of the current Frame must be independent of the Overfull \hbox (21.36719pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 If a null Object pointer (AST__NULL) is supplied (via the " frame" pointer), then Overfull \hbox (16.11847pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 the returned Plot3D will contain two Frames, both created by th is function. The Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 base Frame will describe graphics coordinates (as above) and th e current Frame Overfull \hbox (5.3586pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 will be a basic Frame with no attributes set (this will therefo re give default Overfull \hbox (21.10475pt too wide) in paragraph at lines 24068--24068 \T1/cmtt/m/n/10 values for such things as the Plot3D []Title[] and the Label on each axis). Physical Overfull \hbox (10.86975pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 An error will result if the Frame supplied (or the base Fra me if a FrameSet was Overfull \hbox (5.62103pt too wide) in paragraph at lines 24068--24068 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [399] Overfull \hbox (34.17812pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 AstPointList $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPointLi st( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int npnt, int ncoord, int dim, const double Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. A deep c opy is taken of Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the supplied Frame. This means that any subsequent changes made to the Frame Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The number of coordinates being supplied for each point. This m ust equal the Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " poin ts" array (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 contains the point coordinates). This value is required so that the coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 values can be correctly located if they do not entirely fill th is array. The Overfull \hbox (31.60219pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of sh ape " [ncoord][dim]" Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 giving the physical coordinates of the points. These should be stored such that Overfull \hbox (31.86462pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the value of coordinate number " coord" for point number " pnt" is found in element Overfull \hbox (47.34834pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 with each point in the PointList being created. The uncertainty at any point Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 in the PointList is found by shifting the supplied " uncertaint y" Region so that Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 it is centred at the point being considered. The area covered b y the shifted Overfull \hbox (36.8509pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 uncertainty Region then represents the uncertainty in the posit ion. The uncertainty Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 are centro-symetric (e.g. []Box[], []Circle[], []Ellipse[], etc .) or be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 will have no effect on the created Box. Alternatively, a NULL [ ]Object[] pointer may Overfull \hbox (31.86462pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 be supplied, in which case a default uncertainty is used equiva lent to a box 1.0E-6 Overfull \hbox (5.3586pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [400] Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po intList. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24201--24201 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24201--24201 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 24201--24201 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 24201--24201 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [401] Overfull \hbox (29.14058pt too wide) in paragraph at lines 24278--24278 []\T1/cmtt/m/n/10 void astPolyCoeffs( AstPolyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 this, int forward, int nel, double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 coeffs, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ncoeff Overfull \hbox (17.69308pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 If non-zero, the coefficients of the forward PolyMap transforma tion are returned. Overfull \hbox (0.32106pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 The length of the supplied " coeffs" array. It should be at lea st " ncoeff$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ( Overfull \hbox (22.53198pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 nin $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 2 )" if " foward" is n on-zero, and " ncoeff$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ( nout $\OT1/zplm/m/ n/10 +$ \T1/cmtt/m/n/10 2 )" otherwise, where Overfull \hbox (5.62103pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 " ncoeff" is the number of coefficients to be returned. If a va lue of zero is Overfull \hbox (21.36719pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 supplied, no coefficient values are returned, but the number of coefficients used Overfull \hbox (21.10475pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 An array in which to return the coefficients used by the reques ted transformation Overfull \hbox (0.37231pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 of the PolyMap. Ignored if " nel" is zero. The coefficient data is returned Overfull \hbox (5.62103pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 in the form in which it is supplied to the PolyMap constructor. That is, each Overfull \hbox (32.81824pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" or " 2 $ \OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" adjacent elements describe a single c oefficient Overfull \hbox (37.11334pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 of the forward or inverse transformation. See the PolyMap const ructor documentation Overfull \hbox (47.61078pt too wide) in paragraph at lines 24278--24278 []\T1/cmtt/m/n/10 If the supplied array is too short to hold all the coefficien ts, trailing coefficients Overfull \hbox (55.48386pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 are excluded. If the supplied array is longer than needed to ho ld all the coefficients, Overfull \hbox (21.10475pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 The number of coefficients used by the requested transformation . A value of zero Overfull \hbox (26.6159pt too wide) in paragraph at lines 24278--24278 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [402] Overfull \hbox (18.43196pt too wide) in paragraph at lines 24355--24355 []\T1/cmtt/m/n/10 void astPolyCurve( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, int npoint, int ncoord, int indim, const double $\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 in Overfull \hbox (21.10475pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 The number of coordinates being supplied for each point (i.e. t he number of axes Overfull \hbox (36.8509pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (0.37231pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 the input coordinates). This value is required so that the coor dinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 24355--24355 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord][indim]" Overfull \hbox (16.11847pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 giving the physical coordinates of the points which are to be j oined in sequence Overfull \hbox (0.37231pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 by geodesic curves. These should be stored such that the value of coordinate Overfull \hbox (21.36719pt too wide) in paragraph at lines 24355--24355 \T1/cmtt/m/n/10 number " coord" for point number " point" is found in element " in[coord][point]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 24355--24355 [][]\T1/cmtt/m/n/10 No curve is drawn on either side of any point which has any coordinate equal to Overfull \hbox (10.86975pt too wide) in paragraph at lines 24355--24355 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [403] Overfull \hbox (12.97206pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 AstPolyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPolyMap( int nin, int nout, int ncoeff_f, const double coeff_f[], int Overfull \hbox (26.35347pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the for ward transformation Overfull \hbox (28.19052pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of the PolyMap. If zero is supplied, the forward transformation will be undefined. Overfull \hbox (17.02083pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 An array containing " ncoeff_f$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nin" Overfull \hbox (1.94693pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the forward transformation. Overfull \hbox (36.8509pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 Within each such group, the first element is the coefficient va lue; the next element Overfull \hbox (16.11847pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 is the integer index of the PolyMap output which uses the coeff icient within its Overfull \hbox (0.37231pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 defining polynomial (the first output has index 1); the remaini ng elements of Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 the group give the integer powers to use with each input coordi nate value (powers Overfull \hbox (33.43924pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 For instance, if the PolyMap has 3 inputs and 2 outputs, each group consisting Overfull \hbox (37.11334pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of 5 elements, A groups such as " (1.2, 2.0, 1.0, 3.0, 0.0)" de scribes a coefficient Overfull \hbox (21.10475pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 with value 1.2 which is used within the definition of output 2. The output value Overfull \hbox (42.36206pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 is incremented by the product of the coefficient value, the val ue of input coordinate Overfull \hbox (15.5936pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 1 raised to the power 1, and the value of input coordinate 2 ra ised to the power Overfull \hbox (36.8509pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 3. Input coordinate 3 is not used since its power is specified as zero. As another Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 example, the group " (-1.0, 1.0, 0.0, 0.0, 0.0 )" describes add s a constant value Overfull \hbox (8.24539pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 -1.0 onto output 1 (it is a constant value since the power for every input axis Overfull \hbox (16.11847pt too wide) in paragraph at lines 24482--24482 []\T1/cmtt/m/n/10 Each final output coordinate value is the sum of the " ncoeff _f" terms described Overfull \hbox (26.35347pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 The number of non-zero coefficients necessary to define the inv erse transformation Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of the PolyMap. If zero is supplied, the default behaviour is t o use an iterative Overfull \hbox (47.61078pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 method to evaluate the inverse based only on the forward transf ormation (see attribute Overfull \hbox (27.51826pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 An array containing " ncoeff_i$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 ( 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout )" elements. Each group of " 2 $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 nout" Overfull \hbox (2.99667pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 adjacent elements describe a single coefficient of the inverse transformation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 using the same schame as " coeff_f" , except that " inputs" and " outputs" are Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [404] Overfull \hbox (10.86975pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po lyMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24482--24482 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24482--24482 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24482--24482 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [405] Overfull \hbox (31.86462pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 If non-zero, the forward PolyMap transformation is replaced. Ot herwise the inverse Overfull \hbox (21.10475pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The target accuracy, expressed as a geodesic distance within th e PolyMap' s input Overfull \hbox (26.35347pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The maximum allowed accuracy for an acceptable polynomial, expr essed as a geodesic Overfull \hbox (26.6159pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 distance within the PolyMap' s input space (if " forward" is ze ro) or output space Overfull \hbox (5.09616pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The maximum allowed polynomial order. This is one more than the maximum power Overfull \hbox (43.93668pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 of either input axis. So for instance, a value of 3 refers to a quadratic polynomial. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Note, cross terms with total powers greater than or equal to ma xorder are not Overfull \hbox (47.61078pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [406] Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Pointer to an array holding the lower bounds of a rectangular r egion within the Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 PolyMap' s input space (if " forward" is zero) or output space (if " forward" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 is non-zero). The new polynomial will be evaluated over this re ctangle. The Overfull \hbox (34.48898pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 length of this array should equal the value of the PolyMap' s [ ]Nin[] or []Nout[] attribute, Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 Pointer to an array holding the upper bounds of a rectangular r egion within the Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 PolyMap' s input space (if " forward" is zero) or output space (if " forward" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 is non-zero). The new polynomial will be evaluated over this re ctangle. The Overfull \hbox (34.48898pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 length of this array should equal the value of the PolyMap' s N in or Nout attribute, Overfull \hbox (2.001pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 The ChebyMap implementation of this method allows NULL pointers to be supplied for Overfull \hbox (44.51563pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 " lbnd" and/or " ubnd" , in which case the corresponding bounds supplied when the ChebyMap Overfull \hbox (44.25319pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 was created are used. The returned PolyMap will be a ChebyMap, and the new transformation Overfull \hbox (2.26344pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 A pointer to the new PolyMap. A NULL pointer will be returned i f the fit fails to Overfull \hbox (16.11847pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 The []IterInverse[] attribute is always cleared in the retu rned PolyMap. This means Overfull \hbox (0.37231pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 that the returned PolyMap will always use the new fit by defaul t, rather than Overfull \hbox (10.86975pt too wide) in paragraph at lines 24657--24657 \T1/cmtt/m/n/10 the iterative inverse, regardless of the setting of IterInverse in the supplied Overfull \hbox (5.3586pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 This function can only be used on 1D or 2D PolyMaps which h ave the same number Overfull \hbox (5.62103pt too wide) in paragraph at lines 24657--24657 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [407] Overfull \hbox (50.13545pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 AstPolygon $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPolygon( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame, int npnt, int dim, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 points, AstRegion Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 A pointer to the Frame in which the region is defined. It must have exactly 2 Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 axes. A deep copy is taken of the supplied Frame. This means th at any subsequent Overfull \hbox (33.43924pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 changes made to the Frame using the supplied pointer will have no effect the []Region[]. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " poin ts" array (which Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 contains the point coordinates). This value is required so that the coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 values can be correctly located if they do not entirely fill th is array. The Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 The address of the first element of a 2-dimensional array of sh ape " [2][dim]" Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 giving the physical coordinates of the vertices. These should b e stored such Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 that the value of coordinate number " coord" for point number " pnt" is found Overfull \hbox (47.34834pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 An optional pointer to an existing Region which specifies the u ncertainties associated Overfull \hbox (0.10988pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 with the boundary of the Polygon being created. The uncertainty in any point Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 on the boundary of the Polygon is found by shifting the supplie d " uncertainty" Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 Region so that it is centred at the boundary point being consid ered. The area Overfull \hbox (16.11847pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 covered by the shifted uncertainty Region then represents the u ncertainty in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 If supplied, the uncertainty Region must be of a class for wh ich all instances Overfull \hbox (16.11847pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 are centro-symetric (e.g. []Box[], []Circle[], []Ellipse[], etc .) or be a []Prism[] containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 centro-symetric component Regions. A deep copy of the supplied Region will be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 taken, so subsequent changes to the uncertainty Region using th e supplied pointer Overfull \hbox (20.84232pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 will have no effect on the created Polygon. Alternatively, a NU LL []Object[] pointer Overfull \hbox (15.85603pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [408] Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 The uncertainty Region has two uses: 1) when the []astOverlap [] function compares Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 two Regions for equality the uncertainty Region is used to dete rmine the tolerance Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 on the comparison, and 2) when a Region is mapped into a differ ent coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Po lygon. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24802--24802 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24802--24802 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 24802--24802 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 24802--24802 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [409] Overfull \hbox (9.9315pt too wide) in paragraph at lines 24881--24881 []\T1/cmtt/m/n/10 AstPrism $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astPrism( AstR egion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region1, AstRegion $\OMS/zplm/m/n/1 0 ^^C$\T1/cmtt/m/n/10 region2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... Overfull \hbox (10.86975pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Pr ism. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 24881--24881 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no Overfull \hbox (5.62103pt too wide) in paragraph at lines 24881--24881 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [410] [411] [412] Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS cards to be Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 stored. Each individual card should occupy 80 characters in thi s string, and Overfull \hbox (21.36719pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 there should be no delimiters, new lines, etc, between adjacent cards. The final Overfull \hbox (0.37231pt too wide) in paragraph at lines 24969--24969 \T1/cmtt/m/n/10 card may be less than 80 characters long. This is the format pr oduced by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24969--24969 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [413] Overfull \hbox (47.34834pt too wide) in paragraph at lines 25013--25013 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [414] Overfull \hbox (15.8076pt too wide) in paragraph at lines 25071--25071 []\T1/cmtt/m/n/10 void astPutColumnData( AstFitsTable $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 column, int clen, size_t size, Overfull \hbox (22.67937pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 The character string holding the name of the column. Trailing s paces are ignored. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 If the column holds character strings, then this must be set to the length of Overfull \hbox (16.11847pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 each fixed length string in the supplied array. This is often d etermined by the Overfull \hbox (0.37231pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 appropriate TFORMn keyword in the binary table header. The supp lied value is Overfull \hbox (10.60732pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 The size of the " coldata" array, in bytes. This should be an i nteger multiple Overfull \hbox (5.62103pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 of the number of bytes needed to hold the full vector value sto red in a single Overfull \hbox (0.10988pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 A pointer to an area of memory holding the data to copy into th e column. The Overfull \hbox (21.10475pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 values should be stored in row order. If the column holds non-s calar values, the Overfull \hbox (42.36206pt too wide) in paragraph at lines 25071--25071 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [415] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 Pointer to a possibly null-terminated character string containi ng the FITS card Overfull \hbox (21.10475pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 to be stored. No more than 80 characters will be used from this string (or fewer Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 If this value is zero, the new card is inserted in front of the current card in Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 the FitsChan (as identified by the initial value of the Card at tribute). If it Overfull \hbox (5.62103pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 is non-zero, the new card replaces the current card. In either case, the Card Overfull \hbox (16.11847pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 attribute is then incremented by one so that it subsequently id entifies the card Overfull \hbox (10.86975pt too wide) in paragraph at lines 25124--25124 [][]\T1/cmtt/m/n/10 If the Card attribute initially points at the " end-of-file " (i.e. exceeds the Overfull \hbox (16.11847pt too wide) in paragraph at lines 25124--25124 \T1/cmtt/m/n/10 number of cards in the FitsChan), then the new card is appended as the last card Overfull \hbox (26.35347pt too wide) in paragraph at lines 25124--25124 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [416] Overfull \hbox (52.8595pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 Pointer to a []FitsTable[] to be added to the FitsChan. If a Fi tsTable with the associated Overfull \hbox (7.19565pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 extension name already exists in the FitsChan, it is replaced w ith the new one. Overfull \hbox (21.10475pt too wide) in paragraph at lines 25178--25178 \T1/cmtt/m/n/10 A deep copy of the FitsTable is stored in the FitsChan, so any subsequent changes [417] Overfull \hbox (16.11847pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 Pointer to a []FitsChan[] holding the headers for the FitsTable . A deep copy of the Overfull \hbox (10.86975pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 supplied FitsChan is stored in the FitsTable, replacing the cur rent FitsChan in Overfull \hbox (2.99667pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 the Fitstable. Keywords that are fixed either by the properties of the []Table[], Overfull \hbox (37.11334pt too wide) in paragraph at lines 25224--25224 [][]\T1/cmtt/m/n/10 The attributes of the supplied FitsChan, together with any source and sink functions Overfull \hbox (5.62103pt too wide) in paragraph at lines 25224--25224 [][]\T1/cmtt/m/n/10 Values for the following keywords are generated automatical ly by the FitsTable Overfull \hbox (47.0859pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 (any values for these keywords in the supplied FitsChan will be ignored): " XTENSION" Overfull \hbox (31.86462pt too wide) in paragraph at lines 25224--25224 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [418] Overfull \hbox (26.6159pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 Pointer to a []KeyMap[] holding the tables that are to be added to the FitsChan. Each Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 entry should hold a scalar value which is a pointer to a []Fits Table[] to be added Overfull \hbox (21.36719pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 to the FitsChan. Any unusable entries are ignored. The key asso ciated with each Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 entry should be the name of the FITS binary extension from whic h the table was Overfull \hbox (16.11847pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 read. If a FitsTable with the associated key already exists in the FitsChan, it Overfull \hbox (0.37231pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 is replaced with the new one. A deep copy of each usable FitsTa ble is stored Overfull \hbox (5.62103pt too wide) in paragraph at lines 25282--25282 \T1/cmtt/m/n/10 in the FitsChan, so any subsequent changes made to the FitsTabl es will have no Overfull \hbox (22.9418pt too wide) in paragraph at lines 25282--25282 [][]\T1/cmtt/m/n/10 The tables in the supplied KeyMap are added to any tables a lready in the FitsChan. Overfull \hbox (0.37231pt too wide) in paragraph at lines 25282--25282 [][]\T1/cmtt/m/n/10 The []astPutTable[] method provides a simpler means of addi ng a single table to a [419] Overfull \hbox (15.85886pt too wide) in paragraph at lines 25397--25397 []\T1/cmtt/m/n/10 int QuadApprox( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, const double lbnd[2], const double ubnd[2], int nx, Overfull \hbox (26.6159pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the lower bounds of a box defined within Overfull \hbox (21.10475pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 the input coordinate system of the Mapping. The number of eleme nts in this array Overfull \hbox (15.85603pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 should equal the value of the Mapping' s []Nin[] attribute. Thi s box should specify Overfull \hbox (16.11847pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.37231pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 The number of points to place along the first Mapping inp ut. The first point Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 is at " lbnd[0]" and the last is at " ubnd[0]" . If a value les s than three is Overfull \hbox (5.62103pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 The number of points to place along the second Mapping in put. The first point Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 is at " lbnd[1]" and the last is at " ubnd[1]" . If a value les s than three is Overfull \hbox (37.11334pt too wide) in paragraph at lines 25397--25397 [] \T1/cmtt/m/n/10 Pointer to an array of doubles in which to return the co- efficients of the quadratic Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 approximation to the specified transformation. This array shoul d have at least Overfull \hbox (0.5835pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 " 6$\OMS/zplm/m/n/10 ^^C$[]\T1/cmtt/m/n/10 Nout[]" , elements. The first 6 elements hold the fit to the first Mapping Overfull \hbox (16.11847pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 output. The next 6 elements hold the fit to the second Mapping output, etc. So Overfull \hbox (37.11334pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 if the Mapping has 2 inputs and 2 outputs the quadratic approxi mation to the forward Overfull \hbox (29.52779pt too wide) in paragraph at lines 25397--25397 []\T1/cmtt/m/n/10 X_out = fit[0] $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[1]$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fi t[2]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/ n/10 fit[3]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/ cmtt/m/n/10 Y_in $\OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[4]$\OMS/zplm/m/n/10 ^ ^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in Overfull \hbox (27.70023pt too wide) in paragraph at lines 25397--25397 \OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[5]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in Y_out = fit[6] $\OT1/zplm/m/n/1 0 +$ \T1/cmtt/m/n/10 fit[7]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in $\OT1/zpl m/m/n/10 +$ \T1/cmtt/m/n/10 fit[8]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in $\ OT1/zplm/m/n/10 +$ \T1/cmtt/m/n/10 fit[9]$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 X_in$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 Y_in Overfull \hbox (10.86975pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 Pointer to a double in which to return the RMS residual between the fit and the Overfull \hbox (2.52588pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 If a quadratic approximation was created, a non-zero value is r eturned. Otherwise Overfull \hbox (0.37231pt too wide) in paragraph at lines 25397--25397 [][]\T1/cmtt/m/n/10 This function fits the Mapping' s forward transformation. T o fit the inverse Overfull \hbox (5.62103pt too wide) in paragraph at lines 25397--25397 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using []astInver t[] before invoking [420] Overfull \hbox (26.35347pt too wide) in paragraph at lines 25397--25397 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [421] Overfull \hbox (21.36719pt too wide) in paragraph at lines 25466--25466 [] \T1/cmtt/m/n/10 The address of an array holding the axis values at the po sition at which the rate Overfull \hbox (16.11847pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 of change is to be evaluated. The number of elements in this ar ray should equal Overfull \hbox (31.60219pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The index of the Mapping output for which the rate of change is to be found (output Overfull \hbox (5.3586pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The index of the Mapping input which is to be varied in order t o find the rate Overfull \hbox (12.76088pt too wide) in paragraph at lines 25466--25466 \T1/cmtt/m/n/10 The rate of change of Mapping output " ax1" with respect to inp ut " ax2" , evaluated Overfull \hbox (16.11847pt too wide) in paragraph at lines 25466--25466 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [422] Overfull \hbox (4.4716pt too wide) in paragraph at lines 25566--25566 []\T1/cmtt/m/n/10 AstRateMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astRateMap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map, int ax1, int ax2, const c har $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... Overfull \hbox (5.62103pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Index of the output from the encapsulated Mapping for which the rate of change Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 is required. This corresponds to the delta quantity forming the numerator of Overfull \hbox (52.8595pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Index of the input to the encapsulated Mapping which is to be v aried. This corresponds Overfull \hbox (42.36206pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 to the delta quantity forming the denominator of the required e lement of the Jacobian Overfull \hbox (10.86975pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ra teMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 25566--25566 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (10.60732pt too wide) in paragraph at lines 25566--25566 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astRateMap (the new Overfull \hbox (5.3586pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 RateMap simply retains a reference to them). They may continue to be used for Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a RateMap contain ing a copy of Overfull \hbox (0.37231pt too wide) in paragraph at lines 25566--25566 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [423] Overfull \hbox (5.62103pt too wide) in paragraph at lines 25566--25566 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [424] Overfull \hbox (18.0096pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 All successful use of astRead on a FitsChan is destructive, so that FITS header cards Overfull \hbox (7.7746pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 are consumed in the process of reading an Object, and are remov ed from the FitsChan Overfull \hbox (33.49332pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 (this deletion can be prevented for specific cards by calling t he FitsChan []astRetainFits[] Overfull \hbox (18.27203pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 function). An unsuccessful call of astRead (for instance, cause d by the FitsChan not Overfull \hbox (2.52588pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 containing the necessary FITS headers cards needed to create an Object) results in Overfull \hbox (17.74716pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 The AST Object returned by a successful use of astRead on an St csChan, will be either Overfull \hbox (28.76947pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 a []Region[] or a []KeyMap[], depending on the values of the [] StcsArea[], []StcsCoords[] and []StcsProps[] Overfull \hbox (2.001pt too wide) in paragraph at lines 25634--25634 \T1/cmtt/m/n/10 A pointer to the new Object. The class to which this will belon g is determined by Overfull \hbox (21.36719pt too wide) in paragraph at lines 25634--25634 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned, without error, if the Channel Overfull \hbox (16.11847pt too wide) in paragraph at lines 25634--25634 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [425] Overfull \hbox (0.37231pt too wide) in paragraph at lines 25676--25676 [][]\T1/cmtt/m/n/10 This function returns without action if no source function was specified when Overfull \hbox (5.62103pt too wide) in paragraph at lines 25676--25676 [][]\T1/cmtt/m/n/10 The []SourceFile[] attribute is ignored by this function. N ew cards are read from [426] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26182. Overfull \hbox (6.0526pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 void astRebin$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, double wlim, int ndim_in, const int lbnd_in[], Overfull \hbox (14.93054pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T 1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int spread, const Overfull \hbox (0.85513pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 double params[], int flags, double tol, int maxpix, $\OML/zplm/ m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, in t ndim_out, Overfull \hbox (34.9718pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 const int lbnd_out[], const int ubnd_out[], const int lbnd[], c onst int ubnd[], $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ [427] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to a Mapping, whose forward transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 coordinates of pixels in the input grid into the coordinate sys tem of the output Overfull \hbox (35.80116pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its []Nin[] attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates ([]Nout[] at tribute) should match Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Gives the required number of input pixel values which must cont ribute to an output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 pixel in order for the output pixel value to be considered vali d. If the sum Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the input pixel weights contributing to an output pixel is l ess than the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 " wlim" value, then the output pixel value is returned set to t he supplied bad Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the input data to be rebined. The numerical type of this array should match the Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 1- or 2-character type code appended to the function name (e.g. if you are using Overfull \hbox (15.85603pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array. If this array is supplied (together with the correspondi ng " out_var" Overfull \hbox (38.68796pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 array), then estimates of the variance of the rebined output da ta will be calculated. Overfull \hbox (22.9418pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no input variance estimates are being provided, a NULL poi nter should be given. Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for dividing eac h input data value Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 up amongst the corresponding output pixels. It may be used to s elect from a set Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of pre-defined schemes by supplying one of the values described in the " Pixel Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Spreading Schemes" section below. If a value of zero is supplie d, then the default Overfull \hbox (12.44437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 linear spreading scheme is used (equivalent to supplying the va lue AST__LINEAR). Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 parameter values required by the pixel spreading scheme. If suc h parameters are Overfull \hbox (31.60219pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [428] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 control over the rebinning operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the out put grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 in adjacent panel will be higher, and may cause the edges of th e panel to be visible Overfull \hbox (0.10988pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 when viewing the output image at high contrast. If this is a pr oblem, reduce Overfull \hbox (36.8509pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (10.60732pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 In all cases, this value is also used to flag any output elem ents in the " out" Overfull \hbox (5.09616pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 (and " out_var" ) array(s) for which rebined values could not b e obtained (see Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the " Propagation of Missing Data" section below for details of the circumstances Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [429] Overfull \hbox (47.61078pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the first pixel in the region of the input grid which is to be included in Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the last pixel in the region of the input grid which is to b e included in the Overfull \hbox (84.08937pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 region of the input grid which is to be included in the rebined output array. This Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 region should lie wholly within the extent of the input grid (a s defined by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 " lbnd_in" and " ubnd_in" arrays). Regions of the input grid ly ing outside this Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid, in which Overfull \hbox (26.6159pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the rebined data values will be returned. The numerical type of this array should Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 match that of the " in" array, and the data storage order shoul d be such that Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the index of the first grid dimension varies most rapidly and t hat of the final Overfull \hbox (12.18193pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 An optional pointer to an array with the same type and size as the " out" array. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 If given, this array will be used to return variance estimates for the rebined Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 data values. This array will only be used if the " in_var" arra y has also been Overfull \hbox (5.3586pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The output variance values will be calculated on the assumpti on that errors on Overfull \hbox (42.36206pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the input data values are statistically independent and that th eir variance estimates Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 may simply be summed (with appropriate weighting factors) when several input pixels Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 contribute to an output data value. If this assumption is not v alid, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 output error estimates may be biased. In addition, note that th e statistical Overfull \hbox (36.0636pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 errors on neighbouring output data values (as well as the estim ates of those errors) Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 may often be correlated, even if the above assumption about the input data is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 If no output variance estimates are required, a NULL pointer should be given. Overfull \hbox (13.7145pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 To select the appropriate rebinning function, you should repl ace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the generic Overfull \hbox (3.47949pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 function name astRebin$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [430] Overfull \hbox (41.17413pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Note that, unlike []astResample$\OML/zplm/m/it/10 <$\T1/cmtt/ m/n/10 X$\OML/zplm/m/it/10 >$[]\T1/cmtt/m/n/10 , the astRebin$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 set of functions does not yet support Overfull \hbox (12.76088pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The pixel spreading scheme specifies the Point Spread Functio n (PSF) applied to each Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 input pixel value as it is copied into the output array. It can be thought of as the Overfull \hbox (8.72821pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 inverse of the sub-pixel interpolation schemes used by the astR esample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n /10 group of Overfull \hbox (34.01819pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 functions. That is, in a sub-pixel interpolation scheme the ker nel specifies the weight Overfull \hbox (39.2669pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to assign to each input pixel when forming the weighted mean of the input pixels, whereas Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the kernel in a pixel spreading scheme specifies the fraction o f the input data value Overfull \hbox (2.26344pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 which is to be assigned to each output pixel. As for interpolat ion, the choice of Overfull \hbox (2.52588pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 suitable pixel spreading scheme involves stricking a balance be tween schemes which Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 tend to degrade sharp features in the data by smoothing them, a nd those which attempt Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to preserve sharp features but which often tend to introduce un wanted artifacts. See Overfull \hbox (18.0096pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The binning algorithm used has the ability to introduce artif acts not seen when using Overfull \hbox (20.8964pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 a resampling algorithm. Particularly, when viewing the output i mage at high contrast, Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 systems of curves lines covering the entire image may be visibl e. These are caused Overfull \hbox (15.64767pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 by a beating effect between the input pixel positions and the o utput pixels position, Overfull \hbox (2.52588pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 and their nature and strength depend critically upon the nature of the Mapping and Overfull \hbox (34.01819pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the spreading function being used. In general, the nearest neig hbour spreading function Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 demonstrates this effect more clearly than the other functions, and for this reason Overfull \hbox (7.51216pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The following values (defined in the " ast.h" header file) ma y be assigned to the " Overfull \hbox (24.47437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 spread" parameter. See the astResample$\OML/zplm/m/it/10 <$\T1/ cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 documentation for details of these schemes Overfull \hbox (64.79337pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 In addition, the following schemes can be used with astRebin$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 but no t with astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T 1/cmtt/m/n/10 : Overfull \hbox (16.54083pt too wide) in paragraph at lines 26182--26182 [][]\T1/cmtt/m/n/10 AST__GAUSS: This scheme uses a kernel of the form exp(-k$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), w ith k a positive Overfull \hbox (0.37231pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 constant determined by the full-width at half-maximum (FWHM). T he FWHM should Overfull \hbox (31.86462pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 be supplied in units of output pixels by means of the " params[ 1]" value and should Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 be at least 0.1. The " params[0]" value should be used to speci fy at what point Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 the Gaussian is truncated to zero. This should be given as a nu mber of output Overfull \hbox (16.11847pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 pixels on either side of the central output point in each dimen sion (the nearest Overfull \hbox (23.25832pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [431] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26182--26182 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. Overfull \hbox (28.76947pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 Instances of missing data (bad pixels) in the output grid are identified by occurrences Overfull \hbox (39.2669pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are produced if the sum of the weights Overfull \hbox (7.51216pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 An input pixel is considered bad (and is consequently ignored ) if its data value is Overfull \hbox (18.27203pt too wide) in paragraph at lines 26182--26182 []\T1/cmtt/m/n/10 In addition, associated output variance estimates (if calcula ted) may be declared bad Overfull \hbox (7.7746pt too wide) in paragraph at lines 26182--26182 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array fo r similar reasons. [432] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 26767. Overfull \hbox (21.79875pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 void astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/z plm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, double wlim, int ndim_in, const int lbnd_in[], Overfull \hbox (14.93054pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T 1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int spread, const Overfull \hbox (0.85513pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 double params[], int flags, double tol, int maxpix, $\OML/zplm/ m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, in t ndim_out, Overfull \hbox (34.9718pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 const int lbnd_out[], const int ubnd_out[], const int lbnd[], c onst int ubnd[], $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to a []Mapping[], whose forward transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 coordinates of pixels in the input grid into the coordinate sys tem of the output Overfull \hbox (35.80116pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its []Nin[] attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates ([]Nout[] at tribute) should match Overfull \hbox (2.99667pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the number of output grid dimensions given by " ndim_out" . If " in" is NULL, Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This value is only used if the AST__REBINEND flag is specified via the " flags" Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter. It gives the required number of input pixel values w hich must contribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to an output pixel (i.e. the output pixel weight) in order for the output pixel Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value to be considered valid. If the sum of the input pixel wei ghts contributing Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to an output pixel is less than the supplied " wlim" value, the n the output pixel Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [433] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The number of dimensions in the input grid. This should be at l east one. Not Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the centre of the first pixel in the input grid along each d imension. Not Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the input data to be rebined. The numerical type of this array should match the Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 1- or 2-character type code appended to the function name (e.g. if you are using Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 rapidly (i.e. Fortran array indexing is used). If a NULL pointe r is supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 for " in" , then no data is added to the output arrays, but any initialisation Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 array. If neither the AST__USEVAR nor the AST__VARWGT flag is s et, no input variance Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates are required and this pointer will not be used. A NUL L pointer may Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for dividing eac h input data value Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 up amongst the corresponding output pixels. It may be used to s elect from a set Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of pre-defined schemes by supplying one of the values described in the " Pixel Overfull \hbox (17.07208pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Spreading Schemes" section in the description of the astRebin$\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 funct ions. If Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 a value of zero is supplied, then the default linear spreading scheme is used Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter values required by the pixel spreading scheme. If suc h parameters are Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 required, this will be noted in the " Pixel Spreading Schemes" section in the Overfull \hbox (31.60219pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 control over the rebinning operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [434] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the out put grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in adjacent panel will be higher, and may cause the edges of th e panel to be visible Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 when viewing the output image at high contrast. If this is a pr oblem, reduce Overfull \hbox (36.8509pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 performance, accurate results will still be obtained. Not used if " in" is NULL. Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 In all cases, this value is also used to flag any output elem ents in the " out" Overfull \hbox (5.09616pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (and " out_var" ) array(s) for which rebined values could not b e obtained (see Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the " Propagation of Missing Data" section below for details of the circumstances Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (47.61078pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [435] Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the first pixel in the region of the input grid which is to be included in Overfull \hbox (42.36206pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the last pixel in the region of the input grid which is to b e included in the Overfull \hbox (84.08937pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 region of the input grid which is to be included in the rebined output array. This Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 region should lie wholly within the extent of the input grid (a s defined by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 " lbnd_in" and " ubnd_in" arrays). Regions of the input grid ly ing outside this Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid. The Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 rebined data values will be added into the original contents of this array. The Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 numerical type of this array should match that of the " in" arr ay, and the data Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 storage order should be such that the index of the first grid d imension varies Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 most rapidly and that of the final dimension least rapidly (i.e . Fortran array Overfull \hbox (36.58847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A pointer to an array with the same type and size as the " out" array. This pointer Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 will only be used if the AST__USEVAR or AST__GENVAR flag is set in which case Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 variance estimates for the rebined data values will be added in to the array. If Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 neither the AST__USEVAR flag nor the AST__GENVAR flag is set, n o output variance Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates will be calculated and this pointer will not be used. A NULL pointer Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Pointer to an array of double, with one or two elements for eac h pixel in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output grid, depending on whether or not the AST__GENVAR flag h as been supplied Overfull \hbox (20.84232pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 via the " flags" parameter. If AST__GENVAR has not been specifi ed then the array Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should have one element for each output pixel, and it will be u sed to accumulate Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the weight associated with each output pixel. If AST__GENVAR ha s been specified Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 then the array should have two elements for each output pixel. The first half Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the array is again used to accumulate the weight associated with each output Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel, and the second half is used to accumulate the square of the weights. In Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 each half, the data storage order should be such that the index of the first grid Overfull \hbox (17.69308pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 dimension varies most rapidly and that of the final dimension l east rapidly (i.e. Overfull \hbox (21.10475pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 A pointer to an int64_t containing the number of input data val ues that have been Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 added into the output array so far. The supplied value is incre mented on exit Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by the number of input values used. The value is initially set to zero if the Overfull \hbox (13.7145pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 To select the appropriate rebinning function, you should repl ace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 function name astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match [436] Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 For example, astRebinSeqD would be used to process " double" da ta, while astRebinSeqI Overfull \hbox (14.93054pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note that, unlike astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/ n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 , the astRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 set of functions does not yet Overfull \hbox (23.25832pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__REBININIT: Used to mark the first call in a sequence. It indicates that Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the supplied " out" , " out_var" and " weights" arrays should b e filled with zeros Overfull \hbox (26.09103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 (thus over-writing any supplied values) before adding the rebin ned input data into Overfull \hbox (28.19052pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 them. This flag should be used when rebinning the first input a rray in a sequence. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__REBINEND: Used to mark the last call in a sequence. It causes each value Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the " out" and " out_var" arrays to be divided by a normalis ation factor before Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 being returned. The normalisation factor for each output data v alue is just the Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 corresponding value from the weights array. The normalisation f actor for each Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output variance value is the square of the data value normalisa tion factor (see Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also AST__CONSERVEFLUX). It also causes output data values to b e set bad if the Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 corresponding weight is less than the value supplied for parame ter " wlim" . It Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also causes any temporary values stored in the output variance array (see flag Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 AST__GENVAR below) to be converted into usable variance values. Note, this flag Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__USEVAR: Indicates that output variance estimates shoul d be created by rebinning Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the supplied input variance estimates. An error will be reporte d if both this Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__GENVAR: Indicates that output variance estimates shoul d be created based Overfull \hbox (10.60732pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 on the spread of input data values contributing to each output pixel. An error Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 will be reported if both this flag and the AST__USEVAR flag are supplied. If Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the AST__GENVAR flag is specified, the supplied output variance array is first Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 used as a work array to accumulate the temporary values needed to generate the Overfull \hbox (29.24026pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output variances. When the sequence ends (as indicated by the A ST__REBINEND flag), Overfull \hbox (26.6159pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the contents of the output variance array are converted into th e required variance Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 estimates. If the generation of such output variances is requir ed, this flag Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 should be used on every invocation of this function within a se quence, and any Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 supplied input variances will have no effect on the output vari ances (although Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input variances will still be used to weight the input data if the AST__VARWGT Overfull \hbox (52.8595pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 flag is also supplied). The statistical meaning of these output varianes is determined Overfull \hbox (43.93668pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__DISVAR: This flag is ignored unless the AST__GENVAR fl ag has also been specified. Overfull \hbox (58.10822pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 It determines the statistical meaning of the generated output v ariances. If AST__DISVAR Overfull \hbox (33.43924pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 is not specified, generated variances represent variances on th e output mean values. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 If AST__DISVAR is specified, the generated variances represent the variance of Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the distribution from which the input values were taken. Each o utput variance Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 created with AST__DISVAR will be larger than that created witho ut AST__DISVAR Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [437] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__VARWGT: Indicates that the input data should be weight ed by the reciprocal Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the input variances. Otherwise, all input data are given equ al weight. If Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 this flag is specified, the calculation of the output variances (if any) is modified Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 to take account of the varying weights assigned to the input da ta values. See Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__PARWGT: Indicates that a constant weight should be use d when pasting each Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel of the supplied input array into the returned arrays. Thi s extra weight Overfull \hbox (52.33463pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 value should be inserted at the start of the " params" array (w hich should consequently Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 be one element longer than specified in the " Pixel Spreading S chemes" section Overfull \hbox (6.57465pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the description of the astRebin$\OML/zplm/m/it/10 <$\T1/cmtt /m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 functions). If the AST__VARWGT f lag is Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 also specified, the total weight for each pixel is the product of the reciprocal Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the pixel variance and the value supplied in the last elemen t of the " params" Overfull \hbox (0.37231pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__NONORM: If the simple unnormalised sum of all input da ta falling in each Overfull \hbox (31.86462pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 output pixel is required, then this flag should be set on each call in the sequence Overfull \hbox (0.10988pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and the AST__REBINEND should not be used on the last call. In t his case NULL Overfull \hbox (16.11847pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pointers can be supplied for " weights" and " nused" . This fla g cannot be used Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 [][]\T1/cmtt/m/n/10 AST__CONSERVEFLUX: Indicates that the normalized output pix el values generated Overfull \hbox (21.36719pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 by the AST__REBINEND flag should be scaled in such a way as to preserve the total Overfull \hbox (5.62103pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 data value in a feature on the sky. Without this flag, each nor malised output Overfull \hbox (58.10822pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel value represents a weighted mean of the input data values around the corresponding Overfull \hbox (15.85603pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 input position. is appropriate if the input data represents the spatial density Overfull \hbox (37.11334pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of some quantity (e.g. surface brightness in Janskys per square arc-second) because Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 the output pixel values will have the same normalisation and un its as the input Overfull \hbox (5.3586pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 pixel values. However, if the input data values represent flux (or some other Overfull \hbox (1.94693pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 physical quantity) per pixel, then the AST__CONSERVEFLUX flag c ould be of use. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 It causes each output pixel value to be scaled by the ratio of the output pixel Overfull \hbox (18.0096pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 This flag can only be used if the Mapping is successfully appro ximated by one or more Overfull \hbox (2.52588pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 linear transformations. Thus an error will be reported if it us ed when the " tol" Overfull \hbox (2.52588pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 parameter is set to zero (which stops the use of linear approxi mations), or if the Overfull \hbox (4.1005pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 Mapping is too non-linear to be approximated by a piece-wise li near transformation. Overfull \hbox (44.25319pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 The ratio of output to input pixel size is evaluated once for e ach panel of the piece-wise Overfull \hbox (34.01819pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 linear approximation to the Mapping, and is assumed to be const ant for all output pixels Overfull \hbox (26.14511pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 in the panel. The scaling factors for adjacent panels will in g eneral differ slightly, Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and so the joints between panels may be visible when viewing th e output image at high Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 contrast. If this is a problem, reduce the value of the " tol" parameter until the Overfull \hbox (3.21706pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 This flag should normally be supplied on each invocation of a stRebinSeq$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/ m/n/10 within Overfull \hbox (2.26344pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Note, this flag cannot be used in conjunction with the AST__N OSCALE flag (an error Overfull \hbox (28.76947pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 Instances of missing data (bad pixels) in the output grid are identified by occurrences Overfull \hbox (39.2669pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [438] Overfull \hbox (7.51216pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 An input pixel is considered bad (and is consequently ignored ) if its data value is Overfull \hbox (18.27203pt too wide) in paragraph at lines 26767--26767 []\T1/cmtt/m/n/10 In addition, associated output variance estimates (if calcula ted) may be declared bad Overfull \hbox (7.7746pt too wide) in paragraph at lines 26767--26767 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array fo r similar reasons. [439] [440] Overfull \hbox (0.10988pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 The index within the FrameSet of the Frame to be modified. This value should Overfull \hbox (16.11847pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 lie in the range from 1 to the number of Frames in the FrameSet (as given by its Overfull \hbox (21.36719pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 Pointer to a Mapping whose forward transformation converts coor dinate values from Overfull \hbox (10.86975pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 the original coordinate system described by the Frame to the ne w one, and whose Overfull \hbox (0.10988pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter Overfull \hbox (31.86462pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 The relationship between the selected Frame and any other F rame within the FrameSet Overfull \hbox (15.85603pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 will be modified by this function, but the relationship between all other Frames Overfull \hbox (20.31744pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 The number of input coordinate values accepted by the Mappi ng (its []Nin[] attribute) Overfull \hbox (5.62103pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 and the number of output coordinate values generated (its []Nou t[] attribute) must Overfull \hbox (10.60732pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 If a simple change of axis order is required, then the []as tPermAxes[] function may Overfull \hbox (38.68796pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 provide a more straightforward method of making the required ch anges to the FrameSet. Overfull \hbox (23.99155pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 This function cannot be used to change the number of Frame axes. To achieve this, Overfull \hbox (37.11334pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 a new Frame must be added to the FrameSet ([]astAddFrame[]) and the original one removed Overfull \hbox (10.86975pt too wide) in paragraph at lines 26870--26870 [][]\T1/cmtt/m/n/10 Any variant Mappings associated with the remapped Frame (ex cept for the current Overfull \hbox (5.3586pt too wide) in paragraph at lines 26870--26870 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [441] Overfull \hbox (17.43065pt too wide) in paragraph at lines 26899--26899 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [442] Overfull \hbox (15.85603pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 The index within the FrameSet of the Frame to be removed. This value should lie Overfull \hbox (31.86462pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 in the range from 1 to the number of Frames in the FrameSet (as given by its []Nframe[] Overfull \hbox (10.60732pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 Removing a Frame from a FrameSet does not affect the relati onship between other Overfull \hbox (33.43924pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 Frames in the FrameSet, even if they originally depended on the Frame being removed. Overfull \hbox (31.86462pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 The number of Frames in a FrameSet cannot be reduced to zer o. An error will result Overfull \hbox (0.10988pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 A value of AST__BASE or AST__CURRENT may be given for the " iframe" parameter Overfull \hbox (16.11847pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 If a FrameSet' s base or current Frame is removed, the []Ba se[] or []Current[] attribute Overfull \hbox (20.84232pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 (respectively) of the FrameSet will have its value cleared, so that another Frame Overfull \hbox (12.44437pt too wide) in paragraph at lines 26958--26958 [][]\T1/cmtt/m/n/10 If any other Frame is removed, the base and current Frames will remain the same. Overfull \hbox (28.97783pt too wide) in paragraph at lines 26958--26958 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [443] Overfull \hbox (33.1768pt too wide) in paragraph at lines 26987--26987 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [444] Overfull \hbox (18.27203pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a CmpFrame, any component Frames tha t are instances of the Overfull \hbox (44.51563pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a FrameSet, the returned Mapping wil l be a copy of the supplied Overfull \hbox (2.52588pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 FrameSet in which Regions have been removed from all the inter- Frame Mappings, and Overfull \hbox (30.34409pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 any Frames which are instances of the Region class are repalced by the equivalent Frame. Overfull \hbox (25.09537pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If the supplied Mapping is a Region, the returned Mapping will be the equivalent Frame. Overfull \hbox (1.94693pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 This function can safely be applied even to Mappings which contain no Regions. Overfull \hbox (10.60732pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 If no Regions are found, it behaves exactly like []astClone[] a nd returns a pointer Overfull \hbox (26.6159pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 The Mapping returned by this function may not be independen t of the original (even Overfull \hbox (16.11847pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 if some Regions were removed), and modifying it may therefore r esult in indirect Overfull \hbox (2.99667pt too wide) in paragraph at lines 27070--27070 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, Overfull \hbox (5.62103pt too wide) in paragraph at lines 27070--27070 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [445] [446] Overfull \hbox (21.10475pt too wide) in paragraph at lines 27126--27126 \T1/cmtt/m/n/10 The key indicating which tables to exist. A single key or a com ma-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 27126--27126 \T1/cmtt/m/n/10 of keys can be supplied. If a blank string is supplied, all tab les are removed. Underfull \hbox (badness 10000) in paragraph at lines 27126--27126 [447] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27957. Overfull \hbox (3.69067pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 int astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 this, int ndim_in, const int lbnd_in[], const int Overfull \hbox (25.63916pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OM L/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n /10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int interp, void ($\OM S/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 finterp)( Overfull \hbox (0.5927pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 void ), const double params[], int flags, double tol, int maxpi x, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n /10 badval, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [448] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to a Mapping, whose inverse transformation will be used to transform the Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinates of pixels in the output grid into the coordinate sy stem of the input Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 grid. This yields the positions which are used to obtain resamp led values by Overfull \hbox (35.80116pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The number of input coordinates used by this Mapping (as give n by its []Nin[] attribute) Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 should match the number of input grid dimensions given by the v alue of " ndim_in" Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 below. Similarly, the number of output coordinates ([]Nout[] at tribute) should match Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape and size of the Overfull \hbox (66.19566pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 input grid, its extent along a particular (j' th) dimension bei ng ubnd_in[j]-lbnd_in[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input data to be resampled. The numerical type of this arra y should match Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the 1- or 2-character type code appended to the function name ( e.g. if you are Overfull \hbox (15.85603pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 first grid dimension varies most rapidly and that of the final dimension least Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to a second array with the same size and ty pe as the " in" Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array. If given, this should contain a set of non-negative valu es which represent Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 estimates of the statistical variance associated with each elem ent of the " in" Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array. If this array is supplied (together with the correspondi ng " out_var" Overfull \hbox (49.1854pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array), then estimates of the variance of the resampled output data will be calculated. Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no input variance estimates are being provided, a NULL poi nter should be given. Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This parameter specifies the scheme to be used for sub-pixel in terpolation within Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input grid. It may be used to select from a set of pre-defi ned schemes by Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 supplying one of the values described in the " Sub-Pixel Interp olation Schemes" Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 section below. If a value of zero is supplied, then the default linear interpolation Overfull \hbox (15.5936pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Alternatively, you may supply a value which indicates that yo u will provide your Overfull \hbox (43.93668pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 own function to perform sub-pixel interpolation by means of the " finterp " parameter. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If the value given for the " interp" parameter indicates that y ou will provide Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 your own function for sub-pixel interpolation, then a pointer t o that function Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 should be given here. For details of the interface which the fu nction should Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [449] Overfull \hbox (52.8595pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If the " interp" parameter has any other value, corresponding to one of the pre-defined Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation schemes, then this function will not be used and you may supply Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to an array of double which should contain any additional Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 parameter values required by the sub-pixel interpolation scheme . If such parameters Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 are required, this will be noted in the " Sub-Pixel Interpolati on Schemes" section Overfull \hbox (43.93668pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 below (you may also use this array to pass values to your own i nterpolation function). Overfull \hbox (31.60219pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 control over the resampling operation. See the " Control Flags" section below Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This should be expressed as a displacement in pixels in the inp ut grid' s coordinate Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in pixels) for t he adaptive algorithm Overfull \hbox (1.6845pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which approximates non-linear Mappings with piece-wise linear t ransformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the output grid being used). In this case, a first attempt t o approximate Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the Mapping by a linear transformation will be made over the en tire output region. Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If a smaller value is used, the output region will first be d ivided into sub-regions Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" pixels in any dimension. O nly at this point Overfull \hbox (42.09962pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 100 pixels can also be employed as a safeguard in general-purpo se software, since Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This argument should have the same type as the elements of the " in" array. It Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels) in t he input and output Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Unless the AST__NOBAD flag is set via the " flags" parameter, this value is also Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 used to flag any output elements in the " out" (and " out_var" ) array(s) for Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which resampled values could not be obtained (see the " Propaga tion of Missing Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Data" section below for details of the circumstances under whic h this may occur). Overfull \hbox (16.80965pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm /m/it/10 >$ \T1/cmtt/m/n/10 function return value indicates whether any such va lues have Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 been produced. If the AST__NOBAD flag is set. then output array elements for Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [450] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The number of dimensions in the output grid. This should be at least one. It Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd_out" and " ubnd_out" together define the sha pe, size and coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the first pixel in the region of the output grid for which a resampled value Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the last pixel in the region of the output grid for which a resampled value Overfull \hbox (84.08937pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and p osition of a (hyper-)rectangular Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 region of the output grid for which resampled values should be produced. This Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 region should lie wholly within the extent of the output grid ( as defined by the Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " lbnd_out" and " ubnd_out" arrays). Regions of the output grid lying outside Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in the out put grid, into Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 which the resampled data values will be returned. The numerical type of this Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 array should match that of the " in" array, and the data storag e order should Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 be such that the index of the first grid dimension varies most rapidly and that Overfull \hbox (12.18193pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An optional pointer to an array with the same type and size as the " out" array. Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If given, this array will be used to return variance estimates for the resampled Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 data values. This array will only be used if the " in_var" arra y has also been Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The output variance values will be calculated on the assumpti on that errors on Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the input data values are statistically independent and that th eir variance estimates Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may simply be summed (with appropriate weighting factors) when several input pixels Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 contribute to an output data value. If this assumption is not v alid, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output error estimates may be biased. In addition, note that th e statistical Overfull \hbox (36.0636pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 errors on neighbouring output data values (as well as the estim ates of those errors) Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may often be correlated, even if the above assumption about the input data is Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 If no output variance estimates are required, a NULL pointer should be given. Overfull \hbox (31.1314pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The number of output pixels for which no valid resampled value could be obtained. Thus, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the absence of any error, a returned value of zero indicates that all the required Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [451] Overfull \hbox (26.35347pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (18.96321pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 To select the appropriate resampling function, you should rep lace $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/1 0 in the generic Overfull \hbox (19.22565pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function name astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X $\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 with a 1- or 2-character data type code, so as to match Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 For example, astResampleD would be used to process " double" da ta, while astResampleS Overfull \hbox (10.13652pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 There is no such thing as a perfect sub-pixel interpolation s cheme and, in practice, Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 all resampling will result in some degradation of gridded data. A range of schemes Overfull \hbox (14.59793pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is therefore provided, from which you can choose the one which best suits your needs. Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 In general, a balance must be struck between schemes which te nd to degrade sharp features Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the data by smoothing them, and those which attempt to prese rve sharp features. The Overfull \hbox (44.51563pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 latter will often tend to introduce unwanted oscillations, typi cally visible as " ringing" Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 around sharp features and edges, especially if the data are und er-sampled (i.e. if Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the sharpest features are less than about two pixels across). I n practice, a good Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation scheme is likely to be a compromise and may exhib it some aspects of both Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 For under-sampled data, some interpolation schemes may appear to preserve data resolution Overfull \hbox (49.76434pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 because they transform single input pixels into single output p ixels, rather than spreading Overfull \hbox (5.15024pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 their data between several output pixels. While this may look b etter cosmetically, Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 it can result in a geometrical shift of sharp features in the d ata. You should beware Overfull \hbox (17.74716pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The following are two easy-to-use sub-pixel interpolation sch emes which are generally Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 applicable. They are selected by supplying the appropriate valu e (defined in the " Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 ast.h" header file) via the " interp" parameter. In these cases , the " finterp" and Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__NEAREST: This is the simplest possible scheme, in whic h the value of the Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 input pixel with the nearest centre to the interpolation point is used. This Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is very quick to execute and will preserve single-pixel feature s in the data, but Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 may displace them by up to half their width along each dimensio n. It often gives Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [452] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__LINEAR: This is the default scheme, which uses linear interpolation between Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the nearest neighbouring pixels in the input grid (there are tw o neighbours in Overfull \hbox (28.19052pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 one dimension, four neighbours in two dimensions, eight in thre e dimensions, etc.). Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 It is superior to the nearest-pixel scheme (above) in not displ acing features Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the data, yet it still executes fairly rapidly. It is genera lly a safe choice Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 if you do not have any particular reason to favour another sche me, since it cannot Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 introduce oscillations. However, it does introduce some spatial smoothing which Overfull \hbox (21.10475pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 varies according to the distance of the interpolation point fro m the neighbouring Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixels. This can degrade the shape of sharp features in the dat a in a position-dependent Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 way. It may also show in the output variance grid (if used) as a pattern of stripes Overfull \hbox (23.25832pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 An alternative set of interpolation schemes is based on forming the interpolated value Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 from the weighted sum of a set of surrounding pixel values (not necessarily just the Overfull \hbox (26.14511pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 nearest neighbours). This approach has its origins in the theor y of digital filtering, Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in which interpolated values are obtained by conceptually passi ng the sampled data Overfull \hbox (7.24973pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (represented by a grid of delta functions) through a linear fil ter which implements Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a convolution. Because the convolution kernel is continuous, th e convolution yields Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a continuous function which may then be evaluated at fractional pixel positions. The Overfull \hbox (2.001pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (possibly multi-dimensional) kernel is usually regarded as " se parable" and formed Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 from the product of a set of identical 1-dimensional kernel fun ctions, evaluated along Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 each dimension. Different interpolation schemes are then distin guished by the choice Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of this 1-dimensional interpolation kernel. The number of surro unding pixels which Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 From a practical standpoint, it is useful to divide the weigh ted sum of pixel values Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 by the sum of the weights when determining the interpolated val ue. Strictly, this Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means that a true convolution is no longer being performed. How ever, the distinction Overfull \hbox (34.01819pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is rarely important in practice because (for slightly subtle re asons) the sum of weights Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is always approximately constant for good interpolation kernels . The advantage of Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 this technique, which is used here, is that it can easily accom modate missing data Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 In the following schemes, which are based on a 1-dimensional interpolation kernel, the Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 first element of the " params" array should be used to specify how many pixels are Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to contribute to the interpolated result on either side of the interpolation point Overfull \hbox (33.75575pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in each dimension (the nearest integer value is used). Executio n time increases rapidly Overfull \hbox (12.76088pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with this number. Typically, a value of 2 is appropriate and th e minimum value used Overfull \hbox (24.83293pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will be 1 (i.e. two pixels altogether, one on either side of th e interpolation point). Overfull \hbox (33.49332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 A value of zero or less may be given for " params[0]" to indica te that a suitable number Overfull \hbox (16.54083pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__GAUSS: This scheme uses a kernel of the form exp(-k$\O MS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), w ith k a positive Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 constant. The full-width at half-maximum (FWHM) is given by " p arams[1]" to zero Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will select the number of contributing pixels so as to utilise the width of the Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 kernel out to where the envelope declines to 1% of its maximum value). This kernel Overfull \hbox (21.57837pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINC: This scheme uses a sinc(pi$\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 x) kernel, where x is the pixel offset from Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the interpolation point and sinc(z)=sin(z)/z. This sometimes fe atures as an " Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 optimal" interpolation kernel in books on image processing. Its supposed optimality Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 depends on the assumption that the data are band-limited (i.e. have no spatial Overfull \hbox (63.35693pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 frequencies above a certain value) and are adequately sampled. In practice, astronomical Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 data rarely meet these requirements. In addition, high spatial frequencies are Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 often present due (e.g.) to image defects and cosmic ray events . Consequently, Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 substantial ringing can be experienced with this kernel. The ke rnel also decays Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 slowly with distance, so that many surrounding pixels are requi red, leading to Overfull \hbox (29.24026pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 poor performance. Abruptly truncating it, by using only a few n eighbouring pixels, Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 improves performance and may reduce ringing (if " params[0]" is set to zero, then Overfull \hbox (23.99155pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 only two pixels will be used on either side). However, a more g radual truncation, Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [453] Overfull \hbox (56.1174pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCSINC: This scheme uses an improved kernel, of the form sinc(pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).sinc(k$\OMS/zplm/m/n/10 ^^ C$\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), Overfull \hbox (0.53224pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with k a constant, out to the point where sinc(k$\OMS/zplm/m/n/ 10 ^^C$\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and zero Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 beyond. The second sinc() factor provides an " envelope" which gradually rolls Overfull \hbox (5.83221pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 off the normal sinc(pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) kernel at large offsets. The width of this envelope Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is specified by giving the number of pixels offset at which it goes to zero by Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means of the " params[1]" value, which should be at least 1.0 ( in addition, setting Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to zero will select the number of contributing pix els so as to utilise Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the full width of the kernel, out to where it reaches zero). Th e case given by Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]=2, params[1]=2" is typically a good choice and is s ometimes known Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as the Lanczos kernel. This is a valuable general-purpose inter polation scheme, Overfull \hbox (37.11334pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 intermediate in its visual effect on images between the AST__NE AREST and AST__LINEAR Overfull \hbox (52.8595pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 schemes. Although the kernel is slightly oscillatory, ringing i s adequately suppressed Overfull \hbox (16.75201pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCCOS: This scheme uses a kernel of the form sinc(pi $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).cos(k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (7.61801pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a constant, out to the point where cos(k$\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and z ero beyond. Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 As above, the cos() factor provides an envelope which gradually rolls off the Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 sinc() kernel at large offsets. The width of this envelope is s pecified by giving Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the number of pixels offset at which it goes to zero by means o f the " params[1]" Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 value, which should be at least 1.0 (in addition, setting " par ams[0]" to zero Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 will select the number of contributing pixels so as to utilise the full width Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 of the kernel, out to where it reaches zero). This scheme gives similar results Overfull \hbox (27.24945pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SINCGAUSS: This scheme uses a kernel of the form sinc( pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).exp(-k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 x$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a positive constant. Here, the sinc() kernel is rolled off us ing a Gaussian Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 envelope which is specified by giving its full-width at half-ma ximum (FWHM) by Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 means of the " params[1]" value, which should be at least 0.1 ( in addition, setting Overfull \hbox (31.86462pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to zero will select the number of contributing pix els so as to utilise Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the width of the kernel out to where the envelope declines to 1 % of its maximum Overfull \hbox (10.34488pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 value). On astronomical images and spectra, good results are of ten obtained by Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 approximately matching the FWHM of the envelope function, given by " params[1]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 , to the point spread function of the input data. However, ther e does not seem Overfull \hbox (11.08093pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SOMB: This scheme uses a somb(pi$\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 x) kernel (a " sombrero" function), where Overfull \hbox (10.8185pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 x is the pixel offset from the interpolation point and somb(z)= 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 J1(z)/z (J1 is Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 a Bessel function of the first kind of order 1). It is similar to the AST__SINC Overfull \hbox (16.75201pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__SOMBCOS: This scheme uses a kernel of the form somb(pi $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x).cos(k$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x), with Overfull \hbox (7.61801pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 k a constant, out to the point where cos(k$\OMS/zplm/m/n/10 ^^C $\T1/cmtt/m/n/10 pi$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 x) goes to zero, and z ero beyond. Overfull \hbox (23.52075pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [454] Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__BLOCKAVE: This scheme simply takes an average of all t he pixels on the input Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 grid in a cube centred on the interpolation point. The number o f pixels in the Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 cube is determined by the value of the first element of the " p arams" array, which Overfull \hbox (17.69308pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 gives the number of pixels in each dimension on either side of the central point. Overfull \hbox (26.82709pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Hence a block of (2 $\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 para ms[0])$[]$ndim_in pixels in the input grid will be examined Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to determine the value of the output pixel. If the variance is not being used Overfull \hbox (5.09616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (var_in or var_out = NULL) then all valid pixels in this cube w ill be averaged Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in to the result with equal weight. If variances are being used , then each input Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel will be weighted proportionally to the reciprocal of its variance; any pixel Overfull \hbox (5.3586pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 without a valid variance will be discarded. This scheme is suit able where the Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 output grid is much coarser than the input grid; if the ratio o f pixel sizes is Overfull \hbox (2.26344pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Finally, supplying the following values for " interp" allows yo u to implement your Overfull \hbox (12.76088pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 own sub-pixel interpolation scheme by means of your own functio n. You should supply Overfull \hbox (47.61078pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__UKERN1: In this scheme, you supply a function to evalu ate your own 1-dimensional Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation kernel, which is then used to perform sub-pixel i nterpolation (as Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 described above). The function you supply should have the same interface as the Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 fictitious []astUkern1[] function (q.v.). In addition, a value should be given via Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 " params[0]" to specify the number of neighbouring pixels which are to contribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to each interpolated value (in the same way as for the pre-defi ned interpolation Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 schemes described above). Other elements of the " params" array are available Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__UINTERP: This is a completely general scheme, in which your interpolation Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function has access to all of the input data. This allows you t o implement any Overfull \hbox (10.60732pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation algorithm you choose, which could (for example) b e non-linear, or Overfull \hbox (38.06696pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 adaptive. In this case, the astResample$\OML/zplm/m/it/10 <$\T1 /cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 functions play no role in t he sub-pixel Overfull \hbox (42.36206pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 interpolation process and simply handle the geometrical transfo rmation of coordinates Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and other housekeeping. The function you supply should have the same interface Overfull \hbox (36.8509pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 as the fictitious []astUinterp[] function (q.v.). In this case, the " params" parameter Overfull \hbox (43.31567pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is not used by astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 , but is available to pass values to your interpolation Overfull \hbox (23.25832pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 The following flags are defined in the " ast.h" header file a nd may be used to provide Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 additional control over the resampling process. Having selected a set of flags, you Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__NOBAD: Indicates that any output array elements for wh ich no resampled value Overfull \hbox (38.68796pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 could be obtained should be left set to the value they had on e ntry to this function. Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If this flag is not supplied, such output array elements are se t to the value Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 supplied for parameter " badval" . Note, this flag cannot be us ed in conjunction Overfull \hbox (54.17168pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 with the AST__CONSERVEFLUX flag (an error will be reported if b oth flags are specified). Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__URESAMP1, 2, 3 & 4: A set of four flags which are rese rved for your own Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 use. They may be used to pass private information to any sub-pi xel interpolation Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 function which you implement yourself. They are ignored by all the pre-defined Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array(s) which Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 must be recognised by comparing with the value given for " badv al" and propagated Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 to the output array(s). If this flag is not set, all input valu es are treated Overfull \hbox (12.44437pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [455] Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 AST__CONSERVEFLUX: Indicates that the output pixel values s hould be scaled in Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 such a way as to preserve (approximately) the total data value in a feature on Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the sky. Without this flag, each output pixel value represents an instantaneous Overfull \hbox (0.37231pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 sample of the input data values at the corresponding input posi tion. This is Overfull \hbox (0.10988pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 appropriate if the input data represents the spatial density of some quantity Overfull \hbox (5.09616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 (e.g. surface brightness in Janskys per square arc-second) beca use the output Overfull \hbox (22.9418pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel values will have the same normalisation and units as the input pixel values. Overfull \hbox (25.56616pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 However, if the input data values represent flux (or some other physical quantity) Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 per pixel, then the AST__CONSERVEFLUX flag could be used. This causes each output Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 pixel value to be scaled by the ratio of the output pixel size to the input pixel Overfull \hbox (18.0096pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 This flag can only be used if the Mapping is successfully appro ximated by one or more Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 linear transformations. Thus an error will be reported if it us ed when the " tol" Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 parameter is set to zero (which stops the use of linear approxi mations), or if the Overfull \hbox (4.1005pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 Mapping is too non-linear to be approximated by a piece-wise li near transformation. Overfull \hbox (44.25319pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 The ratio of output to input pixel size is evaluated once for e ach panel of the piece-wise Overfull \hbox (34.01819pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 linear approximation to the Mapping, and is assumed to be const ant for all output pixels Overfull \hbox (26.14511pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 in the panel. The scaling factors for adjacent panels will in g eneral differ slightly, Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and so the joints between panels may be visible when viewing th e output image at high Overfull \hbox (7.7746pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 contrast. If this is a problem, reduce the value of the " tol" parameter until the Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Note, this flag cannot be used in conjunction with the AST__N OBAD flag (an error will Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 []\T1/cmtt/m/n/10 Unless the AST__NOBAD flag is specified, instances of missing data (bad pixels) in Overfull \hbox (2.52588pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 the output grid are identified by occurrences of the " badval" value in the " out" Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The input position (the transformed position of the output pixel' s centre) lies Overfull \hbox (29.24026pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The input position lies inside the boundary of a bad input pixel. In this context, Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 an input pixel is considered bad if its data value is equal to " badval" and the Overfull \hbox (57.84578pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 AST__USEBAD flag is set via the " flags" parameter. (Positions which have half-integral Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 coordinate values, and therefore lie on a pixel boundary, are r egarded as lying Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels (excluding those which are bad) is unsuitable Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 for calculating an interpolated value. Whether this is true may depend on the Overfull \hbox (16.11847pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The interpolated value lies outside the range which can be represented using the Overfull \hbox (18.27203pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 In addition, associated output variance estimates (if calculate d) may be declared bad Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 and flagged with the " badval" value in the " out_var" array un der any of the following Overfull \hbox (10.86975pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels which contributed to t he output data value Overfull \hbox (13.49411pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 do not all have valid variance estimates associated with them. In this context, Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [456] Overfull \hbox (26.6159pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The set of neighbouring input pixels for which valid varian ce values are available Overfull \hbox (5.62103pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 is unsuitable for calculating an overall variance value. Whethe r this is true Overfull \hbox (21.36719pt too wide) in paragraph at lines 27957--27957 [][]\T1/cmtt/m/n/10 The variance value lies outside the range which can be repr esented using the data Overfull \hbox (28.76947pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 If the AST__NOBAD flag is specified via parameter " flags" , th en output array elements Overfull \hbox (13.02332pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 that would otherwise be set to " badval" are instead left holdi ng the value they had Overfull \hbox (39.2669pt too wide) in paragraph at lines 27957--27957 \T1/cmtt/m/n/10 on entry to this function. The number of such array elements is returned as the function [457] Overfull \hbox (12.97206pt too wide) in paragraph at lines 28039--28039 []\T1/cmtt/m/n/10 void astResolve( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, const double point1[], const double point2[], const Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Nax es[] attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute). This Overfull \hbox (21.10475pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis in whi ch the coordinates Overfull \hbox (17.69308pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28039--28039 [] \T1/cmtt/m/n/10 The address of a location at which to return the distance from point 1 to point Overfull \hbox (15.85603pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.86975pt too wide) in paragraph at lines 28039--28039 [] \T1/cmtt/m/n/10 The address of a location at which to return the distance from point 4 to point Overfull \hbox (16.11847pt too wide) in paragraph at lines 28039--28039 \T1/cmtt/m/n/10 3 (that is, the length of the component perpendicular to the ba sis vector). The Overfull \hbox (5.62103pt too wide) in paragraph at lines 28039--28039 [][]\T1/cmtt/m/n/10 Each vector used in this function is the path of shortest d istance between two Overfull \hbox (21.36719pt too wide) in paragraph at lines 28039--28039 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [458] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28080--28080 [][]\T1/cmtt/m/n/10 This function returns without action if the FitsChan is ini tially positioned at Overfull \hbox (5.62103pt too wide) in paragraph at lines 28080--28080 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the []Card[] attribute exceeds the number of cards in [459] Overfull \hbox (16.11847pt too wide) in paragraph at lines 28131--28131 [][]\T1/cmtt/m/n/10 Two independent Objects that happen to be identical are not considered to be the Overfull \hbox (10.60732pt too wide) in paragraph at lines 28131--28131 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [460] Overfull \hbox (23.41824pt too wide) in paragraph at lines 28232--28232 []\T1/cmtt/m/n/10 AstSelectorMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSelec torMap( int nreg, AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 regs[], doubl e badval, const char Overfull \hbox (0.10988pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 An array of pointers to the Regions. All the supplied Regions m ust relate to Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 the same coordinate Frame. The number of axes in this coordinat e Frame defines Overfull \hbox (20.84232pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 The value to be returned by the forward transformation of the S electorMap for any Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Se lectorMap. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 syntax used is identical to that for the []astSet[] function an d may include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 28232--28232 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [461] Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 [][]\T1/cmtt/m/n/10 Deep copies are taken of the supplied Regions. This means t hat any subsequent Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 \T1/cmtt/m/n/10 changes made to the component Regions using the supplied pointe rs will have no Overfull \hbox (5.62103pt too wide) in paragraph at lines 28232--28232 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [462] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing a comm a-separated list Overfull \hbox (0.37231pt too wide) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the Report attribute for Object " map" to the value 1 a nd the Zoom Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the []Label(axis)[] attribute for Object " frame" to a suitable string, where Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 Underfull \hbox (badness 10000) in paragraph at lines 28338--28338 [] \T1/cmtt/m/n/10 Sets the Title attribute for Object " frame" to the contents of the string " Overfull \hbox (26.6159pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 White space may also surround attribute values, where it wi ll generally be ignored Overfull \hbox (5.09616pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [463] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 To include a literal comma in the value assigned to an attr ibute, the whole attribute Overfull \hbox (10.60732pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 value should be enclosed in quotation markes. Alternatively, yo u can use " %s" Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 format and supply the value as a separate additional argument t o astSet (or use Overfull \hbox (5.62103pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 The same procedure may be adopted if " %" signs are to be i ncluded and are not Overfull \hbox (10.86975pt too wide) in paragraph at lines 28338--28338 \T1/cmtt/m/n/10 to be interpreted as format specifiers (alternatively, the " pr intf" convention Overfull \hbox (33.43924pt too wide) in paragraph at lines 28338--28338 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [464] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28410. Overfull \hbox (26.6159pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the na me of the attribute Overfull \hbox (1.06349pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 The value to be set for the attribute, in the data type corresp onding to $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (52.33463pt too wide) in paragraph at lines 28410--28410 \T1/cmtt/m/n/10 (or, in the case of astSetC, a pointer to a null-terminated cha racter string containing Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 Underfull \hbox (badness 10000) in paragraph at lines 28410--28410 [] \T1/cmtt/m/n/10 Sets the Format(1) attribute value for Object " plot" to the character string Overfull \hbox (33.43924pt too wide) in paragraph at lines 28410--28410 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [465] Overfull \hbox (23.25832pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [466] Overfull \hbox (28.50703pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a SpecFrame is always 1 (any value supp lied using this function Overfull \hbox (28.50703pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The ActiveUnit flag for a FluxFrame is always 1 (any value supp lied using this function Overfull \hbox (7.51216pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 The default ActiveUnit flag for a CmpFrame is 1 if both of the component Frames are Overfull \hbox (7.7746pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 using active units, and zero otherwise. When a new value is set for the ActiveUnit Overfull \hbox (44.51563pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 flag, the flag value is propagated to the component Frames. Thi s change will be reflected Overfull \hbox (2.52588pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 through all references to the component Frames, not just those encapsulated within Overfull \hbox (16.11847pt too wide) in paragraph at lines 28536--28536 [][]\T1/cmtt/m/n/10 The ActiveUnit flag resembles a Frame attribute, except tha t it cannot be tested Overfull \hbox (23.27441pt too wide) in paragraph at lines 28536--28536 \T1/cmtt/m/n/10 or cleared, and it cannot be accessed using the generic []astGe t$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$[] \T1/cmtt/m/n/10 and []astSet$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$[] Overfull \hbox (5.62103pt too wide) in paragraph at lines 28536--28536 [][]\T1/cmtt/m/n/10 The []astGetActiveUnit[] function can be used to retrieve t he current value of the [467] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28686. Overfull \hbox (14.82803pt too wide) in paragraph at lines 28686--28686 []\T1/cmtt/m/n/10 void astSetFits$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zp lm/m/it/10 >$\T1/cmtt/m/n/10 ( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, $\OML/zplm/m/it/ 10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 type value, const ch ar Overfull \hbox (7.19565pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (31.33975pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 The keyword value to store with the named keyword. The data typ e of this parameter Overfull \hbox (5.3586pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 A pointer to a null terminated string holding a comment to asso ciated with the Overfull \hbox (37.11334pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 keyword. If a NULL pointer or a blank string is supplied, then any comment included Overfull \hbox (0.37231pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 in the string supplied for the " name" parameter is used instea d. If " name" Overfull \hbox (0.37231pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [468] Overfull \hbox (26.6159pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 If non-zero, the new card formed from the supplied keyword name , value and comment Overfull \hbox (21.10475pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 string over-writes the current card, and the current card is in cremented to refer Overfull \hbox (16.11847pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 to the next card (see the " []Card[]" attribute). If zero, the new card is inserted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 in front of the current card and the current card is left uncha nged. In either Overfull \hbox (5.62103pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 case, if the current card on entry points to the " end-of-file" , the new card Overfull \hbox (21.36719pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 The function []astSetFitsU[] can be used to indicate that n o value is associated with Overfull \hbox (16.11847pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 The function []astSetFitsCM[] can be used to store a pure c omment card (i.e. a card Overfull \hbox (10.86975pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 To assign a new value for an existing keyword within a Fits Chan, first find the Overfull \hbox (43.31567pt too wide) in paragraph at lines 28686--28686 \T1/cmtt/m/n/10 card describing the keyword using []astFindFits[], and then use one of the astSetFits$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (21.36719pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then Overfull \hbox (33.43924pt too wide) in paragraph at lines 28686--28686 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [469] Overfull \hbox (10.60732pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 A pointer to a null terminated string holding the text of the c omment card. If Overfull \hbox (33.43924pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 a NULL pointer or a blank string is supplied, then a totally bl ank card is produced. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 If non-zero, the new card over-writes the current card, and the current card is Overfull \hbox (16.11847pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 incremented to refer to the next card (see the " []Card[]" attr ibute). If zero, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 new card is inserted in front of the current card and the curre nt card is left Overfull \hbox (42.36206pt too wide) in paragraph at lines 28740--28740 \T1/cmtt/m/n/10 unchanged. In either case, if the current card on entry points to the " end-of-file" Overfull \hbox (21.36719pt too wide) in paragraph at lines 28740--28740 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [470] Overfull \hbox (39.63802pt too wide) in paragraph at lines 28812--28812 []\T1/cmtt/m/n/10 void astSetFitsU( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/ m/n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 name, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 comment, int overwrite Overfull \hbox (7.19565pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (5.3586pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 A pointer to a null terminated string holding a comment to asso ciated with the Overfull \hbox (37.11334pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 keyword. If a NULL pointer or a blank string is supplied, then any comment included Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 in the string supplied for the " name" parameter is used instea d. If " name" Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written Overfull \hbox (26.6159pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 If non-zero, the new card formed from the supplied keyword name and comment string Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 over-writes the current card, and the current card is increment ed to refer to Overfull \hbox (0.37231pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 the next card (see the " []Card[]" attribute). If zero, the new card is inserted Overfull \hbox (10.60732pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 in front of the current card and the current card is left uncha nged. In either Overfull \hbox (5.62103pt too wide) in paragraph at lines 28812--28812 \T1/cmtt/m/n/10 case, if the current card on entry points to the " end-of-file" , the new card Overfull \hbox (21.36719pt too wide) in paragraph at lines 28812--28812 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then Overfull \hbox (33.43924pt too wide) in paragraph at lines 28812--28812 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [471] Overfull \hbox (5.3586pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 A Pointer to the function to be used to handle errors. The inte rface for this Overfull \hbox (10.60732pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 function is described below. Once a function has been provided, a NULL pointer Overfull \hbox (0.37231pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 can be supplied in a subsequent call to astSetPutErr to reset t he function to Overfull \hbox (37.95473pt too wide) in paragraph at lines 28864--28864 []\T1/cmtt/m/n/10 The supplied external function should deliver the supplied er ror message and (optionally) Overfull \hbox (23.52075pt too wide) in paragraph at lines 28864--28864 \T1/cmtt/m/n/10 the supplied status value to the user or to some underlying err or system. It requires Overfull \hbox (37.11334pt too wide) in paragraph at lines 28864--28864 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [472] Overfull \hbox (5.62103pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 Pointer to the SkyFrame which defines the celestial coordinate system in which Overfull \hbox (5.62103pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 the longitude and latitude values are supplied. If NULL is supp lied, then the Overfull \hbox (0.37231pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 supplied longitude and latitude values are assumed to be FK5 J2 000 RA and Dec Overfull \hbox (21.10475pt too wide) in paragraph at lines 28908--28908 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 28908--28908 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [473] Overfull \hbox (0.37231pt too wide) in paragraph at lines 28946--28946 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value, most AST functions will not Overfull \hbox (0.37231pt too wide) in paragraph at lines 28946--28946 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [474] Overfull \hbox (0.37231pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 Pointer to the new uncertainty Region. This must be of a class for which all Overfull \hbox (10.86975pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 instances are centro-symetric (e.g. []Box[], []Circle[], []Elli pse[], etc.) or be a []Prism[] Overfull \hbox (21.36719pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 containing centro-symetric component Regions. A deep copy of th e supplied Region Overfull \hbox (21.10475pt too wide) in paragraph at lines 28988--28988 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [475] Overfull \hbox (9.50914pt too wide) in paragraph at lines 29065--29065 []\T1/cmtt/m/n/10 AstShiftMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astShiftMap ( int ncoord, const double shift[], const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 options, ... Overfull \hbox (26.09103pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number Overfull \hbox (10.34488pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 An array containing the values to be added on to the input coor dinates in order Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 to create the output coordinates. A separate value should be su pplied for each Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sh iftMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 29065--29065 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 29065--29065 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 29065--29065 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 29065--29065 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [476] [477] [478] Overfull \hbox (42.09962pt too wide) in paragraph at lines 29153--29153 \T1/cmtt/m/n/10 A boolean value indicating if the displayed axis values should be formatted according Overfull \hbox (10.86975pt too wide) in paragraph at lines 29153--29153 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [479] Overfull \hbox (44.51563pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 If the supplied Mapping is a FrameSet, the returned Mapping wil l be a copy of the supplied Overfull \hbox (21.10475pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 Mappings that have a set value for their []Ident[] attribut e are left unchanged after Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 simplification. This is so that their individual identity is pr eserved. This Overfull \hbox (12.44437pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 This function can safely be applied even to Mappings which cannot be simplified. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 If no simplification is possible, it behaves exactly like []ast Clone[] and returns Overfull \hbox (26.6159pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 The Mapping returned by this function may not be independen t of the original (even Overfull \hbox (26.6159pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 if simplification was possible), and modifying it may therefore result in indirect Overfull \hbox (2.99667pt too wide) in paragraph at lines 29236--29236 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, Overfull \hbox (5.62103pt too wide) in paragraph at lines 29236--29236 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [480] Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sk yFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the FK5 celestial coordinate system, with a Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 mean Equinox of J2005.0. Because especially accurate coordinate s will be used, Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 additional precision (10 digits) has been requested. This will be used when Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the old FK4 celestial coordin ate system. A Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [481] Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 system. The Epoch value, which specifies the date of observatio n, is obtained Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 Currently, the default celestial coordinate system is ICRS. However, this default Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 may change in future as new astrometric standards evolve. The i ntention is to Overfull \hbox (16.11847pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 track the most modern appropriate standard. For this reason, yo u should use the Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 default only if this is what you intend (and can tolerate any a ssociated slight Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 change in behaviour with future versions of this function). If you intend to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 use the ICRS system indefinitely, then you should specify it ex plicitly using Overfull \hbox (21.36719pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 Whichever celestial coordinate system is represented, it wi ll have two axes. The Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 first of these will be the longitude axis and the second will b e the latitude Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 When conversion between two SkyFrames is requested (as when supplying SkyFrames Overfull \hbox (10.86975pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 to []astConvert[]), account will be taken of the nature of the celestial coordinate Overfull \hbox (23.99155pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 systems they represent, together with any qualifying mean Equin ox or Epoch values, Overfull \hbox (0.37231pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 etc. The []AlignSystem[] attribute will also be taken into acco unt. The results Overfull \hbox (31.60219pt too wide) in paragraph at lines 29365--29365 \T1/cmtt/m/n/10 will therefore fully reflect the relationship between positions on the sky measured Overfull \hbox (5.62103pt too wide) in paragraph at lines 29365--29365 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [482] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29408--29408 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [483] Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the celestial coordinate Overfull \hbox (15.85603pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 conversion to be added to the SlaMap. See the " SLALIB Conversi ons" section for Overfull \hbox (21.10475pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 An array containing argument values for the celestial coordinat e conversion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 number of arguments required, and hence the number of array ele ments used, depends Overfull \hbox (15.85603pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 on the conversion specified (see the " SLALIB Conversions" sect ion). This array Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 All coordinate values processed by an SlaMap are in radians . The first coordinate Overfull \hbox (7.19565pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 is the celestial longitude and the second coordinate is the cel estial latitude. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 the most economical conversion path. For example, converting to the standard Overfull \hbox (10.86975pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 FK5 coordinate system as an intermediate stage is often sensibl e in formulating Overfull \hbox (5.62103pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 the problem, but may introduce unnecessary extra conversion ste ps. A solution Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to this is to include all the steps which are (logically) neces sary, but then Overfull \hbox (16.11847pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to use []astSimplify[] to simplify the resulting SlaMap. The si mplification process Overfull \hbox (26.6159pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [484] Overfull \hbox (49.23947pt too wide) in paragraph at lines 29628--29628 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 to indicate which celestial coordinate conversion is to be adde d to the SlaMap. Each Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 string is derived from the name of the SLALIB routine that perf orms the conversion Overfull \hbox (39.2669pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 and the relevant documentation (SUN/67) should be consulted for details. Where arguments Overfull \hbox (39.2669pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 are needed by the conversion, they are listed in parentheses. V alues for these arguments Overfull \hbox (7.7746pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 should be given, via the " args" array, in the order indicated. The argument names Overfull \hbox (28.76947pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 match the corresponding SLALIB routine arguments and their valu es should be given using Overfull \hbox (12.44437pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " PREBN" (BEP0,BEP1): Apply Bessel-Newcomb pre-IAU 1976 (FK 4) precession model. Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 For example, to use the " ADDET" conversion, which takes a sing le argument EQ, you Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 should consult the documentation for the SLALIB routine SLA_ADD ET. This describes the Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 conversion in detail and shows that EQ is the Besselian epoch o f the mean equator and Overfull \hbox (13.02332pt too wide) in paragraph at lines 29628--29628 []\T1/cmtt/m/n/10 In addition the following strings may be supplied for more co mplex conversions which Overfull \hbox (2.52588pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 do not correspond to any one single SLALIB routine (DIURAB is t he magnitude of the Overfull \hbox (23.52075pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 diurnal aberration vector in units of " day/(2.PI)" , DATE is t he Modified Julian Date Overfull \hbox (18.27203pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 of the observation, and (OBSX,OBSY,OBZ) are the Heliocentric-Ar ies-Ecliptic cartesian Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " HPCEQ" (DATE,OBSX,OBSY,OBSZ): Convert Helioprojective-Car tesian coordinates Overfull \hbox (117.41873pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " EQHPC" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Cartesian. Overfull \hbox (0.37231pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " HPREQ" (DATE,OBSX,OBSY,OBSZ): Convert Helioprojective-Rad ial coordinates to Overfull \hbox (101.67258pt too wide) in paragraph at lines 29628--29628 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [485] Overfull \hbox (28.76947pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 Note, the " H2E" and " E2H" conversions convert between topocen tric horizon coordinates Overfull \hbox (29.81921pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 (azimuth,elevation), and apparent local equatorial coordinates (hour angle,declination). Overfull \hbox (18.0096pt too wide) in paragraph at lines 29628--29628 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [486] Overfull \hbox (10.60732pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to Overfull \hbox (10.86975pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sl aMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 29708--29708 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (26.6159pt too wide) in paragraph at lines 29708--29708 [][]\T1/cmtt/m/n/10 The []Nin[] and []Nout[] attributes (number of input and ou tput coordinates) for an SlaMap Overfull \hbox (0.37231pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 are both equal to 2. The first coordinate is the celestial long itude and the Overfull \hbox (28.19052pt too wide) in paragraph at lines 29708--29708 \T1/cmtt/m/n/10 second coordinate is the celestial latitude. All coordinate val ues are in radians. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29708--29708 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [487] Overfull \hbox (6.88478pt too wide) in paragraph at lines 29989--29989 []\T1/cmtt/m/n/10 void astSpecAdd( AstSpecMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 cvt, int narg, cons t double args[] ) Overfull \hbox (52.8595pt too wide) in paragraph at lines 29989--29989 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the spectral coordinate conversion Overfull \hbox (21.36719pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to be added to the SpecMap. See the " Available Conversions" se ction for details Overfull \hbox (15.85603pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 An array containing argument values for the spectral coordinate conversion. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 number of arguments required, and hence the number of array ele ments used, depends Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 on the conversion specified (see the " Available Conversions" s ection). This Overfull \hbox (7.19565pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 array is ignored and a NULL pointer may be supplied if no argum ents are needed. Underfull \hbox (badness 10000) in paragraph at lines 29989--29989 Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 the most economical conversion path. For example, when converti ng between reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 frames, converting first to the heliographic reference frame as an intermediate Overfull \hbox (21.10475pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 stage is often sensible in formulating the problem, but may int roduce unnecessary Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 extra conversion steps. A solution to this is to include all th e steps which Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 are (logically) necessary, but then to use []astSimplify[] to s implify the resulting Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 SpecMap. The simplification process will eliminate any steps wh ich turn out not Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions Overfull \hbox (49.23947pt too wide) in paragraph at lines 29989--29989 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (23.52075pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to indicate which spectral coordinate conversion is to be added to the SpecMap. Where Overfull \hbox (7.51216pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 arguments are needed by the conversion, they are listed in pare ntheses. Values for Overfull \hbox (23.52075pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [488] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " USF2HL" (VOFF,RA,DEC): Convert frequency from a user-defi ned reference frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2US" (VOFF,RA,DEC): Convert frequency from heliocentri c reference frame to Overfull \hbox (21.36719pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " TPF2HL" (OBSLON,OBSLAT,OBSALT,EPOCH,RA,DEC): Convert freq uency from topocentric Overfull \hbox (26.6159pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2TP" (OBSLON,OBSLAT,OBSALT,EPOCH,RA,DEC): Convert freq uency from heliocentric Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " GEF2HL" (EPOCH,RA,DEC): Convert frequency from geocentric reference frame to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2GE" (EPOCH,RA,DEC): Convert frequency from heliocentr ic reference frame Overfull \hbox (10.86975pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " BYF2HL" (EPOCH,RA,DEC): Convert frequency from barycentri c reference frame to Overfull \hbox (0.37231pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2BY" (EPOCH,RA,DEC): Convert frequency from heliocentr ic reference frame Overfull \hbox (59.68283pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LKF2HL" (RA,DEC): Convert frequency from kinematic LSR re ference frame to heliocentric. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LK" (RA,DEC): Convert frequency from heliocentric ref erence frame to kinematic Overfull \hbox (59.68283pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LDF2HL" (RA,DEC): Convert frequency from dynamical LSR re ference frame to heliocentric. Overfull \hbox (37.11334pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LD" (RA,DEC): Convert frequency from heliocentric ref erence frame to dynamical Overfull \hbox (49.1854pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " LGF2HL" (RA,DEC): Convert frequency from local group refe rence frame to heliocentric. Overfull \hbox (16.11847pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [489] Overfull \hbox (33.43924pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " GLF2HL" (RA,DEC): Convert frequency from galactic referen ce frame to heliocentric. Overfull \hbox (33.43924pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 " HLF2GL" (RA,DEC): Convert frequency from heliocentric ref erence frame to galactic. Overfull \hbox (43.93668pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 all velocities: metres per second (positive if the source r eceeds from the observer). Overfull \hbox (5.62103pt too wide) in paragraph at lines 29989--29989 [][]\T1/cmtt/m/n/10 VOFF: Velocity of the user-defined reference frame, towards the position given Overfull \hbox (18.27203pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 If the SpecMap is 3-dimensional, source positions are provided by the values supplied Overfull \hbox (15.64767pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 to inputs 2 and 3 of the SpecMap (which are simply copied to ou tputs 2 and 3). Note, Overfull \hbox (13.02332pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 usable values are still required for the RA and DEC arguments i n order to define the Overfull \hbox (7.7746pt too wide) in paragraph at lines 29989--29989 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [490] Overfull \hbox (18.64314pt too wide) in paragraph at lines 30074--30074 []\T1/cmtt/m/n/10 AstSpecFluxFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSpe cFluxFrame( AstSpecFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame1, AstFluxF rame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 frame2, const Overfull \hbox (22.9418pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to the SpecFrame. This will form the first axis in the new SpecFluxFrame. Overfull \hbox (28.19052pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to the FluxFrame. This will form the second axis in the new SpecFluxFrame. Overfull \hbox (21.10475pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 The " []SpecVal[]" attribute of this FluxFrame is not used by t he SpecFluxFrame class Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (16.11847pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecFluxFrame. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 syntax used is identical to that for the []astSet[] function an d may include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (21.36719pt too wide) in paragraph at lines 30074--30074 [][]\T1/cmtt/m/n/10 The supplied Frame pointers are stored directly, rather tha n being used to create Overfull \hbox (16.11847pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 deep copies of the supplied Frames. This means that any subsequ ent changes made Overfull \hbox (10.86975pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 to the Frames via the supplied pointers will result in equivale nt changes being Overfull \hbox (5.62103pt too wide) in paragraph at lines 30074--30074 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 30074--30074 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30074--30074 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [491] Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 system. The []RestFreq[] attribute (rest frequency) is unspecif ied, so it will Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 not be possible to align this SpecFrame with another SpecFrame on the basis of Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 a velocity-based system. The standard of rest is also unspecifi ed. This means Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 that alignment will be possible with other SpecFrames, but no c orrection will be Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 rest frequency 1.0E15 Hz (about 3000 Angstroms), measured in th e kinematic Local Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 Standard of Rest (" LSRK" ). Since the source position has not been specified Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 (using attributes []RefRA[] and []RefDec[]), it will only be po ssible to align this Underfull \hbox (badness 10000) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [492] Overfull \hbox (21.36719pt too wide) in paragraph at lines 30174--30174 [][]\T1/cmtt/m/n/10 When conversion between two SpecFrames is requested (as whe n supplying SpecFrames Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 to []astConvert[]), account will be taken of the nature of the spectral coordinate Overfull \hbox (0.37231pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 systems they represent, together with any qualifying rest frequ ency, standard Overfull \hbox (10.86975pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 of rest, epoch values, etc. The []AlignSystem[] and []AlignStdO fRest[] attributes will Overfull \hbox (47.61078pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 also be taken into account. The results will therefore fully re flect the relationship Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 \T1/cmtt/m/n/10 between positions measured in the two systems. In addition, any difference in Overfull \hbox (5.62103pt too wide) in paragraph at lines 30174--30174 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [493] Overfull \hbox (17.43065pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 The number of inputs to the Mapping (this will also equal the n umber of outputs). Overfull \hbox (0.10988pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 This value must be either 1 or 3. In either case, the first inp ut and output Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 correspoindis the spectral axis. For a 3-axis SpecMap, the seco nd and third axes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 give the RA and DEC (J2000 FK5) of the source. This positional information is Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 used by conversions which transform between standards of rest, and replaces the Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 " RA" and " DEC" arguments for the individual conversions liste d in description Overfull \hbox (10.60732pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp ecMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 30290--30290 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [494] Overfull \hbox (12.44437pt too wide) in paragraph at lines 30290--30290 [][]\T1/cmtt/m/n/10 The nature and units of the coordinate values supplied for the first input (i.e. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 the spectral input) of a SpecMap must be appropriate to the fir st conversion step Overfull \hbox (16.11847pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 applied by the SpecMap. For instance, if the first conversion s tep is " FRTOVL" Overfull \hbox (5.09616pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 (frequency to relativistic velocity), then the coordinate value s for the first Overfull \hbox (0.37231pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 input should be frequency in units of Hz. Similarly, the nature and units of Overfull \hbox (42.36206pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 the coordinate values returned by a SpecMap will be determined by the last conversion Overfull \hbox (37.11334pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 step applied by the SpecMap. For instance, if the last conversi on step is " VLTOVO" Overfull \hbox (10.34488pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 (relativistic velocity to optical velocity), then the coordinat e values for the Overfull \hbox (0.37231pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 first output will be optical velocity in units of metres per se cond. See the Overfull \hbox (0.10988pt too wide) in paragraph at lines 30290--30290 \T1/cmtt/m/n/10 description of the astSpecAdd function for the units expected a nd returned by Overfull \hbox (5.62103pt too wide) in paragraph at lines 30290--30290 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [495] Overfull \hbox (10.86975pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sp hMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 30388--30388 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (0.37231pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 The spherical coordinates are longitude (positive anti-cloc kwise looking from Overfull \hbox (44.98642pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the positive latitude pole) and latitude. The Cartesian coordin ates are right-handed, Overfull \hbox (0.10988pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 with the x axis (axis 1) at zero longitude and latitude, and th e z axis (axis Overfull \hbox (5.62103pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 If the Cartesian coordinates are all zero, then the longitu de and latitude are Overfull \hbox (5.62103pt too wide) in paragraph at lines 30388--30388 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited Overfull \hbox (2.26344pt too wide) in paragraph at lines 30388--30388 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30388--30388 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [496] [497] Overfull \hbox (42.36206pt too wide) in paragraph at lines 30417--30417 [][]\T1/cmtt/m/n/10 If the AST error status is set to an error value (after an error), most AST functions Overfull \hbox (26.35347pt too wide) in paragraph at lines 30417--30417 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [498] Overfull \hbox (26.30504pt too wide) in paragraph at lines 30507--30507 []\T1/cmtt/m/n/10 AstStcCatalogEntryLocation $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 astStcCatalogEntryLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, int ncoords, Overfull \hbox (18.74283pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied []KeyMap[] descri bes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (38.68796pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cCatalogEntryLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 The syntax used is identical to that for the []astSet[] functio n and may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30507--30507 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30507--30507 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30507--30507 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect Overfull \hbox (5.62103pt too wide) in paragraph at lines 30507--30507 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [499] [500] Overfull \hbox (28.9294pt too wide) in paragraph at lines 30597--30597 []\T1/cmtt/m/n/10 AstStcObsDataLocation $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcObsDataLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, i nt ncoords, AstKeyMap Overfull \hbox (18.74283pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied []KeyMap[] descri bes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cObsDataLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 The syntax used is identical to that for the []astSet[] functio n and may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30597--30597 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30597--30597 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30597--30597 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect Overfull \hbox (5.62103pt too wide) in paragraph at lines 30597--30597 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [501] [502] Overfull \hbox (28.9294pt too wide) in paragraph at lines 30695--30695 []\T1/cmtt/m/n/10 AstStcResourceProfile $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcResourceProfile( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, i nt ncoords, AstKeyMap Overfull \hbox (18.74283pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied []KeyMap[] descri bes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (12.44437pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cResourceProfile. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 The syntax used is identical to that for the []astSet[] functio n and may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30695--30695 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30695--30695 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect Overfull \hbox (5.62103pt too wide) in paragraph at lines 30695--30695 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [503] Overfull \hbox (2.26344pt too wide) in paragraph at lines 30695--30695 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30695--30695 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [504] Overfull \hbox (23.68068pt too wide) in paragraph at lines 30793--30793 []\T1/cmtt/m/n/10 AstStcResourceProfile $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 a stStcSearchLocation( AstRegion $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 region, in t ncoords, AstKeyMap Overfull \hbox (18.74283pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 Pointer to an array holding " ncoords" AstKeyMap pointers (if " ncoords" is zero, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 the supplied value is ignored). Each supplied []KeyMap[] descri bes the contents of Overfull \hbox (1.32593pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 a single STC $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 AstroCoords$\ OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 element, and should have elements with keys given Overfull \hbox (29.24026pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 by constants AST__STCNAME, AST__STCVALUE, AST__STCERROR, AST__S TCRES, AST__STCSIZE, Overfull \hbox (21.10475pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 AST__STCPIXSZ. Any of these elements may be omitted, but no oth er elements should Overfull \hbox (31.60219pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 be included. If supplied, the AST__STCNAME element should be a vector of character Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 string pointers holding the " Name" item for each axis in the c oordinate system Overfull \hbox (23.99155pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 represented by " region" . Any other supplied elements should b e scalar elements, Overfull \hbox (5.3586pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 each holding a pointer to a Region describing the associated it em of ancillary Overfull \hbox (21.36719pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (7.19565pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St cSearchLocation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 The syntax used is identical to that for the []astSet[] functio n and may include " Overfull \hbox (10.86975pt too wide) in paragraph at lines 30793--30793 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (37.11334pt too wide) in paragraph at lines 30793--30793 [][]\T1/cmtt/m/n/10 A deep copy is taken of the supplied Region. This means tha t any subsequent changes Overfull \hbox (5.62103pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 made to the encapsulated Region using the supplied pointer will have no effect Overfull \hbox (5.62103pt too wide) in paragraph at lines 30793--30793 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [505] Overfull \hbox (2.26344pt too wide) in paragraph at lines 30793--30793 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 30793--30793 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [506] Overfull \hbox (8.09445pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 AstStcsChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astStcsChan ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/ cmtt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink) ( const char Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 this function will be used by the StcsChan to obtain lines of i nput text. On Overfull \hbox (21.36719pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 each invocation, it should return a pointer to the next input l ine read from some Overfull \hbox (16.11847pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 this function will be used by the StcsChan to deliver lines of output text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 30896--30896 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (26.35347pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new St csChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 30896--30896 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [507] Overfull \hbox (8.24539pt too wide) in paragraph at lines 30896--30896 [][]\T1/cmtt/m/n/10 If the external data source or sink uses a character encodi ng other than ASCII, Overfull \hbox (47.34834pt too wide) in paragraph at lines 30896--30896 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character Overfull \hbox (5.62103pt too wide) in paragraph at lines 30896--30896 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [508] Overfull \hbox (2.52588pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 Pointer to the modified string. If no escape sequences were fou nd in the supplied Overfull \hbox (18.27203pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 string, then a copy of the supplied pointer is returned. Otherw ise, the pointer will Overfull \hbox (7.7746pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 point to a static buffer holding the modified text. This text w ill be over-written Overfull \hbox (28.76947pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 by subsequent invocations of this function. If the astEscapes f unction has been called Overfull \hbox (13.02332pt too wide) in paragraph at lines 30937--30937 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [509] Overfull \hbox (34.3893pt too wide) in paragraph at lines 31096--31096 []\T1/cmtt/m/n/10 AstSwitchMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astSwitchM ap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 fsmap, AstMapping $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 ismap, int nroute, AstMapping [510] Overfull \hbox (65.9813pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to the forward selector Mapping. This must have a defin ed forward transformation, Overfull \hbox (21.36719pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 but need not have a defined inverse transformation. It must hav e one output, and Overfull \hbox (26.6159pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 the number of inputs must match the number of inputs of each of the supplied route Overfull \hbox (31.86462pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Mappings. NULL may be supplied, in which case the SwitchMap wil l have an undefined Overfull \hbox (65.9813pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to the inverse selector Mapping. This must have a defin ed inverse transformation, Overfull \hbox (16.11847pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 but need not have a defined forward transformation. It must hav e one input, and Overfull \hbox (5.62103pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 the number of outputs must match the number of outputs of each of the supplied Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 route Mappings. NULL may be supplied, in which case the SwitchM ap will have an Overfull \hbox (21.10475pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 An array of pointers to the route Mappings. All the supplied ro ute Mappings must Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 have common values for the Nin and Nout attributes, and these v alues define the Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Sw itchMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 31096--31096 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (0.37231pt too wide) in paragraph at lines 31096--31096 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astSwitchMap (the Overfull \hbox (16.11847pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 new SwitchMap simply retains a reference to them). They may con tinue to be used Overfull \hbox (15.85603pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 for other purposes, but should not be deleted. If a SwitchMap c ontaining a copy Overfull \hbox (0.37231pt too wide) in paragraph at lines 31096--31096 \T1/cmtt/m/n/10 of its component Mappings is required, then a copy of the Switc hMap should be Overfull \hbox (5.62103pt too wide) in paragraph at lines 31096--31096 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [511] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (10.60732pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ta ble. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 31186--31186 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 31186--31186 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 31186--31186 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 31186--31186 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [512] Overfull \hbox (18.3807pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 void astTableSource( AstFitsChan $\OMS/zplm/m/n/10 ^^C$\T1/cm tt/m/n/10 this, void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 tabsource)( AstFit sChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 , const char Overfull \hbox (21.36719pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 Pointer to the table source function to use. It takes five argu ments - the first Overfull \hbox (21.36719pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 is a pointer to the FitsChan, the second is a string holding th e name of the FITS Overfull \hbox (5.62103pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 extension containing the required binary table (" EXTNAME" ), t he third is the Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 integer FITS " EXTVER" header value for the required extension, the fourth is Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 the integer FITS " EXTLEVEL" header value for the required exte nsion, and the Overfull \hbox (31.60219pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 The call-back should read the entire contents (header and dat a) of the binary table Overfull \hbox (21.10475pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 in the named extension of the external FITS file, storing the c ontents in a newly Overfull \hbox (5.62103pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 created []FitsTable[] object. It should then store this FitsTab le in the FitsChan Overfull \hbox (10.60732pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 using the astPutTables or astPutTable method, and finally annul l its local copy Overfull \hbox (15.85603pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 of the FitsTable pointer. If the table cannot be read for any r eason, or if any Overfull \hbox (31.86462pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 other error occurs, it should return zero for the final (third) argument (otherwise Overfull \hbox (0.37231pt too wide) in paragraph at lines 31266--31266 []\T1/cmtt/m/n/10 If " tabsource" is NULL, any registered call-back function wi ll be removed. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31266--31266 [][]\T1/cmtt/m/n/10 Application code can pass arbitrary data (such as file desc riptors, etc) to the Overfull \hbox (16.11847pt too wide) in paragraph at lines 31266--31266 \T1/cmtt/m/n/10 table source function using the []astPutChannelData[] function. The source function [513] Overfull \hbox (26.6159pt too wide) in paragraph at lines 31324--31324 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the na me of the attribute Overfull \hbox (18.27203pt too wide) in paragraph at lines 31324--31324 \T1/cmtt/m/n/10 One if a value has previously been explicitly set for the attri bute (and hasn' t been Overfull \hbox (10.60732pt too wide) in paragraph at lines 31324--31324 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (26.35347pt too wide) in paragraph at lines 31324--31324 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [514] Overfull \hbox (7.19565pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the FI TS keyword name. Overfull \hbox (47.34834pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 This may be a complete FITS header card, in which case the keyw ord to use is extracted Overfull \hbox (39.7377pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 from it. No more than 80 characters are read from this string. If NULL is supplied, Overfull \hbox (37.11334pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 Pointer to an integer which will be returned holding a non-zero value if the keyword Overfull \hbox (21.10475pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 was found in the header, and zero otherwise. This parameter all ows a distinction Overfull \hbox (5.62103pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 to be made between the case where a keyword is not present, and the case where Overfull \hbox (21.36719pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 a keyword is present but has no associated value. A NULL pointe r may be supplied Overfull \hbox (2.26344pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 A value of zero is returned if the keyword was not found in the FitsChan or has no Overfull \hbox (26.6159pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 The card following the current card is checked first. If th is is not the required Overfull \hbox (0.37231pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 card, then the rest of the FitsChan is searched, starting with the first card Overfull \hbox (16.11847pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 added to the FitsChan. Therefore cards should be accessed in th e order they are Overfull \hbox (31.86462pt too wide) in paragraph at lines 31404--31404 \T1/cmtt/m/n/10 stored in the FitsChan (if possible) as this will minimise the time spent searching Overfull \hbox (33.43924pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31404--31404 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [515] Overfull \hbox (10.55888pt too wide) in paragraph at lines 31493--31493 []\T1/cmtt/m/n/10 void astText( AstPlot $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 t his, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 text, const double pos[], const float up[], Overfull \hbox (1.94693pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the te xt to be drawn. Overfull \hbox (42.09962pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 31493--31493 [] \T1/cmtt/m/n/10 An array holding the components of a vector in the " up" direction of the text Overfull \hbox (55.48386pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (in graphical coordinates). For example, to get horizontal text , the vector {0.0f,1.0f} Overfull \hbox (23.99155pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 should be supplied. For a basic Plot, 2 values should be suppli ed. For a []Plot3D[], Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 3 values should be supplied, and the actual up vector used is t he projection of Overfull \hbox (16.11847pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 the supplied up vector onto the text plane specified by the cur rent value of the Overfull \hbox (0.37231pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 Pointer to a null-terminated character string identifying the r eference point Overfull \hbox (47.61078pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 for the text being drawn. The first character in this string id entifies the reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 position in the " up" direction and may be " B" (baseline), " C " (centre), " T" Overfull \hbox (31.33975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (top) or " M" (bottom). The second character identifies the sid e-to-side reference Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 position and may be " L" (left), " C" (centre) or " R" (right ) . The string is Overfull \hbox (42.36206pt too wide) in paragraph at lines 31493--31493 []\T1/cmtt/m/n/10 For example, a value of " BL" means that the left end of the baseline of the original Overfull \hbox (26.6159pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 The Plot3D class currently does not interpret graphical esc ape sequences contained Overfull \hbox (37.11334pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 Text is not drawn at positions which have any coordinate eq ual to the value AST__BAD Overfull \hbox (41.83719pt too wide) in paragraph at lines 31493--31493 \T1/cmtt/m/n/10 (or where the transformation into graphical coordinates yields coordinates containing Overfull \hbox (0.37231pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 An error results if the base []Frame[] of the Plot is not 2 -dimensional or (for a Overfull \hbox (10.86975pt too wide) in paragraph at lines 31493--31493 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [516] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31587--31587 [] \T1/cmtt/m/n/10 If non-zero, returns information about the supplied Objec t pointer, rather than Overfull \hbox (18.0096pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 A value of AST__UNLOCKED is returned if the Object (or pointer) is currently unlocked Overfull \hbox (8.82434pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 (i.e. has been unlocked using []astUnlock[] but has not yet bee n locked using []astLock[]). Overfull \hbox (2.26344pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 A value of AST__RUNNING is returned if the Object (or pointer) is currently locked Overfull \hbox (11.97357pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 by the running thread. A value of AST__OTHER is returned if the Object (or pointer) Overfull \hbox (0.37231pt too wide) in paragraph at lines 31587--31587 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the global error status is set, but Overfull \hbox (54.43411pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 no further error report will be made if it subsequently fails u nder these circumstances. Overfull \hbox (31.86462pt too wide) in paragraph at lines 31587--31587 [][]\T1/cmtt/m/n/10 This function always returns AST__RUNNING if the AST librar y has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when Overfull \hbox (7.51216pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 At any one time, an AST Object can have several distinct poin ters, any one of which Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 can be used to access the Object structure. For instance, the [ ]astClone[] function will Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 produce a new distinct pointer for a given Object. In fact, an AST " pointer" is not Overfull \hbox (23.52075pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 a real pointer at all - it is an identifier for a " handle" str ucture, encoded to make Overfull \hbox (28.50703pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 it look like a pointer. Each handle contains (amongst othere th ings) a " real" pointer Overfull \hbox (23.52075pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to the Object structure. This allows more than one handle to re fer to the same Object Overfull \hbox (7.51216pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 structure. So when you call astClone (for instance) you get bac k an identifier for Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 In order to use an Object for anything useful, it must be loc ked for use by the running Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 thread (either implicitly at creation or explicitly using astLo ck). The identity of Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 the thread is stored in both the Object structure, and in the h andle that was passed Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to astLock (or returned by the constructor function). Thus it i s possible for a thread Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 to have active pointers for Objects that are currently locked b y another thread. In Overfull \hbox (55.01306pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 general, if such a pointer is passed to an AST function an erro r will be reported indicating Overfull \hbox (2.52588pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 that the Object is currently locked by another thread. The two exceptions to this Overfull \hbox (13.02332pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 is that []astAnnul[] can be used to annull such a pointer, and this function can be used Overfull \hbox (44.25319pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 The other practical consequence of this is that when []astEnd [] is called, all active pointers Overfull \hbox (34.01819pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [517] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31587--31587 []\T1/cmtt/m/n/10 If the " ptr" parameter is zero, then the returned value desc ribes the Object structure Overfull \hbox (18.27203pt too wide) in paragraph at lines 31587--31587 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [518] Overfull \hbox (6.88478pt too wide) in paragraph at lines 31827--31827 []\T1/cmtt/m/n/10 void astTimeAdd( AstTimeMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 cvt, int narg, cons t double args[] ) Overfull \hbox (31.86462pt too wide) in paragraph at lines 31827--31827 [] \T1/cmtt/m/n/10 Pointer to a null-terminated string which identifies the time coordinate conversion Overfull \hbox (21.36719pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 to be added to the TimeMap. See the " Available Conversions" se ction for details Overfull \hbox (31.33975pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 An array containing argument values for the time coordinate con version. The number Overfull \hbox (5.62103pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 of arguments required, and hence the number of array elements u sed, depends on Overfull \hbox (15.85603pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the conversion specified (see the " Available Conversions" sect ion). This array Overfull \hbox (37.11334pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 When assembling a multi-stage conversion, it can sometimes be difficult to determine Overfull \hbox (5.62103pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the most economical conversion path. A solution to this is to i nclude all the Overfull \hbox (5.3586pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 steps which are (logically) necessary, but then to use []astSim plify[] to simplify Overfull \hbox (21.36719pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 the resulting TimeMap. The simplification process will eliminat e any steps which Overfull \hbox (26.6159pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions Overfull \hbox (49.23947pt too wide) in paragraph at lines 31827--31827 []\T1/cmtt/m/n/10 The following strings (which are case-insensitive) may be sup plied via the " cvt" parameter Overfull \hbox (2.52588pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 to indicate which time coordinate conversion is to be added to the TimeMap. Where Overfull \hbox (7.51216pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 arguments are needed by the conversion, they are listed in pare ntheses. Values for Overfull \hbox (23.52075pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units Overfull \hbox (2.52588pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [519] Overfull \hbox (33.75575pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 The arguments used in the above conversions are the zero-points used by the astTransform Overfull \hbox (23.52075pt too wide) in paragraph at lines 31827--31827 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [520] Overfull \hbox (43.93668pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 DTAI: The value of TAI-UTC (the value returned by astDat is used if DTAI is AST__BAD). Overfull \hbox (10.86975pt too wide) in paragraph at lines 31827--31827 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [521] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (31.60219pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ti meFrame. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 31917--31917 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (21.36719pt too wide) in paragraph at lines 31917--31917 [][]\T1/cmtt/m/n/10 When conversion between two TimeFrames is requested (as whe n supplying TimeFrames Overfull \hbox (26.6159pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 to []astConvert[]), account will be taken of the nature of the time coordinate systems Overfull \hbox (16.11847pt too wide) in paragraph at lines 31917--31917 \T1/cmtt/m/n/10 they represent, together with any qualifying time scale, offset , unit, etc. The Overfull \hbox (5.62103pt too wide) in paragraph at lines 31917--31917 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [522] [523] Overfull \hbox (10.60732pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 This parameter is reserved for future use and should currently always be set to Overfull \hbox (10.86975pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ti meMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 specifiers identified by " %" symbols in the normal way. If no initialisation Overfull \hbox (10.86975pt too wide) in paragraph at lines 31999--31999 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (12.44437pt too wide) in paragraph at lines 31999--31999 [][]\T1/cmtt/m/n/10 The nature and units of the coordinate values supplied for the first input (i.e. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 the time input) of a TimeMap must be appropriate to the first c onversion step Overfull \hbox (26.6159pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 applied by the TimeMap. For instance, if the first conversion s tep is " MJDTOBEP" Overfull \hbox (26.09103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 (Modified Julian Date to Besselian epoch) then the coordinate v alues for the first Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 input should be date in units of days. Similarly, the nature an d units of the Overfull \hbox (21.36719pt too wide) in paragraph at lines 31999--31999 \T1/cmtt/m/n/10 coordinate values returned by a TimeMap will be determined by t he last conversion Overfull \hbox (5.62103pt too wide) in paragraph at lines 31999--31999 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [524] Overfull \hbox (23.25832pt too wide) in paragraph at lines 32029--32029 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [525] Overfull \hbox (12.97206pt too wide) in paragraph at lines 32083--32083 []\T1/cmtt/m/n/10 void astTran1( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, const double xin[], int forward, double Overfull \hbox (15.85603pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (62.04475pt too wide) in paragraph at lines 32083--32083 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the coordinates o f the output (transformed) Overfull \hbox (12.44437pt too wide) in paragraph at lines 32083--32083 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 1 for both its []N in[] and []Nout[] attributes. [526] Overfull \hbox (10.3477pt too wide) in paragraph at lines 32150--32150 []\T1/cmtt/m/n/10 void astTran2( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, const double xin[], const double yin[], Overfull \hbox (6.93321pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array of " npoint" X-coordinate values for the input (untran sformed) points. Overfull \hbox (6.93321pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array of " npoint" Y-coordinate values for the input (untran sformed) points. Overfull \hbox (15.85603pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (0.10988pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the X-coordinates of the output Overfull \hbox (0.10988pt too wide) in paragraph at lines 32150--32150 \T1/cmtt/m/n/10 An array (with " npoint" elements) into which the Y-coordinates of the output Overfull \hbox (12.44437pt too wide) in paragraph at lines 32150--32150 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 2 for both its []N in[] and []Nout[] attributes. [527] Overfull \hbox (20.84514pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 void astTranGrid( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int ncoord_in, const int lbnd[], const int ubnd[], Overfull \hbox (5.09616pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of coordinates being supplied for each box corner (i .e. the number Overfull \hbox (52.8595pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ncoord_in" elements, co ntaining the coordinates Overfull \hbox (52.8595pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ncoord_in" elements, co ntaining the coordinates Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 Note that " lbnd" and " ubnd" together define the shape and s ize of the input Overfull \hbox (3.21104pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 grid, its extent along a particular (j' th) dimension being ubn d[j]-lbnd[j]$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 1 Overfull \hbox (10.34488pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 (assuming the index " j" to be zero-based). They also define th e input grid' s Overfull \hbox (31.86462pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 [] \T1/cmtt/m/n/10 The maximum tolerable geometrical distortion which may be introduced as a result Overfull \hbox (28.19052pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 of approximating non-linear Mappings by a set of piece-wise lin ear transformations. Overfull \hbox (5.3586pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 This should be expressed as a displacement within the output co ordinate system Overfull \hbox (17.69308pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If piece-wise linear approximation is not required, a value o f zero may be given. Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 This will ensure that the Mapping is used without any approxima tion, but may increase Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If the value is too high, discontinuities between the linear approximations used Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 in adjacent panel will be higher. If this is a problem, reduce the tolerance Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 A value which specifies an initial scale size (in input grid po ints) for the adaptive Overfull \hbox (54.43411pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 algorithm which approximates non-linear Mappings with piece-wis e linear transformations. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 Normally, this should be a large value (larger than any dimensi on of the region Overfull \hbox (16.11847pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 of the input grid being used). In this case, a first attempt to approximate the Overfull \hbox (31.86462pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If a smaller value is used, the input region will first be di vided into sub-regions Overfull \hbox (15.85603pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [528] Overfull \hbox (42.09962pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 This value may occasionally be useful in preventing false con vergence of the adaptive Overfull \hbox (23.99155pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 algorithm in cases where the Mapping appears approximately line ar on large scales, Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 but has irregularities (e.g. holes) on smaller scales. A value of, say, 50 to Overfull \hbox (13.23167pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 100 grid points can also be employed as a safeguard in general- purpose software, Overfull \hbox (63.35693pt too wide) in paragraph at lines 32306--32306 []\T1/cmtt/m/n/10 If too small a value is given, it will have the effect of inh ibiting linear approximation Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 altogether (equivalent to setting " tol" to zero). Although thi s may degrade Overfull \hbox (15.85603pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " out" array (which will Overfull \hbox (0.37231pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 contain the output coordinates). The value given should not be less than the Overfull \hbox (68.34322pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (12.44437pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 , into which the coordinates of the output (transformed) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output Overfull \hbox (21.36719pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 point number " point" will be found in element " out[coord][poi nt]" . The points Overfull \hbox (21.10475pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 are ordered such that the first axis of the input grid changes most rapidly. For Overfull \hbox (21.36719pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 example, if the input grid is 2-dimensional and extends from (2 ,-1) to (3,1), the Overfull \hbox (8.24539pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 output points will be stored in the order (2,-1), (3, -1), (2,0 ), (3,0), (2,1), Overfull \hbox (10.86975pt too wide) in paragraph at lines 32306--32306 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its []Nin[] attribute a nd the value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32306--32306 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these [529] Overfull \hbox (9.9315pt too wide) in paragraph at lines 32408--32408 []\T1/cmtt/m/n/10 AstTranMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astTranMap( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 map1, AstMapping $\OMS/zplm/m/ n/10 ^^C$\T1/cmtt/m/n/10 map2, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 options, ... Overfull \hbox (17.69308pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to the first component Mapping, which defines the forwa rd transformation. Overfull \hbox (22.9418pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to the second component Mapping, which defines the inve rse transformation. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Tr anMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (41.31232pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 The number of output coordinates generated by the two Mappi ngs (their []Nout[] attribute) Overfull \hbox (10.86975pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 must be equal, as must the number of input coordinates accepted by each Mapping Overfull \hbox (10.60732pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 Note that the component Mappings supplied are not copied by astTranMap (the new Overfull \hbox (5.09616pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 TranMap simply retains a reference to them). They may continue to be used for Overfull \hbox (0.37231pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 other purposes, but should not be deleted. If a TranMap contain ing a copy of Overfull \hbox (0.37231pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the TranMap should be made Overfull \hbox (5.62103pt too wide) in paragraph at lines 32408--32408 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [530] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32408--32408 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 32408--32408 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] Overfull \hbox (7.72334pt too wide) in paragraph at lines 32514--32514 []\T1/cmtt/m/n/10 void astTranN( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, int ncoord_in, int indim, const double Overfull \hbox (10.34488pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point ( i.e. the number Overfull \hbox (36.8509pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " in" array (which contains Overfull \hbox (0.37231pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 the input coordinates). This value is required so that the coor dinate values Overfull \hbox (26.6159pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (58.10822pt too wide) in paragraph at lines 32514--32514 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord_in][indim]" Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 , containing the coordinates of the input (untransformed) point s. These should Overfull \hbox (26.35347pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 be stored such that the value of coordinate number " coord" for input point number Overfull \hbox (15.85603pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (21.10475pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The number of elements along the second dimension of the " out" array (which will Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 contain the output coordinates). This value is required so that the coordinate Overfull \hbox (10.60732pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 values can be correctly located if they will not entirely fill this array. The Overfull \hbox (68.34322pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (12.44437pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 , into which the coordinates of the output (transformed) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [532] Overfull \hbox (10.86975pt too wide) in paragraph at lines 32514--32514 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its []Nin[] attribute a nd the value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32514--32514 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these [533] Overfull \hbox (5.31017pt too wide) in paragraph at lines 32609--32609 []\T1/cmtt/m/n/10 void astTranP( AstMapping $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/ 10 this, int npoint, int ncoord_in, const double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt /m/n/10 ptr_in[], Overfull \hbox (10.34488pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point ( i.e. the number Overfull \hbox (42.09962pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 An array of pointers to double, with " ncoord_in" elements. Ele ment " ptr_in[coord]" Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 should point at the first element of an array of double (with " npoint" elements) Overfull \hbox (41.04988pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 which contain the values of coordinate number " coord" for each input (untransformed) Overfull \hbox (10.86975pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 point. The value of coordinate number " coord" for input point number " point" Overfull \hbox (38.68796pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 is therefore given by " ptr_in[coord][point]" (assuming both in dices are zero-based). Overfull \hbox (15.85603pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 A non-zero value indicates that the Mapping' s forward coordina te transformation Overfull \hbox (5.62103pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 is to be applied, while a zero value indicates that the inverse transformation Overfull \hbox (5.3586pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 The number of coordinates being generated by the Mapping for ea ch output point Overfull \hbox (11.9195pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 (i.e. the number of dimensions of the space in which the output points reside). Overfull \hbox (52.59706pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 An array of pointers to double, with " ncoord_out" elements. El ement " ptr_out[coord]" Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 should point at the first element of an array of double (with " npoint" elements) Overfull \hbox (20.31744pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 into which the values of coordinate number " coord" for each ou tput (transformed) Overfull \hbox (16.11847pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 point will be written. The value of coordinate number " coord" for output point Overfull \hbox (10.86975pt too wide) in paragraph at lines 32609--32609 [][]\T1/cmtt/m/n/10 If the forward coordinate transformation is being applied, the Mapping supplied Overfull \hbox (58.10822pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 must have the value of " ncoord_in" for its []Nin[] attribute a nd the value of " ncoord_out" Overfull \hbox (5.62103pt too wide) in paragraph at lines 32609--32609 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these [534] [535] Overfull \hbox (0.10988pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 The new value for the tuning parameter. If this is AST__TUNULL, the existing Overfull \hbox (7.51216pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 The original value of the tuning parameter. A default value wil l be returned if no Overfull \hbox (8.24539pt too wide) in paragraph at lines 32691--32691 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Underfull \hbox (badness 10000) in paragraph at lines 32691--32691 Overfull \hbox (2.001pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 A boolean flag which indicates what should happen to the memory occupied by an AST Overfull \hbox (2.26344pt too wide) in paragraph at lines 32691--32691 []\T1/cmtt/m/n/10 Object[] when the Object is deleted (i.e. when its reference count falls to zero or Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 it is deleted using []astDelete[]). If this is zero, the memory is simply freed using Overfull \hbox (7.7746pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 the systems " free" function. If it is non-zero, the memory is not freed. Instead Overfull \hbox (18.27203pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 a pointer to it is stored in a pool of such pointers, all of wh ich refer to allocated Overfull \hbox (18.27203pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 but currently unused blocks of memory. This allows AST to speed up subsequent Object Overfull \hbox (2.26344pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 creation by re-using previously allocated memory blocks rather than allocating new Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 memory using the systems malloc function. The default value for this parameter is Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 zero. Setting it to a non-zero value will result in Object memo ry being cached in Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 future. Setting it back to zero causes any memory blocks curren tly in the pool to Overfull \hbox (2.52588pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 be freed. Note, this tuning parameter only controls the caching of memory used to Overfull \hbox (14.59793pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 store AST Objects. To cache other memory blocks allocated by AS T, use MemoryCaching. Overfull \hbox (17.74716pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 A boolean flag similar to ObjectCaching except that it controls caching of all memory Overfull \hbox (20.8964pt too wide) in paragraph at lines 32691--32691 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [536] Overfull \hbox (5.3586pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 The new value for the tuning parameter. If this is NULL, the ex isting current Overfull \hbox (17.43065pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A character string in which to return the original value of the tuning parameter. Overfull \hbox (20.84232pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 An error will be reported if the buffer is too small to hold th e value. NULL may Overfull \hbox (8.24539pt too wide) in paragraph at lines 32804--32804 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the AST error sta tus is set on entry, Overfull \hbox (26.6159pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these Underfull \hbox (badness 10000) in paragraph at lines 32804--32804 Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the hours field in a formatted s ky axis value when " Overfull \hbox (39.2669pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 g" format is in use (see the Format attribute). This string may include escape sequences Overfull \hbox (13.02332pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 to produce super-scripts, etc. (see the Escapes attribute for d etails of the escape Overfull \hbox (53.81912pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 sequences allowed). The default value is " %-%$[]$50$\OT1/zplm/ m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 h%$\OT1/zplm/m /n/10 +$\T1/cmtt/m/n/10 " which produces a super-script Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the minutes field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$50$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 m%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the seconds field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$50$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 s%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (7.51216pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the degrees field in a formatted sky axis value when Overfull \hbox (1.33194pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 " g" format is in use. The default value is " %-%$[]$53$\OT1/zp lm/m/n/10 +$\T1/cmtt/m/n/10 %s60$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 o%$\OT1/zpl m/m/n/10 +$\T1/cmtt/m/n/10 " which produces a Overfull \hbox (2.26344pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the arc-minutes field in a forma tted sky axis value Overfull \hbox (22.06438pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 when " g" format is in use. The default value is " %-%$[]$20$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 %s85$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 ' %$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces [537] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn following the arc-seconds field in a forma tted sky axis value Overfull \hbox (27.52428pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 when " g" format is in use. The default value is " %-%$[]$20$\O T1/zplm/m/n/10 +$\T1/cmtt/m/n/10 %s85$\OT1/zplm/m/n/10 +$$\OMS/zplm/m/n/10 n$\T 1/cmtt/m/n/10 " %$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces Overfull \hbox (14.3355pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 A string to be drawn to introduce the exponent in a value when " g" format is in use. Overfull \hbox (18.96321pt too wide) in paragraph at lines 32804--32804 \T1/cmtt/m/n/10 The default value is " 10%-%$[]$50$\OT1/zplm/m/n/10 +$\T1/cmtt/ m/n/10 %s70$\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 " which produces " 10" followed by the exponent [538] Overfull \hbox (24.21193pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 void astUinterp( int ndim_in, const int lbnd_in[], const int ubnd_in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 > $ Overfull \hbox (3.69067pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 in[], const $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zpl m/m/it/10 >$ \T1/cmtt/m/n/10 in_var[], int npoint, const int offset[], const do uble $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 const Overfull \hbox (21.13287pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 coords[], const double params[], int flags, $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 badval, $\OML/zplm /m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 out[], $\ OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_in" elements, cont aining the coordinates Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 Note that " lbnd_in" and " ubnd_in" together define the shape , size and coordinate Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 [] \T1/cmtt/m/n/10 Pointer to an array, with one element for each pixel in t he input grid, containing Overfull \hbox (1.32593pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the input data. This will be the same array as was passed to as tResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ Overfull \hbox (10.60732pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 via the " in" parameter. The numerical type of this array shoul d match that of Overfull \hbox (28.19052pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an optional second array with the same size and type as the " in" array. Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 If given, this will contain the set of variance values associat ed with the input Overfull \hbox (27.56952pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 data and will be the same array as was passed to astResample$\O ML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 via th e " in_var" Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 The number of points at which the input grid is to be interpola ted. This will Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array of integers with " npoint" elements. For ea ch interpolation Overfull \hbox (46.56104pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 point, this will contain the zero-based index in the " out" (an d " out_var" ) array(s) Overfull \hbox (17.69308pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 at which the interpolated value (and its variance, if required) should be stored. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 For example, the interpolated value for point number " point" s hould be stored Overfull \hbox (31.60219pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 An array of pointers to double, with " ndim_in" elements. Eleme nt " coords[coord]" Overfull \hbox (9.55757pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 will point at the first element of an array of double (with " n point" elements) Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 which contains the values of coordinate number " coord" for eac h interpolation Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 point. The value of coordinate number " coord" for interpolatio n point number Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [539] Overfull \hbox (21.36719pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 If any interpolation point has any of its coordinates equal t o the value AST__BAD Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 (as defined in the " ast.h" header file), then the correspondin g output data (and Overfull \hbox (28.97783pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 variance) should either be set to the value given by " badval" , or left unchanged, Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be a pointer to the same array as was given via the " params" parameter Overfull \hbox (1.32593pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/ m/it/10 >$\T1/cmtt/m/n/10 . You may use this to pass any additional parameter v alues Overfull \hbox (49.87657pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be the same value as was given via the " flags" param eter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\ T1/cmtt/m/n/10 . Overfull \hbox (15.5936pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 You may test this value to provide additional control over the operation of your Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 resampling algorithm. Note that the special flag values AST__UR ESAMP1, 2, 3 & Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 4 are reserved for you to use for your own purposes and will no t clash with other Overfull \hbox (56.17503pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 This will be the same value as was given via the " badval" para meter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 , Overfull \hbox (37.11334pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 and will have the same numerical type as the data being process ed (i.e. as elements Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 of the " in" array). It should be used to test for bad pixels i n the input grid Overfull \hbox (15.5936pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 (but only if the AST__USEBAD flag is set via the " flags" param eter) and (unless Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the AST__NOBAD flag is set in " flags" ) for identifying bad ou tput values in Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an array with the same numerical type as the " in" a rray, into which Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the interpolated data values should be returned. Note that deta ils of the storage Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 order and number of dimensions of this array are not required, since the " offset" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 array contains all necessary information about where each retur ned value should Overfull \hbox (5.3586pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 In general, not all elements of this array (or the " out_var" array below) may Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 be used in any particular invocation of the function. Those whi ch are not used Overfull \hbox (26.6159pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an optional array with the same type and size as the " out" array, into Overfull \hbox (20.84232pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 which variance estimates for the resampled values should be ret urned. This array Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 []\T1/cmtt/m/n/10 If given, it is addressed in exactly the same way (via the " offset" array) as Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 the " out" array. The values returned should be estimates of th e statistical Overfull \hbox (15.85603pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 variance of the corresponding values in the " out" array, on th e assumption that Overfull \hbox (42.36206pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 all errors in input data values are statistically independent a nd that their variance Overfull \hbox (16.11847pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 Pointer to an int in which to return the number of interpolatio n points at which Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 no valid interpolated value could be obtained. The maximum valu e that should Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [540] Overfull \hbox (14.44772pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 The data type $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\O ML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 indicates the numerical type of the data bei ng processed, Overfull \hbox (0.37231pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 This function will typically be invoked more than once for each invocation of Overfull \hbox (5.62103pt too wide) in paragraph at lines 33012--33012 [][]\T1/cmtt/m/n/10 If an error occurs within this function, it should use []as tSetStatus[] to set the Overfull \hbox (0.10988pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 AST error status to an error value. This will cause an immediat e return from Overfull \hbox (11.82336pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/i t/10 >$\T1/cmtt/m/n/10 . The error value AST__UINER is available for this purpo se, but Overfull \hbox (10.86975pt too wide) in paragraph at lines 33012--33012 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [541] Overfull \hbox (5.3586pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be the offset of the pixel from the interpolation poi nt, measured in Overfull \hbox (42.36206pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 pixels. This value may be positive or negative, but for most pr actical interpolation Overfull \hbox (20.84232pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be a pointer to the same array as was given via the " params" parameter Overfull \hbox (1.32593pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/ m/it/10 >$\T1/cmtt/m/n/10 . You may use this to pass any additional parameter v alues Overfull \hbox (10.86975pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 required by your kernel, but note that " params[0]" will alread y have been used Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 to specify the number of neighbouring pixels which contribute t o the interpolated Overfull \hbox (49.87657pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 This will be the same value as was given via the " flags" param eter of astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\ T1/cmtt/m/n/10 . Overfull \hbox (15.5936pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 You may test this value to provide additional control over the operation of your Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 function. Note that the special flag values AST__URESAMP1, 2, 3 & 4 are reserved Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 for you to use for your own purposes and will not clash with ot her pre-defined Overfull \hbox (21.36719pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 Pointer to a double to receive the calculated kernel value, whi ch may be positive Overfull \hbox (26.6159pt too wide) in paragraph at lines 33103--33103 [][]\T1/cmtt/m/n/10 Not all functions make good interpolation kernels. In gener al, acceptable kernels Overfull \hbox (0.37231pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 tend to be symmetrical about zero, to have a positive peak (usu ally unity) at Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 zero, and to evaluate to zero whenever the pixel offset has any other integral Overfull \hbox (17.43065pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 value (this ensures that the interpolated values pass through t he original data). Overfull \hbox (5.3586pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 An interpolation kernel may or may not have regions with negati ve values. You Overfull \hbox (5.62103pt too wide) in paragraph at lines 33103--33103 [][]\T1/cmtt/m/n/10 If an error occurs within this function, it should use []as tSetStatus[] to set the Overfull \hbox (0.10988pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 AST error status to an error value. This will cause an immediat e return from Overfull \hbox (11.82336pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 astResample$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/i t/10 >$\T1/cmtt/m/n/10 . The error value AST__UK1ER is available for this purpo se, but Overfull \hbox (10.86975pt too wide) in paragraph at lines 33103--33103 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [542] [543] Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The number of the Frame axis for which a coordinate value is to be read (axis Overfull \hbox (21.36719pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 Pointer to a null-terminated character string containing the fo rmatted coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value. This string may contain additional information following the value to Overfull \hbox (52.8595pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 be read, in which case reading stops at the first character whi ch cannot be interpreted Overfull \hbox (1.94693pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 as part of the value. Any white space before or after the value is discarded. Overfull \hbox (17.74716pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 This function applies to all Frames. See the " Frame Input Form at" section below for Overfull \hbox (18.0096pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The SkyFrame class re-defines the input format to be suitable f or representing angles Overfull \hbox (28.76947pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 and times, with the resulting coordinate value returned in radi ans. See the " SkyFrame Overfull \hbox (44.25319pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The input formats accepted by a FrameSet are determined by its current Frame (as specified Overfull \hbox (19.58421pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The number of characters read from the string in order to obtai n the coordinate value. Overfull \hbox (29.24026pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A function value of zero (and no coordinate value) will be returned, without error, Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Beware that it is possible for a formatting error part-way through an input string Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 to terminate input before it has been completely read, but to y ield a coordinate Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value that appears valid. For example, if a user types " 1.5r6" instead of " Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 1.5e6" , the " r" will terminate input, giving an incorrect coo rdinate value of Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [544] Overfull \hbox (18.74283pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 An error will result if a value is read which appears to ha ve the correct format, Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 but which cannot be converted into a valid coordinate value (fo r instance, because Overfull \hbox (27.56952pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The string " $\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 bad$\OML/ zplm/m/it/10 >$\T1/cmtt/m/n/10 " is recognised as a special case and will yield the coordinate Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 value AST__BAD without error. The test for this string is case- insensitive and Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A function result of zero will be returned and no coordinat e value will be returned Overfull \hbox (5.3586pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 via the " value" pointer if this function is invoked with the A ST error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 A sequence of one or more digits possibly containing a deci mal point, followed Overfull \hbox (10.60732pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The exponent field, if present, consists of " E" or " e" fo llowed by a possibly Overfull \hbox (5.3586pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 An optional sign, followed by between one and three fields representing either Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 degrees, arc-minutes, arc-seconds or hours, minutes, seconds (e .g. " -12 42 03" Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Each field should consist of a sequence of one or more digi ts, which may include Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 leading zeros. At most one field may contain a decimal point, i n which case it Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 is taken to be the final field (e.g. decimal degrees might be g iven as " 124.707" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The first field given may take any value, allowing angles a nd times outside the Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 conventional ranges to be represented. However, subsequent fiel ds must have values Overfull \hbox (47.34834pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Fields may be separated by white space or by " :" (colon), but the choice of separator Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 must be used consistently throughout the value. Additional whit e space may be Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The following field identification characters may be used a s separators to replace Overfull \hbox (31.60219pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 either of those above (or may be appended to the final field), in order to identify Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 the field to which they are appended: " d" ---degrees; " h" --- hours; " m" ---minutes Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 of arc or time; " s" ---seconds of arc or time; " ' " (single q uote)---minutes of Overfull \hbox (0.37231pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 arc; " " " (double quote)---seconds of arc. Either lower or upp er case may be Overfull \hbox (0.37231pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [545] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 The presence of any of the field identification characters " d" , " ' " (single Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 quote) or " " " (double quote) indicates that the value is to b e interpreted as Overfull \hbox (26.6159pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 an angle. Conversely, the presence of " h" indicates that it is to be interpreted Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 as a time (with 24 hours corresponding to 360 degrees). Incompa tible angle/time Overfull \hbox (1.94693pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 identification characters may not be mixed (e.g. " 10h14' 3" " is not valid). Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 The remaining field identification characters and separators do not specify a Overfull \hbox (8.24539pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 If no preference for an angle or a time is expressed anywhe re within the value, Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 it is interpreted as an angle if the Format attribute string as sociated with the Overfull \hbox (31.86462pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 SkyFrame axis generates an angle and as a time otherwise. This ensures that values Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 Fields may be omitted, in which case they default to zero. The remaining fields Overfull \hbox (25.56616pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 may be identified by using appropriate field identification cha racters (see above) Overfull \hbox (42.36206pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 and/or by adding extra colon separators (e.g. " -05m13s" is equ ivalent to " -:05:13" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 ). If a field is not identified explicitly, it is assumed that adjacent fields Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 have been given, after taking account of any extra separator ch aracters (e.g. " Overfull \hbox (0.10988pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 14:25.4s" specifies minutes and seconds, while " 14::25.4s" spe cifies degrees Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 [][]\T1/cmtt/m/n/10 If fields are omitted in such a way that the remaining ones cannot be identified Overfull \hbox (37.11334pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 uniquely (e.g. " 01:02" ), then the first field (either given e xplicitly or implied Overfull \hbox (5.62103pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 by an extra leading colon separator) is taken to be the most si gnificant field Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 that astFormat would produce when formatting a value (using the Format attribute Overfull \hbox (16.11847pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 associated with the SkyFrame axis). By default, this means that the first field Overfull \hbox (31.60219pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 will normally be interpreted as degrees or hours. However, if t his does not result Overfull \hbox (15.85603pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 in consistent field identification, then the last field (either given explicitly Overfull \hbox (58.10822pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 or implied by an extra trailing colon separator) is taken to to be the least significant Overfull \hbox (12.76088pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 This final convention is intended to ensure that values formatt ed by astFormat which Overfull \hbox (52.3887pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 contain less than three fields will be correctly interpreted if read back using astUnformat, Overfull \hbox (1.47614pt too wide) in paragraph at lines 33401--33401 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [546] Overfull \hbox (7.51216pt too wide) in paragraph at lines 33401--33401 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [547] Overfull \hbox (0.10988pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 The number of input and output coordinates (these numbers are n ecessarily the Overfull \hbox (10.86975pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Un itMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 33462--33462 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 33462--33462 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 33462--33462 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [548] Overfull \hbox (26.30504pt too wide) in paragraph at lines 33565--33565 []\T1/cmtt/m/n/10 AstUnitNormMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astUnitN ormMap( int ncoord, const double centre[], const char $\OMS/zplm/m/n/10 ^^C$\T1 /cmtt/m/n/10 options, Overfull \hbox (26.09103pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (21.36719pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Ou tput will include Overfull \hbox (21.10475pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 An array containing the values to be subtracted from the input coordinates before Overfull \hbox (49.1854pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 computing unit vector and norm. A separate value must be suppli ed for each coordinate. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (5.62103pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Un itNormMap. The Overfull \hbox (26.6159pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 syntax used is identical to that for the []astSet[] function an d may include " printf" Overfull \hbox (10.86975pt too wide) in paragraph at lines 33565--33565 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [549] Overfull \hbox (5.62103pt too wide) in paragraph at lines 33565--33565 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 33565--33565 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 33565--33565 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [550] Overfull \hbox (47.61078pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 If non-zero, an error will be reported if the supplied Object, or any Object contained Overfull \hbox (5.3586pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 within the supplied Object, is not currently locked by the runn ing thread. If Overfull \hbox (0.37231pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function attempts to execute even if the global error status is set, but Overfull \hbox (54.43411pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 no further error report will be made if it subsequently fails u nder these circumstances. Overfull \hbox (37.11334pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 All unlocked Objects are excluded from AST context handling until they are re-locked Overfull \hbox (0.10988pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function returns without action if the Object is not c urrently locked by Overfull \hbox (0.37231pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 any thread. If it is locked by the running thread, it is unlock ed. If it is Overfull \hbox (5.62103pt too wide) in paragraph at lines 33627--33627 [][]\T1/cmtt/m/n/10 This function returns without action if the AST library has been built without Overfull \hbox (10.86975pt too wide) in paragraph at lines 33627--33627 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [551] Overfull \hbox (12.76088pt too wide) in paragraph at lines 33662--33662 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [552] Overfull \hbox (44.25319pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 The basic Channel class generates a warning when ever an un-rec ognised item is encountered Overfull \hbox (31.1314pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 whilst reading an []Object[] from an external data source. If S trict is zero (the default), Overfull \hbox (18.27203pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 then unexpected items in the Object description are simply igno red, and any remaining Overfull \hbox (23.52075pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 items are used to construct the returned Object. If Strict is n on-zero, an error will Overfull \hbox (25.09537pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 be reported and a NULL Object pointer returned if any unexpecte d items are encountered. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33764--33764 []\T1/cmtt/m/n/10 As AST continues to be developed, new attributes are added oc casionally to selected Overfull \hbox (39.2669pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 classes. If an older version of AST is used to read external Ob ject descriptions created Overfull \hbox (13.02332pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 by a more recent version of AST, then the Channel class will, b y default, ignore the Overfull \hbox (33.75575pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 new attributes, using the remaining attributes to construct the Object. This is usually Overfull \hbox (13.02332pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 a good thing. However, since external Object descriptions are o ften stored in plain Overfull \hbox (44.25319pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 text, it is possible to edit them using a text editor. This giv es rise to the possibility Overfull \hbox (56.58768pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 of genuine errors in the description due to finger-slips, typos , or simple mis-understanding. Overfull \hbox (7.7746pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 Such inappropriate attributes will be ignored if Strict is left at its default zero Overfull \hbox (59.73691pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 value. This will cause the mis-spelled attribute to revert to i ts default value, potentially Overfull \hbox (7.7746pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 causing subtle changes in the behaviour of application software . If such an effect Overfull \hbox (2.52588pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 is suspected, the Strict attribute can be set non-zero, resulti ng in the erroneous Overfull \hbox (7.51216pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 The returned KeyMap will contain warnings for all conditions li sted in the []Warnings[] Overfull \hbox (33.75575pt too wide) in paragraph at lines 33764--33764 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [553] Overfull \hbox (10.60732pt too wide) in paragraph at lines 33764--33764 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [554] Overfull \hbox (0.37231pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 Pointer to an int whose value is to be used subsequently as the AST inherited Overfull \hbox (26.6159pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 status value. If a NULL pointer is supplied, the AST library wi ll revert to using Overfull \hbox (39.00447pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 Address of the previous error status variable. This may later b e passed back to astWatch Overfull \hbox (18.27203pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 to restore the previous behaviour of the library. (Note that on the first invocation Overfull \hbox (43.46588pt too wide) in paragraph at lines 33817--33817 \T1/cmtt/m/n/10 of astWatch the returned value will be the address of the inter nal error status variable.) Overfull \hbox (1.94693pt too wide) in paragraph at lines 33817--33817 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [555] Overfull \hbox (21.05632pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 AstWcsMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astWcsMap( in t ncoord, int type, int lonax, int latax, const char $\OMS/zplm/m/n/10 ^^C$\T1/ cmtt/m/n/10 options, Overfull \hbox (26.09103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.37231pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th is must be at Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The type of FITS-WCS projection to apply. This should be given using a macro Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 value such as AST__TAN (for a tangent plane projection), where the characters Overfull \hbox (16.11847pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 following the double underscore give the projection type code ( in upper case) as Overfull \hbox (5.3586pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 used in the FITS-WCS " CTYPEi" keyword. You should consult the FITS-WCS paper Overfull \hbox (0.37231pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 for a list of the available projections. The additional code of AST__TPN can Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 be supplied which represents a TAN projection with polynomial c orrection terms Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [556] Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 The index of the latitude axis. This should lie in the range 1 to " ncoord" and Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Wc sMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 If the sky projection to be implemented requires projection p arameter values to Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 be set, then this should normally be done here via the PVi_m at tribute (see the Overfull \hbox (10.60732pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 " Examples" section). Setting values for these parameters is ma ndatory if they Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 Creates a WcsMap that implements a FITS-WCS Mercator project ion on pairs of Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 coordinates, with coordinates 1 and 2 representing the longitud e and latitude Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 respectively. Note that the FITS-WCS Mercator projection does n ot require any Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 [] \T1/cmtt/m/n/10 Creates a WcsMap that implements a FITS-WCS conical equal ar ea projection. The Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 WcsMap acts on points in a 3-dimensional space; coordinates 2 a nd 3 represent Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 longitude and latitude respectively, while the values of coordi nate 1 are Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 copied unchanged. []Projection[] parameter 1 associatyed with t he latitude axis Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 (corresponding to FITS keyword " PV3_1" ) is required and has n o default, so Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 is set explicitly to 40.0 degrees. Projection parameter 2 (corr esponding to Underfull \hbox (badness 10000) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 FITS keyword " PV3_2" ) is required but has a default of zero, so need not be Overfull \hbox (37.11334pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 The forward transformation of a WcsMap converts between FIT S-WCS " native spherical" Overfull \hbox (10.86975pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 and " relative physical" coordinates, while the inverse transfo rmation converts Overfull \hbox (0.10988pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 in the opposite direction. This arrangement may be reversed, if required, by Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 If any set of coordinates cannot be transformed (for exampl e, many projections Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 do not cover the entire celestial sphere), then a WcsMap will y ield coordinate Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 The validity of any projection parameters given via the PVi _m parameter in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 " options" string is not checked by this function. However, the ir validity is Overfull \hbox (15.85603pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 checked when the resulting WcsMap is used to transform coordina tes, and an error Overfull \hbox (36.8509pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [557] Overfull \hbox (5.62103pt too wide) in paragraph at lines 34001--34001 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 34001--34001 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34001--34001 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [558] Overfull \hbox (23.4695pt too wide) in paragraph at lines 34107--34107 []\T1/cmtt/m/n/10 AstWinMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astWinMap( in t ncoord, const double ina[], const double inb[], const double Overfull \hbox (26.09103pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner A of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner B of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner A of th e window in the Overfull \hbox (5.3586pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 An array containing the " ncoord" coordinates of corner B of th e window in the Overfull \hbox (10.86975pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (15.85603pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Wi nMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34107--34107 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 34107--34107 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [559] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34107--34107 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34107--34107 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [560] Overfull \hbox (7.51216pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 If the FitsChan uses a foreign encoding (e.g. FITS-WCS) rather than the native AST Overfull \hbox (28.76947pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 encoding, then storing values in the FitsChan for keywords NAXI S1, NAXIS2, etc., before Overfull \hbox (20.63396pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 The number of Objects written to the Channel by this invocation of astWrite (normally, Overfull \hbox (10.60732pt too wide) in paragraph at lines 34170--34170 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error Overfull \hbox (10.86975pt too wide) in paragraph at lines 34170--34170 [][]\T1/cmtt/m/n/10 Invoking this function will usually cause the sink function associated with the Overfull \hbox (10.86975pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 channel to be called in order to transfer a textual description of the supplied Overfull \hbox (38.68796pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 object to some external data store. However, the FitsChan class behaves differently. Overfull \hbox (0.37231pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 Invoking this function on a FitsChan causes new FITS header car ds to be added Overfull \hbox (21.36719pt too wide) in paragraph at lines 34170--34170 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [561] Overfull \hbox (10.60732pt too wide) in paragraph at lines 34207--34207 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [562] Overfull \hbox (8.56807pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 AstXmlChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astXmlChan( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 ($\OMS/zplm/m/n/10 ^^C$ \T1/cm tt/m/n/10 source)( void ), void ($\OMS/zplm/m/n/10 ^^C$ \T1/cmtt/m/n/10 sink)( const char $\OMS/zplm/m/n/10 ^^C$ Overfull \hbox (0.37231pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a source function that takes no arguments and return s a pointer to Overfull \hbox (18.74283pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 a null-terminated string. If no value has been set for the Sour ceFile attribute, Overfull \hbox (21.36719pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 this function will be used by the XmlChan to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 invocation, it should return a pointer to the next input line r ead from some external Overfull \hbox (16.11847pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 If " source" is NULL and no value has been set for the Source File attribute, the Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a sink function that takes a pointer to a null-termi nated string as Overfull \hbox (29.24026pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 an argument and returns void. If no value has been set for the SinkFile attribute, Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 this function will be used by the XmlChan to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 each invocation, it should deliver the contents of the string s upplied to some Overfull \hbox (0.37231pt too wide) in paragraph at lines 34308--34308 []\T1/cmtt/m/n/10 If " sink" is NULL, and no value has been set for the SinkFil e attribute, the Overfull \hbox (10.86975pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Xm lChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34308--34308 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (8.24539pt too wide) in paragraph at lines 34308--34308 [][]\T1/cmtt/m/n/10 If the external data source or sink uses a character encodi ng other than ASCII, Overfull \hbox (47.34834pt too wide) in paragraph at lines 34308--34308 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [563] Overfull \hbox (5.62103pt too wide) in paragraph at lines 34308--34308 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [564] Overfull \hbox (26.09103pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 The number of coordinate values for each point to be transforme d (i.e. the number Overfull \hbox (0.10988pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of dimensions of the space in which the points will reside). Th e same number Overfull \hbox (37.11334pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 Initial scale factor by which coordinate values should be multi plied (by the forward Overfull \hbox (63.0945pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 transformation) or divided (by the inverse transformation). Thi s factor may subsequently Overfull \hbox (2.99667pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 be changed via the ZoomMap' s []Zoom[] attribute. It may be pos itive or negative, Overfull \hbox (10.86975pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 Pointer to a null-terminated string containing an optional comm a-separated list Overfull \hbox (21.10475pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Zo omMap. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format Overfull \hbox (10.86975pt too wide) in paragraph at lines 34389--34389 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (21.36719pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 of additional arguments may follow it in order to supply values to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for Overfull \hbox (5.62103pt too wide) in paragraph at lines 34389--34389 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked Overfull \hbox (2.26344pt too wide) in paragraph at lines 34389--34389 []\T1/cmtt/m/n/10 The protected interface to this function includes an extra pa rameter at the end of Overfull \hbox (39.2669pt too wide) in paragraph at lines 34389--34389 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [565] [566] [567] [568] [569] [570] [571] [572] [573] [574] [575] [576] [577] [578] [579] [580] [581] [582] [583] [584] [585] [586] [587] [588] Overfull \hbox (37.49187pt too wide) in paragraph at lines 35315--35315 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [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] Overfull \hbox (59.49594pt too wide) in paragraph at lines 40613--40613 \T1/ppl/m/n/10 (-20) takes a sep-a-rate value for each axis of the PcdMap so th at, for in-stance, the set-tings \T1/cmtt/m/n/10 " \T1/ppl/m/n/10 (-20) PcdCen( 1)=345.0,PcdCen(2)=- [710] [711] [712] [713] [714] [715] [716] [717] [718] [719] [720] [721] [722] [723] [724] [725] [726] [727] [728] [729] [730] Overfull \hbox (238.94087pt too wide) in paragraph at lines 41469--41469 \T1/ppl/m/n/10 (-20) the Spitzer Space Tele-scope and is de-scribed in the fol- low-ing doc-u-ment: http://irsa.ipac.caltech.edu/data/SPITZER/docs/files/spitze r/shupeADASS.pdf [731] Overfull \hbox (190.3857pt too wide) in paragraph at lines 41500--41500 \T1/ppl/m/n/10 (-20) a FITS-WCS en-coded header us-ing the []as-tRead[] func-ti on. See http://irsa.ipac.caltech.edu/data/SPITZER/docs/files/spitzer/shupeADASS .pdf [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] Overfull \hbox (146.29462pt too wide) in paragraph at lines 43326--43326 \T1/ppl/m/n/10 (-20) An very in-for-ma-tive de-scrip-tion of these and other ti me scales is avail-able at http://www.ucolick.org/$\OMS/zplm/m/n/10 ^^X$\T1/ppl /m/n/10 (-20) sla/leapsecs/timescales.html. [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] Overfull \hbox (7.12534pt too wide) in paragraph at lines 48167--48167 \T1/ppl/m/n/10 (-20) CAL_GROUP_CENTER, UN-KNOWN-Ref-Pos, EM-BARYCEN-TER, MOON, MER-CURY, VENUS, [851] [852] [853] [854] [855] [856] [857] [858] [859] [860] [861] [862] [863] [864] [865] [866] [867] Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 Underfull \hbox (badness 10000) in paragraph at lines 49040--49040 [868] [869] Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 Underfull \hbox (badness 10000) in paragraph at lines 49205--49205 [870] [871] [872] [873] Overfull \hbox (5.62103pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 Pointer to the null-terminated dynamic string, whose memory has been allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 using an AST memory allocation function. If no space has yet be en allocated for Overfull \hbox (0.10988pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 this string, a NULL pointer may be given and fresh space will b e allocated by Overfull \hbox (10.86975pt too wide) in paragraph at lines 49327--49327 [] \T1/cmtt/m/n/10 Pointer to an integer containing the number of characters in the dynamic string Overfull \hbox (31.33975pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 (excluding the final null). This is used to save repeated searc hing of this string Overfull \hbox (0.37231pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 to determine its length and it defines the point where the new string will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 appended. Its value is updated by this function to include the extra characters Overfull \hbox (0.5835pt too wide) in paragraph at lines 49327--49327 []\T1/cmtt/m/n/10 If " str1" is NULL, the initial value supplied for " $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 nc" will be ignored and Overfull \hbox (10.86975pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 Pointer to a constant null-terminated string, a copy of which i s to be appended Overfull \hbox (28.50703pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 A possibly new pointer to the dynamic string with the new strin g appended (its location Overfull \hbox (33.75575pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 in memory may have to change if it has to be extended, in which case the original memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 is automatically freed by this function). When the string is no longer required, its Overfull \hbox (21.36719pt too wide) in paragraph at lines 49327--49327 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t or if it should fail Overfull \hbox (26.6159pt too wide) in paragraph at lines 49327--49327 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [874] Overfull \hbox (5.62103pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 Pointer to the null-terminated dynamic string, whose memory has been allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 using an AST memory allocation function. If no space has yet be en allocated for Overfull \hbox (0.10988pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 this string, a NULL pointer may be given and fresh space will b e allocated by Overfull \hbox (10.86975pt too wide) in paragraph at lines 49403--49403 [] \T1/cmtt/m/n/10 Pointer to an integer containing the number of characters in the dynamic string Overfull \hbox (31.33975pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 (excluding the final null). This is used to save repeated searc hing of this string Overfull \hbox (0.37231pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 to determine its length and it defines the point where the new string will be Overfull \hbox (16.11847pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 appended. Its value is updated by this function to include the extra characters Overfull \hbox (0.5835pt too wide) in paragraph at lines 49403--49403 []\T1/cmtt/m/n/10 If " str1" is NULL, the initial value supplied for " $\OMS/zp lm/m/n/10 ^^C$\T1/cmtt/m/n/10 nc" will be ignored and Overfull \hbox (10.86975pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 Pointer to a constant null-terminated string, a copy of which i s to be appended Overfull \hbox (37.11334pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (16.11847pt too wide) in paragraph at lines 49403--49403 [] \T1/cmtt/m/n/10 Additional optional arguments (as used by e.g. " printf" ) which specify values Overfull \hbox (64.66911pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 which are to be substituted into the " str2" string in place of any format specifications. Underfull \hbox (badness 10000) in paragraph at lines 49403--49403 Overfull \hbox (28.50703pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 A possibly new pointer to the dynamic string with the new strin g appended (its location Overfull \hbox (33.75575pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 in memory may have to change if it has to be extended, in which case the original memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 is automatically freed by this function). When the string is no longer required, its Overfull \hbox (21.36719pt too wide) in paragraph at lines 49403--49403 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t or if it should fail Overfull \hbox (26.6159pt too wide) in paragraph at lines 49403--49403 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [875] Overfull \hbox (21.10757pt too wide) in paragraph at lines 49524--49524 []\T1/cmtt/m/n/10 int astBrackets( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 text, size_t start, size_t end, char opchar, char clchar, Overfull \hbox (3.9529pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 int strip, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 openat, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 closeat, char $\OMS/zplm/m/n/10 ^ ^C$$^^C$\T1/cmtt/m/n/10 before, char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 in, char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 after Overfull \hbox (10.60732pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 The zero-based index of the first character to be checked withi n " text" . The Overfull \hbox (5.3586pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 The zero-based index of the last character to be checked within " text" . The Overfull \hbox (15.85603pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 whole string is used if " start" is greater than " end" . The l ast character is Overfull \hbox (16.11847pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 If non-zero, leading and trailing spaces are removed from the r eturned " before" Overfull \hbox (7.19565pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Returned holding the zero-based index of the opening bracket. I gnored if NULL. Overfull \hbox (7.19565pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Returned holding the zero-based index of the closing bracket. I gnored if NULL. Overfull \hbox (21.10475pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (10.86975pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came before the opening bracket. This will be a null string " " if the opening Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.36719pt too wide) in paragraph at lines 49524--49524 [] \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came between the opening and closing bracket. This will be a nu ll string " " Overfull \hbox (0.37231pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 if the bracket was empty. The returned pointer should be freed using astFree Overfull \hbox (21.10475pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 Address at which to return a pointer to a null-terminated copy of the string that Overfull \hbox (5.62103pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 came after the opening bracket. This will be a null string " " if the closing Overfull \hbox (26.6159pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [876] Overfull \hbox (7.51216pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 A value of 1 is returned if a correctly bracketed sub-string wa s found. A value of Overfull \hbox (18.27203pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 0 is returned if no bracketed sub-string was found. A value of -1 is returned if too Overfull \hbox (39.2669pt too wide) in paragraph at lines 49524--49524 \T1/cmtt/m/n/10 many closing brackets were found. A value of -2 is returned if too many opening brackets Overfull \hbox (0.10988pt too wide) in paragraph at lines 49524--49524 [][]\T1/cmtt/m/n/10 Any nested brackets within a top-level bracketed sub-string are skipped. Any Overfull \hbox (5.62103pt too wide) in paragraph at lines 49524--49524 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [877] Overfull \hbox (2.26344pt too wide) in paragraph at lines 49572--49572 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated memory Overfull \hbox (10.86975pt too wide) in paragraph at lines 49572--49572 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [878] Overfull \hbox (21.10475pt too wide) in paragraph at lines 49608--49608 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [879] Overfull \hbox (42.36206pt too wide) in paragraph at lines 49652--49652 [] \T1/cmtt/m/n/10 Pointer to the null terminated string to be converted. If this is NULL, the supplied Overfull \hbox (21.10475pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 Pointer to the buffer to receive the converted string. The leng th of this buffer Overfull \hbox (21.36719pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 is given by " blen" . If NULL is supplied for " in" , then the supplied contents Overfull \hbox (5.62103pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 of " out" are converted and written back into " out" over-writi ng the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 If non-zero, the string is converted to upper case. Otherwise i t is converted Overfull \hbox (10.60732pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 The length of the output buffer. Ignored if " in" is NULL. No m ore than " blen Overfull \hbox (44.72398pt too wide) in paragraph at lines 49652--49652 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [880] [881] Overfull \hbox (10.13652pt too wide) in paragraph at lines 49703--49703 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [882] Overfull \hbox (0.10988pt too wide) in paragraph at lines 49744--49744 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [883] Overfull \hbox (0.10988pt too wide) in paragraph at lines 49790--49790 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [884] [885] Overfull \hbox (7.72334pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (13.02332pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a word extracted Overfull \hbox (18.27203pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 from the supplied string. Each of these words will have no lead ing or trailing white Overfull \hbox (31.86462pt too wide) in paragraph at lines 49855--49855 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49855--49855 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [886] Overfull \hbox (7.72334pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (13.02332pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a word extracted Overfull \hbox (31.86462pt too wide) in paragraph at lines 49909--49909 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49909--49909 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [887] Overfull \hbox (35.49646pt too wide) in paragraph at lines 49983--49983 []\T1/cmtt/m/n/10 char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 astChrSplitRE ( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 str, const char $\OMS/zplm/m /n/10 ^^C$\T1/cmtt/m/n/10 regexp, int $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 n, const char $\OMS/zplm/m/n/10 ^^C$$^^C$\T1/cmtt/m/n/10 matchend Overfull \hbox (23.72911pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 The regular expression. See " Template Syntax:" in the []astChr Sub[] prologue. Note, Overfull \hbox (15.85603pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 this function differs from astChrSub in that any equals signs ( =) in the regular Overfull \hbox (26.35347pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A pointer to a location at which to return a pointer to the cha racter that follows Overfull \hbox (21.36719pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 the last character within the supplied test string that matched any parenthesises Overfull \hbox (12.44437pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 sub-section of " regexp" . A NULL pointer is returned if no mat ches were found. Overfull \hbox (15.85603pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A NULL pointer may be supplied if the location of the last matc hing character is Overfull \hbox (7.72334pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 A pointer to a dynamically allocated array containing " $\OMS/z plm/m/n/10 ^^C$\T1/cmtt/m/n/10 n" elements. Each element Overfull \hbox (44.51563pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 is a pointer to a dynamically allocated character string contai ning a sub-string extracted Overfull \hbox (2.52588pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 from the supplied string. The array itself, and the strings wit hin it, should all Overfull \hbox (10.86975pt too wide) in paragraph at lines 49983--49983 [][]\T1/cmtt/m/n/10 If a parenthesised sub-string in the regular expression is matched by more than Overfull \hbox (26.6159pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 one sub-string within the test string, then only the first is r eturned. To return Overfull \hbox (5.62103pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 multiple matches, the regular expression should include multipl e copies of the Overfull \hbox (8.7222pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 parenthesised sub-string (for instance, separated by " .$\OT1/z plm/m/n/10 +$\T1/cmtt/m/n/10 ?" if the intervening Overfull \hbox (31.86462pt too wide) in paragraph at lines 49983--49983 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (5.62103pt too wide) in paragraph at lines 49983--49983 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [888] Overfull \hbox (13.86804pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astChrSub( const c har $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 test, const char $\OMS/zplm/m/n/10 ^^ C$\T1/cmtt/m/n/10 pattern, const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 sub s[], int nsub Overfull \hbox (26.35347pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 An array of strings that are to replace the sections of the tes t string that match Overfull \hbox (37.11334pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 each parenthesised sub-string in " pattern" . The first element of " subs" replaces Overfull \hbox (5.62103pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 the part of the test string that matches the first parenthesise d sub-string in Overfull \hbox (37.11334pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 If " nsub" is zero, then the " subs" pointer is ignored. In t his case, substitution Overfull \hbox (2.99667pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 strings may be specified by appended them to the end of the " p attern" string, Overfull \hbox (36.8509pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 separated by " =" characters. Note, if you need to include a li teral " =" character Overfull \hbox (10.13652pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 A pointer to a dynamically allocated string holding the result of the substitutions, Overfull \hbox (2.52588pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 or NULL if the test string does not match the template string. This string should Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 be freed using []astFree[] when no longer needed. If no substit uions are specified then Overfull \hbox (31.86462pt too wide) in paragraph at lines 50118--50118 [][]\T1/cmtt/m/n/10 A NULL pointer is returned if this function is invoked with the global error status Overfull \hbox (16.11847pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied tes t string does not Overfull \hbox (12.76088pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 The template syntax is a minimal form of regular expression, The quantifiers allowed Overfull \hbox (24.6343pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 are " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 " , " ?" , " $\OT1/ zplm/m/n/10 +$\T1/cmtt/m/n/10 " , " {n}" , " $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 ?" and " $\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 ?" (the last two are non-greed y - they Overfull \hbox (14.59793pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [889] Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 Note, minus signs (" -" ) within brackets have no special signi ficance, so ranges of Overfull \hbox (5.66588pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Multiple template strings can be concatenated, using the " $\ OMS/zplm/m/n/10 j$\T1/cmtt/m/n/10 " character to separate Overfull \hbox (4.1005pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 them. The test string is compared against each one in turn unti l a match is found. Overfull \hbox (39.2669pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Parentheses are used within each template to identify sub-str ings that are to be replaced Overfull \hbox (23.52075pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 If " nsub" is supplied as zero, then substitution strings may be specified by appended Overfull \hbox (7.7746pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 them to the end of the " pattern" string, separated by " =" cha racters. If " nsub" Overfull \hbox (35.5928pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 is not zero, then any substitution strings appended to the end of " pattern" are ignored. Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 []\T1/cmtt/m/n/10 Each element of " subs" may contain a reference to a token of the form " $1" , " $2" Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 , etc. The " $1" token will be replaced by the part of the test string that matched Overfull \hbox (13.02332pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 the first parenthesised sub-string in " pattern" . The " $2" to ken will be replaced Overfull \hbox (2.52588pt too wide) in paragraph at lines 50118--50118 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [890] [891] Overfull \hbox (1.84724pt too wide) in paragraph at lines 50194--50194 []\T1/cmtt/m/n/10 void astFandl_( const char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 text, size_t start, size_t end, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 f, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 l ) Overfull \hbox (10.60732pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 The zero-based index of the first character to be checked withi n " text" . The Overfull \hbox (5.3586pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 The zero-based index of the last character to be checked within " text" . The Overfull \hbox (15.85603pt too wide) in paragraph at lines 50194--50194 \T1/cmtt/m/n/10 whole string is used if " start" is greater than " end" . The l ast character is Overfull \hbox (16.11847pt too wide) in paragraph at lines 50194--50194 [] \T1/cmtt/m/n/10 Returned holding the zero-based index of the first non-sp ace character. Ignored Overfull \hbox (10.86975pt too wide) in paragraph at lines 50194--50194 [] \T1/cmtt/m/n/10 Returned holding the zero-based index of the last non-spa ce character. Ignored Overfull \hbox (42.09962pt too wide) in paragraph at lines 50194--50194 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [892] Overfull \hbox (10.86975pt too wide) in paragraph at lines 50225--50225 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory. An error will res ult if the memory has Overfull \hbox (0.37231pt too wide) in paragraph at lines 50225--50225 \T1/cmtt/m/n/10 not previously been allocated by another function in this modul e. However, a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50225--50225 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [893] Overfull \hbox (10.86975pt too wide) in paragraph at lines 50263--50263 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory. An error will res ult if the memory has Overfull \hbox (0.37231pt too wide) in paragraph at lines 50263--50263 \T1/cmtt/m/n/10 not previously been allocated by another function in this modul e. However, a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50263--50263 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [894] Overfull \hbox (12.44437pt too wide) in paragraph at lines 50326--50326 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if none h as yet been allocated). Overfull \hbox (12.76088pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 If the memory was allocated successfully, a pointer to the star t of the possibly new Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 [][]\T1/cmtt/m/n/10 This function does not free memory once it is allocated, so the size allocated Overfull \hbox (31.60219pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 grows to accommodate the maximum size of the array (or " high w ater mark" ). Other Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 memory handling routines may be used to free the memory (or alt er its size) if Overfull \hbox (15.85603pt too wide) in paragraph at lines 50326--50326 [][]\T1/cmtt/m/n/10 If this function is invoked with the global error status se t, or if it fails for Overfull \hbox (5.62103pt too wide) in paragraph at lines 50326--50326 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [895] Overfull \hbox (7.7746pt too wide) in paragraph at lines 50367--50367 \T1/cmtt/m/n/10 Non-zero if the memory was allocated dynamically. Zero is retur ned if the supplied Overfull \hbox (0.10988pt too wide) in paragraph at lines 50367--50367 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [896] Overfull \hbox (2.26344pt too wide) in paragraph at lines 50408--50408 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated memory Overfull \hbox (10.86975pt too wide) in paragraph at lines 50408--50408 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [897] Overfull \hbox (12.18193pt too wide) in paragraph at lines 50444--50444 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see []ast Tune[] in objectc.c). [898] Overfull \hbox (42.36206pt too wide) in paragraph at lines 50501--50501 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if the pr evious size of the allocated Overfull \hbox (15.85603pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 New size required for the memory region. This may be zero, in w hich case a NULL Overfull \hbox (12.76088pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 If the memory was reallocated successfully, a pointer to the st art of the new memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 region is returned (this may be the same as the original pointe r). If size was given Overfull \hbox (0.10988pt too wide) in paragraph at lines 50501--50501 [][]\T1/cmtt/m/n/10 If this function is invoked with the error status set, or i f it fails for any Overfull \hbox (38.68796pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. Overfull \hbox (16.11847pt too wide) in paragraph at lines 50501--50501 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [899] [900] Overfull \hbox (0.37231pt too wide) in paragraph at lines 50558--50558 [] \T1/cmtt/m/n/10 Pointer to dynamically allocated memory (or NULL if the s ize of the allocated Overfull \hbox (12.76088pt too wide) in paragraph at lines 50558--50558 \T1/cmtt/m/n/10 The allocated size. This will be zero if a NULL pointer was sup plied (no error will Overfull \hbox (0.10988pt too wide) in paragraph at lines 50558--50558 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [901] Overfull \hbox (12.44437pt too wide) in paragraph at lines 50622--50622 [] \T1/cmtt/m/n/10 Pointer to previously allocated memory (or NULL if none h as yet been allocated). Overfull \hbox (26.6159pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 Pointer to the start of the data to be stored. This may be give n as NULL if there Overfull \hbox (55.48386pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 are no data, in which case it will be ignored and this function behaves like []astRealloc[], Overfull \hbox (22.67937pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 The total size of the data to be stored and/or the size of memo ry to be allocated. Overfull \hbox (52.59706pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 This may be zero, in which case the data parameter is ignored, any previously-allocated Overfull \hbox (28.50703pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 If the data were stored successfully, a pointer to the start of the possibly new memory Overfull \hbox (18.27203pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 region is returned (this may be the same as the original pointe r). If size was given Overfull \hbox (0.37231pt too wide) in paragraph at lines 50622--50622 [][]\T1/cmtt/m/n/10 This is a convenience function for use when storing data of arbitrary size in Overfull \hbox (0.37231pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 memory which is to be allocated dynamically. It is appropriate when the size Overfull \hbox (21.36719pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 of the data will not change frequently because the size of the memory region will Overfull \hbox (0.10988pt too wide) in paragraph at lines 50622--50622 [][]\T1/cmtt/m/n/10 If this function is invoked with the error status set, or i f it fails for any Overfull \hbox (38.68796pt too wide) in paragraph at lines 50622--50622 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [902] Overfull \hbox (4.1005pt too wide) in paragraph at lines 50674--50674 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated string. Overfull \hbox (2.52588pt too wide) in paragraph at lines 50674--50674 \T1/cmtt/m/n/10 If the number of characters is zero, a zero-length string is st ill allocated and a Overfull \hbox (10.86975pt too wide) in paragraph at lines 50674--50674 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [903] Overfull \hbox (21.10475pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 Pointer to the array of input characters. The number of charact ers in this array Overfull \hbox (0.10988pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 The number of fixed-length strings in the input character array . This may be Overfull \hbox (0.10988pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 The number of characters in each fixed-length input string. Thi s may be zero Overfull \hbox (2.26344pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 A pointer to the start of the index array, which contains " nel " pointers pointing Overfull \hbox (12.76088pt too wide) in paragraph at lines 50746--50746 []\T1/cmtt/m/n/10 The returned pointer should be passed to astFree to de-alloca te the memory used when Overfull \hbox (2.52588pt too wide) in paragraph at lines 50746--50746 \T1/cmtt/m/n/10 it is no longer required. This will free both the index array a nd the memory used Overfull \hbox (0.37231pt too wide) in paragraph at lines 50746--50746 [][]\T1/cmtt/m/n/10 A NULL pointer will also be returned if the value of " nel" is zero, in which Overfull \hbox (5.62103pt too wide) in paragraph at lines 50746--50746 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [904] Overfull \hbox (5.62103pt too wide) in paragraph at lines 50791--50791 \T1/cmtt/m/n/10 If non-zero, the string is converted to upper case. Otherwise i t is converted Overfull \hbox (4.1005pt too wide) in paragraph at lines 50791--50791 \T1/cmtt/m/n/10 If successful, the function returns a pointer to the start of t he allocated string. Overfull \hbox (10.86975pt too wide) in paragraph at lines 50791--50791 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [905] Underfull \hbox (badness 1490) in paragraph at lines 50860--50860 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, Overfull \hbox (7.69725pt too wide) in paragraph at lines 50835--50892 [][] [906] [907] [908] Underfull \hbox (badness 2103) in paragraph at lines 51029--51029 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the Underfull \hbox (badness 4291) in paragraph at lines 51037--51038 []|\T1/ppl/m/n/10.95 (+20) Only writ-ten if us-ing FITS-AIPS Overfull \hbox (1.56534pt too wide) in paragraph at lines 50998--51049 [][] [909] [910] [911] Underfull \hbox (badness 4713) in paragraph at lines 51205--51205 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the Underfull \hbox (badness 3229) in paragraph at lines 51214--51215 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the Underfull \hbox (badness 2261) in paragraph at lines 51226--51226 []|\T1/ppl/m/n/9 (+20) Used to set the []Epoch[] at-tributes of the Underfull \hbox (badness 1931) in paragraph at lines 51231--51232 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the Underfull \hbox (badness 3657) in paragraph at lines 51240--51241 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 51249--51249 []|\T1/ppl/m/n/9 (+20) Used to set the []Rest-Freq[] at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 51249--51250 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 51255--51255 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 51255--51256 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Overfull \hbox (12.3573pt too wide) in paragraph at lines 51191--51264 [][] [912] [913] [914] [915] [916] [917] [918] [919] [920] [921] [922] [923] [924] [925] [926] [927] [928] [929] [930] [931] [932] [933] [934] Overfull \hbox (36.88722pt too wide) in paragraph at lines 52725--52728 \T1/ppl/m/n/10.95 (-20) class. These are flux-conserving al-ter-na-tives to the ex-ist-ing AST_RESAMPLE/astResample [935] [936] [937] [938] [939] [940] [941] [942] [943] [944] [945] [946] [947] [948] [949] [950] [951] [952] [953] [954] [955] [956] [957] (./sun211.aux ) LaTeX Font Warning: Some font shapes were not available, defaults substituted. LaTeX Warning: There were multiply-defined labels. ) (\end occurred inside a group at level 1) ### simple group (level 1) entered at line 6511 ({) ### bottom level (see the transcript file for additional information) {/usr/share/texlive/texmf-dist/fonts/enc/dvips/base/8 r.enc} Output written on sun211.pdf (979 pages, 2624827 bytes). Transcript written on sun211.log. latex2html -noaddress sun211.tex This is LaTeX2HTML Version 2019 (Released January 1, 2019) by Nikos Drakos, Computer Based Learning Unit, University of Leeds. Revised and extended by: Marcus Hennecke, Ross Moore, Herb Swan and others ...producing markup for HTML version 5.0 Extension: loading /usr/share/latex2html/versions/unicode.pl *** Constructing conversion utf-8 -> Unicode *** HTML version: loading /usr/share/latex2html/versions/html5_0.pl *** processing declarations *** OPENING /build/starlink-ast-8.6.3+dfsg/sun211.tex Note: Working directory is /build/starlink-ast-8.6.3+dfsg/sun211 Note: Images will be generated in /tmp/l2h20458 texexpand V2019 (Released January 1, 2019) Loading /usr/share/latex2html/styles/texdefs.perl... Warning: No implementation found for option: `twoside' for `starlink' package Warning: No implementation found for option: `11pt' for `starlink' package Reading ... %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% *** there was an unmatched closing } at the end of: } ,,,,,++................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Reading aux file: /build/starlink-ast-8.6.3+dfsg/sun211.aux ... Processing macros ...,,,,,,,,,++......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... *** sub wrap_cmd_zref@newlabel failed: Illegal declaration of subroutine main::wrap_cmd_zref at (eval 497) line 1. . *** sub wrap_cmd_hyper@newdestlabel failed: Illegal declaration of subroutine main::wrap_cmd_hyper at (eval 498) line 1. ....... *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** . Cannot find matching bracket for 54053.. *** no brace for \oldcontentsline , before: {\oldnewlabel{<}{{<}{5}}3>> *** using "<" as the argument instead; is this correct? *** .. *** sub wrap_cmd_HyField@AuxAddToFields failed: Illegal declaration of subroutine main::wrap_cmd_HyField at (eval 500) line 1. . *** sub wrap_cmd_HyField@AuxAddToCoFields failed: Illegal declaration of subroutine main::wrap_cmd_HyField at (eval 501) line 1. ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,,.................................................................................................................................................,,...............,,...........................................................................................................................................................,,........................................,,.....,,..........,,.........................,,.....,,.....,,.............................................,,............................................................,,......................................................................................................................................................,,.....,,.............................................,,..............................,,..........,,.............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. Translating ... 0/311:top of sun211: for sun211.html *** translating preamble *** .................... Warning: No implementation found for document class: starlink............. *** preamble done *** ;.,....;.. 1/311:section:.."Introduction" for node1.html ;..;...... 2/311:subsection:.."What Problems Does AST Tackle?" for node2.html ;..,...........;................... 3/311:subsection:.."Other Design Objectives" for node3.html ;..,........,.......,.,..........;....... 4/311:subsection:.."What Does ``AST'' Stand For?" for node4.html ;..;... 5/311:section:.."Overview of AST Concepts" for node5.html ;..; 6/311:subsection:..."Relationships Between Coordinate Systems" for node6.html ;..,,........;........... 7/311:subsection:..."Mappings Available" for node7.html ;..,............;....................................... 8/311:subsection:..."Compound Mappings" for node8.html ;..,,.....,,........,,......;.................. 9/311:subsection:.."Representing Coordinate Systems" for node9.html ;.,,..........,,.......;........................... 10/311:subsection:.."Networks of Coordinate Systems" for node10.html ;.,,.........;................ 11/311:subsection:.."Input/Output Facilities" for node11.html ;............;...................... 12/311:subsection:.."Producing Graphical Output" for node12.html ;.....,,........;.................... 13/311:section:...."How To..." for node13.html ;...;... 14/311:subsection:..."...Obtain and Install AST" for node14.html ;.....; 15/311:subsection:..."...Structure an AST Program" for node15.html ;..,..;........ 16/311:subsection:...."...Build an AST Program" for node16.html ;..,..,....;......... 17/311:subsection:...."...Read a WCS Calibration from a Dataset" for node17.html ;..,....;............................ 18/311:subsection:..."...Validate WCS Information" for node18.html ;..,..;............ 19/311:subsection:..."...Display AST Data" for node19.html ;..,...;............ 20/311:subsection:...."...Convert Between Pixel and World Coordinates" for node20.html ;..,.....;................... 21/311:subsection:...."...Test if a WCS is a Celestial Coordinate System" for node21.html ;...,..;.... 22/311:subsection:...."...Test if a WCS is a Spectral Coordinate System" for node22.html ;.; 23/311:subsection:...."...Format Coordinates for Display" for node23.html ;..,...,.;......................... 24/311:subsection:..."...Display Coordinates as they are Transformed" for node24.html ;..,....;................ 25/311:subsection:..."...Read Coordinates Entered by a User" for node25.html ;...,...;.................. 26/311:subsection:...."...Create a New WCS Calibration" for node26.html ;...,.,...,.,.,.......;......................... 27/311:subsection:...."...Modify a WCS Calibration" for node27.html ;....,.,..,...,...;.......................... 28/311:subsection:...."...Write a Modified WCS Calibration to a Dataset" for node28.html ;...,..................;............................................................ 29/311:subsection:...."...Display a Graphical Coordinate Grid" for node29.html ;.,,.................;.................... 30/311:subsection:...."...Switch to Plot a Different Celestial Coordinate Grid" for node30.html ;...........;............. 31/311:subsection:..."...Give a User Control Over the Appearance of a Plot" for node31.html ;.............;................... 32/311:section:..."An AST Object Primer" for node32.html ;.,...;. 33/311:subsection:.."AST Objects" for node33.html ;....;..... 34/311:subsection:..."Object Creation and Pointers" for node34.html ;.....,...;................ 35/311:subsection:..."The Object Hierarchy" for node35.html ;................;...................... 36/311:subsection:..."Displaying Objects" for node36.html ;..,..........;.................. 37/311:subsection:..."Getting Attribute Values" for node37.html ;.............;.......... 38/311:subsection:..."Setting Attribute Values" for node38.html ;.......................,,,................;.................. 39/311:subsection:..."Testing, Clearing and Defaulting Attributes" for node39.html ;.............;.......... 40/311:subsection:..."Transforming Coordinates" for node40.html ;...............................;............ 41/311:subsection:..."Managing Object Pointers" for node41.html ;........;......... 42/311:subsection:..."AST Pointer Contexts---Begin and End" for node42.html ;............;............... 43/311:subsection:.."Exporting, Importing and Exempting AST Pointers" for node43.html ;...........;........... 44/311:subsection:.."AST Objects within Multi-threaded Applications" for node44.html ;....;............. 45/311:subsubsection:.."Locking AST Objects for Exclusive Use" for node45.html ;.......;...... 46/311:subsubsection:.."AST Pointer Contexts" for node46.html ;...;..... 47/311:subsection:..."Copying Objects" for node47.html ;........;.... 48/311:subsection:.."C Pointer Types" for node48.html ;........,,..,.....,..........;.................... 49/311:subsection:..."Error Detection" for node49.html ;..............................;................. 50/311:subsection:.."Sharing the Error Status" for node50.html ;........;..... 51/311:section:..."Inter-Relating Coordinate Systems (Mappings)" for node51.html ;...;.......... 52/311:subsection:..."The Mapping Class" for node52.html ;.....;......... 53/311:subsection:.."The Mapping Model" for node53.html ;..;....... 54/311:subsection:.."Changing Attributes of a Mapping" for node54.html ;...;....... 55/311:subsection:.."Input and Output Coordinate Numbers" for node55.html ;.......;........ 56/311:subsection:.."Forward and Inverse Transformations" for node56.html ;......;....... 57/311:subsection:..."Inverting Mappings" for node57.html ;........;.......... 58/311:subsection:.."Finding the Rate of Change of a Mapping Output" for node58.html ;.;.. 59/311:subsection:.."Reporting Coordinate Transformations" for node59.html ;...;................. 60/311:subsection:..."Handling Missing (Bad) Coordinate Values" for node60.html ;.......,,..;............... 61/311:subsection:..."Example---the UnitMap" for node61.html ;........;...... 62/311:subsection:..."Example---the PermMap" for node62.html ;..,,................,,,,........,,,...;............... 63/311:section:..."Compound Mappings (CmpMaps)" for node63.html ;..;... 64/311:subsection:..."Combining Mappings in Series" for node64.html ;.,,.,........;................. 65/311:subsection:.."Combining Mappings in Parallel" for node65.html ;..,,........;................... 66/311:subsection:..."The Component Mappings" for node66.html ;....;.............. 67/311:subsection:..."Creating More Complex Mappings" for node67.html ;........;....... 68/311:subsection:..."Example---Transforming Between Two Calibrated Images" for node68.html ;........;......... 69/311:subsection:..."Over-Complex Compound Mappings" for node69.html ;.......;................ 70/311:subsection:..."Simplifying Compound Mappings" for node70.html ;..,,...........,.....;........... 71/311:section:..."Representing Coordinate Systems (Frames)" for node71.html ;...;................... 72/311:subsection:.."The Frame Model" for node72.html ;.,,...;..... 73/311:subsection:..."Creating a Frame" for node73.html ;......;.. 74/311:subsection:..."Using a Frame as a Mapping" for node74.html ;..........;.................... 75/311:subsection:..."Frame Axis Attributes" for node75.html ;...................;.............. 76/311:subsection:..."Frame Attributes" for node76.html ;..,,...........................................................................;.... 77/311:subsection:..."Formatting Axis Values" for node77.html ;........,....;................ 78/311:subsection:..."Normalising Frame Coordinates" for node78.html ;........;.......... 79/311:subsection:..."Reading Formatted Axis Values" for node79.html ;...........,..........................;............... 80/311:subsection:..."Permuting Frame Axes" for node80.html ;.....,,.....;.... 81/311:subsection:.."Selecting Frame Axes" for node81.html ;............;................. 82/311:subsection:..."Calculating Distances, Angles and Offsets" for node82.html ;......,...........,....;............... 83/311:subsection:..."The Domain Attribute" for node83.html ;...,.,....,....,...........;..................... 84/311:subsection:..."Conventions for Domain Names" for node84.html ;.,,,,..,,.....................................;....... 85/311:subsection:..."The Unit Attribute" for node85.html ;...............,,..;................. 86/311:subsubsection:..."The Syntax for Unit Strings" for node86.html ;.....,,,.........,,,,.........,,,....,,,,,,,,,,,,,,,,,,,,............................,,,....,,......;........ 87/311:subsubsection:.."Side-effects of Changing the Unit attribute" for node87.html ;.;... 88/311:section:..."Celestial Coordinate Systems (SkyFrames)" for node88.html ;..;..... 89/311:subsection:.."The SkyFrame Model" for node89.html ;.......;.................... 90/311:subsection:.."Creating a SkyFrame" for node90.html ;......;. 91/311:subsection:.."Specifying a Particular Celestial Coordinate System" for node91.html ;......,..,.;............ 92/311:subsection:.."Attributes which Qualify Celestial Coordinate Systems" for node92.html ;....,,......................;............. 93/311:subsection:.."Using Default SkyFrame Attributes" for node93.html ;...........;......... 94/311:subsection:..."Formatting Celestial Coordinates" for node94.html ;....,,..,,,....................................................,.........;.................... 95/311:subsection:..."Reading Formatted Celestial Coordinates" for node95.html ;...,,.,..,..,,...,..,,.....,,.,,,,,......,,,,,......,,...;............................ 96/311:subsection:.."Representing Offsets from a Specified Sky Position" for node96.html ;...;.... 97/311:section:...."ss_specframesSpectral Coordinate Systems (SpecFrames)" for node97.html ;..;..... 98/311:subsection:.."The SpecFrame Model" for node98.html ;...;................ 99/311:subsection:.."Creating a SpecFrame" for node99.html ;......;. 100/311:subsection:.."Specifying a Particular Spectral Coordinate System" for node100.html ;.....,..;..... 101/311:subsection:.."Attributes which Qualify Spectral Coordinate Systems" for node101.html ;....,,............................;.......... 102/311:subsection:.."Using Default SpecFrame Attributes" for node102.html ;........,..........;........... 103/311:subsection:..."Creating Spectral Cubes" for node103.html ;.......,,,,,,,.;.......... 104/311:subsection:..."Handling Dual-Sideband Spectra" for node104.html ;.,,,..,.,,...,...,,,..,,,,,,.;................. 105/311:section:...."ss_timeframesTime Systems (TimeFrames)" for node105.html ;..;..... 106/311:subsection:.."The TimeFrame Model" for node106.html ;...;................... 107/311:subsection:.."Creating a TimeFrame" for node107.html ;......;. 108/311:subsection:.."Specifying a Particular Time System" for node108.html ;.....,..;...... 109/311:subsection:.."Attributes which Qualify Time Coordinate Systems" for node109.html ;....,,...............;........... 110/311:section:..."Compound Frames (CmpFrames)" for node110.html ;...;.... 111/311:subsection:.."Creating a CmpFrame" for node111.html ;........;.... 112/311:subsection:.."The Attributes of a CmpFrame" for node112.html ;........;................ 113/311:section:..."An Introduction to Coordinate System Conversions" for node113.html ;..;.................. 114/311:subsection:..."Converting between Celestial Coordinate Systems" for node114.html ;..,....................................;............................ 115/311:subsection:..."Converting between Spectral Coordinate Systems" for node115.html ;,,................;................. 116/311:subsection:.."Converting between Time Coordinate Systems" for node116.html ;.; 117/311:subsection:..."Handling SkyFrame Axis Permutations" for node117.html ;......,..,......;............... 118/311:subsection:..."Converting Between Frames" for node118.html ;.........;................. 119/311:subsection:..."The Choice of Alignment System" for node119.html ;..,,,.....;............. 120/311:section:..."Coordinate System Networks (FrameSets)" for node120.html ;.... Cannot find matching bracket for 24775.;............. 121/311:subsection:.."The FrameSet Model" for node121.html ;...,....;..... 122/311:subsection:..."Creating a FrameSet" for node122.html ;..........;...... 123/311:subsection:..."Adding New Frames to a FrameSet" for node123.html ;.................,,.........;....................... 124/311:subsection:..."The Base and Current Frames" for node124.html ;...........;............ 125/311:subsection:..."Referring to the Base and Current Frames" for node125.html ;.......;.............. 126/311:subsection:..."Using a FrameSet as a Mapping" for node126.html ;..........;...................... 127/311:subsection:..."Extracting a Mapping from a FrameSet" for node127.html ;........;....................... 128/311:subsection:..."Using a FrameSet as a Frame" for node128.html ;......,,.........................;............... 129/311:subsection:.."Extracting a Frame from a FrameSet" for node129.html ;......;......... 130/311:subsection:.."Removing a Frame from a FrameSet" for node130.html ;........;............. 131/311:section:..."Higher Level Operations on FrameSets" for node131.html ;.; 132/311:subsection:..."Creating FrameSets with astConvert" for node132.html ;......,,............;.................... 133/311:subsection:..."Converting between FrameSet Coordinate Systems" for node133.html ;.,,..............,...............;.................................. 134/311:subsection:..."Example---Registering Two Images" for node134.html ;...........,..........;......................... 135/311:subsection:..."Re-Defining a FrameSet Coordinate System" for node135.html ;.....,.......,,.......;........... 136/311:subsection:..."Example---Binning an Image" for node136.html ;.,...........;...... 137/311:subsection:..."Maintaining the Integrity of FrameSets" for node137.html ;..........................;................ 138/311:subsection:.."Merging FrameSets" for node138.html ;.,,..............;.......... 139/311:section:..."Saving and Restoring Objects (Channels)" for node139.html ;....;.......... 140/311:subsection:.."The Channel Model" for node140.html ;...;....... 141/311:subsection:..."Creating a Channel" for node141.html ;.......;.......... 142/311:subsection:..."Writing Objects to a Channel" for node142.html ;.......;...... 143/311:subsection:..."Reading Objects from a Channel" for node143.html ;..............;....... 144/311:subsection:.."Saving and Restoring Multiple Objects" for node144.html ;...;...... 145/311:subsection:..."Validating Input" for node145.html ;.,,,,.........;......... 146/311:subsection:.."Storing an ID String with an Object" for node146.html ;...........;........ 147/311:subsection:..."The Textual Output Format" for node147.html ;...............,.,.....;.............. 148/311:subsection:..."Controlling the Amount of Output" for node148.html ;..,........,....;........... 149/311:subsection:..."Controlling Commenting" for node149.html ;.........;... 150/311:subsection:.."Editing Textual Output" for node150.html ;...,....;....... 151/311:subsection:..."Mixing Objects with other Text" for node151.html ;.......;........ 152/311:subsection:..."Reading Objects from Files" for node152.html ;...................;......... 153/311:subsection:..."Writing Objects to Files" for node153.html ;..................;........... 154/311:subsection:..."Reading and Writing Objects to other Places" for node154.html ;...;......... 155/311:section:..."Storing AST Objects in FITS Headers (FitsChans)" for node155.html ;....;............ 156/311:subsection:..."The Native FITS Encoding" for node156.html ;....;........... 157/311:subsection:.."The FitsChan Model" for node157.html ;...,......,......;.............................................. 158/311:subsection:..."Creating a FitsChan" for node158.html ;......;...... 159/311:subsection:..."Addressing Cards in a FitsChan" for node159.html ;................,.;............ 160/311:subsection:..."Writing Native Objects to a FitsChan" for node160.html ;............;........................... 161/311:subsection:..."Extracting Individual Cards from a FitsChan" for node161.html ;.......;.............. 162/311:subsection:.."The Native FitsChan Output Format" for node162.html ;.......,,,.,.,....;...................... 163/311:subsection:..."Adding Individual Cards to a FitsChan" for node163.html ;............;... 164/311:subsection:..."Adding Concatenated Cards to a FitsChan" for node164.html ;......;........ 165/311:subsection:..."Reading Native Objects From a FitsChan" for node165.html ;........;.................... 166/311:subsection:.."Saving and Restoring Multiple Objects in a FitsChan" for node166.html ;....;...... 167/311:subsection:.."Mixing Native Objects with Other FITS Cards" for node167.html ;....;....... 168/311:subsection:..."Finding and Changing Cards in a FitsChan" for node168.html ;..................;........ 169/311:subsection:..."Source and Sink Functions for FitsChans" for node169.html ;....;............................ 170/311:section:..."Using Foreign FITS Encodings" for node170.html ;...;...... 171/311:subsection:..."The Foreign FITS Encodings" for node171.html ;...,,....................................;......... 172/311:subsection:..."Limitations of Foreign Encodings" for node172.html ;..,.......;................. 173/311:subsection:..."Identifying Foreign Encodings on Input" for node173.html ;....................;.......... 174/311:subsection:..."Reading Foreign WCS Information from a FITS Header" for node174.html ;.............,.......;...................................................................... 175/311:subsection:..."Removing WCS Information from FITS Headers---the Destructive Read" for node175.html ;.............;............... 176/311:subsection:..."Propagating WCS Information through Data Processing Steps" for node176.html ;....,.......;..................... 177/311:subsection:..."Writing Foreign WCS Information to a FITS Header" for node177.html ;...............,......;............... 178/311:section:..."Storing AST Objects as XML (XmlChan)" for node178.html ;...........,...........;............ 179/311:subsection:.."Reading IVOA Space-Time-Coordinates XML (STC-X) Descriptions" for node179.html ;.....;............. 180/311:section:..."Reading and writing STC-S descriptions (StcsChans)" for node180.html ;...;..... 181/311:section:..."Creating Your Own Private Mappings (IntraMaps)" for node181.html ;.; 182/311:subsection:.."The Need for Extensibility" for node182.html ;....;.. 183/311:subsection:.."The IntraMap Model" for node183.html ;...;.................. 184/311:subsection:..."Limitations of IntraMaps" for node184.html ;......;... 185/311:subsection:..."Writing a Transformation Function" for node185.html ;..........;........................... 186/311:subsection:..."Registering a Transformation Function" for node186.html ;..........,..;................. 187/311:subsection:.."Creating an IntraMap" for node187.html ;.........;............... 188/311:subsection:..."Restricted Implementations of Transformation Functions" for node188.html ;..........;...... 189/311:subsection:..."Variable Numbers of Coordinates" for node189.html ;..............;......... 190/311:subsection:..."Adapting a Transformation Function to Individual IntraMaps" for node190.html ;........;....... 191/311:subsection:...."MaxTranSimplifying IntraMaps" for node191.html ;...................;.................... 192/311:subsection:..."Writing and Reading IntraMaps" for node192.html ;.....;.............. 193/311:subsection:..."Managing Transformation Functions in Libraries" for node193.html ;.......;......... 194/311:section:..."Producing Graphical Output (Plots)" for node194.html ;..;... 195/311:subsection:.."The Plot Model" for node195.html ;.........;....... 196/311:subsection:.."Plotting Symbols" for node196.html ;.......;.. 197/311:subsection:..."Plotting Geodesic Curves" for node197.html ;............;......... 198/311:subsection:.."Plotting Curves Parallel to Axes" for node198.html ;.......;....... 199/311:subsection:..."Plotting Generalized Curves" for node199.html ;...;...... 200/311:subsection:..."Clipping" for node200.html ;..........;....... 201/311:subsection:.."Using a Plot as a Mapping" for node201.html ;.....;................ 202/311:subsection:.."Using a Plot as a Frame" for node202.html ;...;................. 203/311:subsection:..."Regions of Valid Physical Coordinates" for node203.html ;....;............ 204/311:subsection:.."Plotting Borders" for node204.html ;.......;..... 205/311:subsection:.."Plotting Text" for node205.html ;........;..... 206/311:subsection:..."Plotting a Grid" for node206.html ;......;........ 207/311:subsection:..."Controlling the Appearance of Sub-strings" for node207.html ;.,....;............ 208/311:subsection:..."Producing Logarithmic Axes" for node208.html ;.,.....;.... 209/311:subsection:..."Choosing a Graphics Package" for node209.html ;.,........;.............. 210/311:section:.."Compiling and Linking Software that Uses AST" for node210.html ;...;.. 211/311:subsection:..."Accessing the ``ast.h'' Header File" for node211.html ;......;. 212/311:subsection:..."Linking with AST Facilities" for node212.html ;.........,.,.....;........ 213/311:subsection:.."Building ADAM Applications that Use AST" for node213.html ;......,.......;................... 214/311:section:..."The AST Class Hierarchy" for node214.html ;....;... 215/311:section:..."AST Function Descriptions" for node215.html ;........................,,............................................................................,,.........................................,,,,..........................................................,,,...................................................................,,.................,,,.......................,.....,,,........................,,..................,......,....................,.......................,,......,,,......,,...............,.......................,.................................,..................,...................,,,,..........................................,......................,,,,,,.............................................,............,,,.............................,,,....,,........................................,,..........,,,...........................,,,..............................................................................,,,,................................................,,,,...............,,.........................,....................................................................,,.......................,,,,.......................,..................,,,,.....................................................,,,,.............................................,,....................,,,,...................................,,,,........................,,,........................,,,,.................................................................................................................................................,,..,,,,.................,,,,,,,............................................,..........,......,,.......,,,,,,.......................................,,......................,,,,,,.................,................................,........................................,,...............................,,,,,,,,..............................,.....................,,.................,.......................,,..................,..............,,,,.......................................................,,,,..,......................,............................................................,..........,.................,,.............................................................................................................................................................,,,,.........................................................................................................................................................................,,,,,,...................................,,,,,,.....................................,.................,,,......................,.................,,,..................................................,,.......................,,.....................,,,,.................................................,,,.....................................,,.............,,................,,,,,....,,,,,,...,,,,..,..................................,...........,,,,..........................................,,,,..................,,.,.,.,.,.,.,,.................................,,,,,,,,,...,,,,.............................,,...............................,,..........,,...........................................,,,,..................,,,...................,,..................,,................,,,,...................................,,,,......................,......,.....,.....................................,,................,.............,,................,,..............................,,.................,,.............................,.............,...........,,........................................,,..................................,........,.............................................................................,........,......,,,................,,,..................,,,..........,,,..,.,.........,,,....................................................,,,,,.............................................,............................,.........................................,,.............................,,................,,............,,............,...........,....................................,,,,.......................................,................,,,....................................,,,,,,,,.................................................................,......,,,,..,,,,,...,,,,......,,,,................,,,,,,,,.......,,....................,............,,,,..,,.,,,,.,,,,.,,,,......................................................,...................................,,...............................,..............,,,.............................,....,........................................,,.................,,..........,,,,,,,,....,,,,,,,...........,,.............,,,,,,.....,.............................,,,,,,,,..........,,,,,,,,,,,,...........,,.......,..........,,,,,,.....,...............,..........................,,,,..................,,,,,,,,..........,,,,,,,,,,......,,.............,,,,,,.....,.......................................,,....................,,...................,,................,,.............,,,,,,....,,,,,,,.............,,,,,,.....,................,.................,,,,,,....,,,,,,,..........,,,,,,.....,................,.................,,,,,,,,....,,,,,,..............,,...,,,,,,.....,........................................,,,..............,,,,...........................,,.........,,,..........,............,,,,,.............................,,........................................,,.........................................,,.,,,,.........,,,,,,,,........................,..............................,,.......,,,,,,.....................................,,,.........................,,,,...................................................,,,............,.,...........................................,,,.,,,,..,.,..............................................................,,.,,...........,..,..,,.,.................................,,..,,.,,........................................................................,,...,.,.,.,.............................................,,,,.....,,.,,..,.,...................................,,..................................,,.................,.....................................................................................................................................................................................,,,,,,.,,.,,.,,,,,.,,,,.,,.,,.,,,,.,,.,,.,,,,.,,.,,.,,....................................,.,,.,.,.,,,,.,,,,...,.,..,,.,,.............................,,,..........................,,.................................................,...............,..........................,.......,...,........................,,,......................,..............,,,,..................................................,...........................,.........................,,...,,,,.....................,,,,,,,............................................,...........................................,.........,,............,,,,,,....................................,,...........................,,...................,,,,...........,,.......................,............,...................,,..............................................................................,,,,..............................................................,,,............................................................,,,.................................................................,,,,,..................................................,..............,,,.,,,,..............,,..........................,,.......................................,,......,,,...........................,,,..................................................................................,,,,...........,,..........................................................,,,,,.................................................,...........,.....,,,,.................................,.......,...........,,.............,,............,,,..................,...................,,,.................,,..................................................,,...................,,,,,,,,,,,,,..............................,,,..........,.,,,,,,,,,,,,,,,,,,,,,,,,,,......................................................,,...............................,,,......................................,,...........................,............,,.,,,,.,,,,...............,,,,,,,,,,,,,...............................,.......................................................................................................................................,,,,,,...........,,,,,,.........,,,,..,,.............................,,,,.,,...........................................................,,,,,,...,,,,...................,,,,,,,,,,,,,,...........................................,.................................,,.......,,.......................................................................................................................................,,,,,,...........,,,,................,,.............................................................................................................,,........................................,,.............,,.....................................,,.........,.............................,,...........,,.............................,........,,.......,,.,,,,..,,,,,,,,................,,,,,,,,,,,,,,..............................,.............................................................,,.............................................................................................,,.......,,,,,,................................................,,.,.,,,,,,.,,,,,.,,,.,,.,,,,,.............................................................,,............,,,,...................................................................................................................................................,,,............................,...............,,............................,,,..........................................................,,................................................................,,,,,....,,,,,,,,................................................................................,............,,,,,,,,..............,,.,,..................,,.,.,....,.,............................,,,,,,,,,.................,,.....................,,...................,,,.............................,,..,................,,...............................,,................,,.......................,...........,.........,............,,.............,,.......................................,,.................................................................,,.......................,,................................................................................................................................................................,,..........................................,,.............................................................................................................................................................................................................,,,,..............................,.................,,.......................................................,,.............................................,,..............................,..,..,........................,..,,,,.....,,.............................................................,..,,,,.....,,.............................................................,..,,,,.....,,....................................................,............,..,,,,.....,,....................................................,........................,,,,,,..............................................,,...................................................,,,,,....................................,,,,.............,,.....................,....................,,,,,...........................,,....................,,,....................,,,.........................................................,..........................................................,,..........................................................................................................................................,.,............................................,,.......................................,,...................................,,..........,.....................,...........................,,.......,..................................................................,,,,..................................,.............,,,..............................................................,,,........................................................................,........................,,,............,,,,..........,,,,..........,,,,..........,,,,..........,,,,............,,,,,............,,,.......................,,,,,,.........,,,,,,,,,,,,.................,,.........,,....,,..............................................,,..,,,,.....,,.......................................................,,,,.,,.,,..............,,,,,,..........,,,....,,,,..........,,.................,,,..................,,....................................,,......................................................................................,..........,,.....................................................,,...........................................,,.......................,............,...........................,,,,............................,,.................................,,.......................................,,............................................................................,...............,,..................................,............,,...................,.........................,,,,,,.............................................,,.........................,............;........................................................................................................................................................................................................................................................ 216/311:section:..."AST Attribute Descriptions" for node216.html ;....................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,....................................................,,,,,,,,.................................................................................................................................................................,,,,................................................,,,,,,................................................................................................................................................................................................................,,.,,..............................,.....................................................................................................................................,,,,.,.,,,.,,.,,.,.,.,.,.,.,.,.,.,.,.,,.,,.,.,.........................................................................................................................................,,,,.,,.,,.........................,..........................................................................,.................................................................................................................................................................,..........,...................................................................................................................................................................................................................................................................................................................................,,,,..........................................................................,,,,...........................................................................................................................................................,,......................................................................................................................,........................................................................................................................,.............................................................................................................................................................,............................................................................,...........................................,.............................................,.................................................................................................................................................................................,,,,,,............................................,...................................................................,,..........................................................................................................................................................................................................................................................................................................,...................................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,,,,,,,........................................,,,...............................................................................................................................................................................,.,.,,,.,,,.............,.............,,,,...............................................................,......................................................................................................................................................,..............,,,,.....,,,,.................,...............................,..........................................................................................................................................................................................................................................................................................................,,.,,,,,,.,,,,.,,..,,,,.,,.,,.,,,,.,,.,,.,,...,,.,,,,................................................................................................;........................................................................................................................................................................................................... 217/311:section:..."AST Class Descriptions" for node217.html ;...........................................................................,,,....,,..................................................................................................................................................................................,,,,,,,,,,...............................................................................................................,,,,..........,,,,...............................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,.,,,,......,,,,.,,,,.,,,,.............................................................................................................,,,,.,,,,.,,,,...................................................................................................................................,,,,...,,,,.....,,,,......................................................................,,,,...................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,.............,..........................,,...........................................................,,,,......................................................................................................................................................................................................................................................,............................,.........,...............,.........,.....................,,.....,,........................................................................................................................,,,,........................................................................................................................................................................................................................................................................................;................................................................ 218/311:section:..."UNIX Command Descriptions" for node218.html ;.......................................................................................................................................................................................................................................................;... 219/311:section:..."AST Memory Management and Utility Functions" for node219.html ;.....,.........,..,,,,.,.........................,,,,.,.............................,,,,,,,,,........................................................................,................,................,,,...........................,......,.........,,..............,,..............,.......,,,,..,.............,,....,,,,...,............,,,,,,,.........,....,.............,,,,...,..........................,,,,,..,...,.,.,.,.,.,.,...................,.................................................................,......,,,....................................,,..........,,........,,......................,.............,............................,,...............,......,............,,,...................,,.....................,,,,......................,...............;................................................ 220/311:section:...."FitsWcsCoverageFITS-WCS Coverage" for node220.html ;....;......... 221/311:subsection:.."Paper I - General Linear Coordinates" for node221.html ;..,,.............................................................................;.......... 222/311:subsubsection:.."Requirements for a Successful Write Operation" for node222.html ;.;.... 223/311:subsubsection:..."Use and Choice of CTYPEi keywords" for node223.html ;..;............. 224/311:subsubsection:.."Choice of Reference Point" for node224.html ;.,...;.......... 225/311:subsubsection:.."Choice of Axis Ordering" for node225.html ;,,....;....... 226/311:subsubsection:.."Alternate Axis Descriptions" for node226.html ;..;..... 227/311:subsection:.."Paper II - Celestial Coordinates" for node227.html ;..,,........................................................;....... 228/311:subsubsection:.."Requirements for a Successful Write Operation" for node228.html ;.,..;......... 229/311:subsubsection:.."Choice of LONPOLE/LATPOLE" for node229.html ;.,......,..;.................. 230/311:subsubsection:.."User Defined Fiducial Points" for node230.html ;....;.............. 231/311:subsubsection:.."Common Non-Standard Features" for node231.html ;.,..............;.................. 232/311:subsection:.."Paper III - Spectral Coordinates" for node232.html ;..,,,..........................................................................;....... 233/311:subsubsection:.."Requirements for a Successful Write Operation" for node233.html ;.,...;....... 234/311:subsubsection:.."Common Non-Standard Features" for node234.html ;.,.;. 235/311:subsection:.."Paper IV - Coordinate Distortions" for node235.html ;...;...... 236/311:subsubsection:.."The ``-SIP'' distortion code" for node236.html ;......;........ 237/311:section:...."changes_and_new_featuresRelease Notes" for node237.html ;.; 238/311:subsection:.."Changes Introduced in V1.1" for node238.html ;..,.............;........................................ 239/311:subsection:.."Changes Introduced in V1.2" for node239.html ;..,.,,,,.,,......,,.............;............................. 240/311:subsection:.."Changes Introduced in V1.3" for node240.html ;..,,,,,.........;..... 241/311:subsection:.."Changes Introduced in V1.4" for node241.html ;..,...............;............... 242/311:subsection:.."Changes Introduced in V1.5" for node242.html ;..,...,.....,........,..;..................................... 243/311:subsection:.."Changes Introduced in V1.6" for node243.html ;..,...........,,......;........................ 244/311:subsection:.."Changes Introduced in V1.7" for node244.html ;..,..,.,,...........;................ 245/311:subsection:.."Changes Introduced in V1.8-2" for node245.html ;..,,,,....;........... 246/311:subsection:.."Changes Introduced in V1.8-3" for node246.html ;..,...;.... 247/311:subsection:.."Changes Introduced in V1.8-4" for node247.html ;..,....;..... 248/311:subsection:.."Changes Introduced in V1.8-5" for node248.html ;..,..;.. 249/311:subsection:.."Changes Introduced in V1.8-7" for node249.html ;..,.....;....... 250/311:subsection:.."Changes Introduced in V1.8-8" for node250.html ;..,.....;........ 251/311:subsection:.."Changes Introduced in V1.8-13" for node251.html ;..,.........;................ 252/311:subsection:.."Changes Introduced in V2.0" for node252.html ;.,...,...............;.................................. 253/311:subsection:.."Changes Introduced in V3.0" for node253.html ;..,..,...............................;...................................... 254/311:subsection:.."Changes Introduced in V3.1" for node254.html ;..,..;... 255/311:subsection:.."Changes Introduced in V3.2" for node255.html ;..,...................;................... 256/311:subsection:.."Changes Introduced in V3.3" for node256.html ;..,..........;....... 257/311:subsection:.."Changes Introduced in V3.4" for node257.html ;..,........;........... 258/311:subsection:.."Changes Introduced in V3.5" for node258.html ;..,.........;............ 259/311:subsection:.."Changes Introduced in V3.6" for node259.html ;..,.......;........ 260/311:subsection:.."Changes Introduced in V3.7" for node260.html ;..,..;........ 261/311:subsection:.."Changes Introduced in V4.0" for node261.html ;..,...;.... 262/311:subsection:.."Changes Introduced in V4.1" for node262.html ;..,.,,........;.................. 263/311:subsection:.."Changes Introduced in V4.2" for node263.html ;..,..................;...................... 264/311:subsection:.."Changes Introduced in V4.3" for node264.html ;..,...;... 265/311:subsection:.."Changes Introduced in V4.4" for node265.html ;..,.........;..................... 266/311:subsection:.."Changes Introduced in V4.5" for node266.html ;..,.........;........... 267/311:subsection:.."Changes Introduced in V4.6" for node267.html ;..,.....;...... 268/311:subsection:.."Changes Introduced in V5.0" for node268.html ;..,.....;....... 269/311:subsection:.."Changes Introduced in V5.1" for node269.html ;..,...............;..................... 270/311:subsection:.."Changes Introduced in V5.2" for node270.html ;..,...........;................ 271/311:subsection:.."Changes Introduced in V5.3" for node271.html ;..,....;......... 272/311:subsection:.."Changes Introduced in V5.3-1" for node272.html ;..,.................;.................... 273/311:subsection:.."Changes Introduced in V5.3-2" for node273.html ;..,.......;....... 274/311:subsection:.."Changes Introduced in V5.4-0" for node274.html ;..,.......;....... 275/311:subsection:.."Changes Introduced in V5.5-0" for node275.html ;..,..;..... 276/311:subsection:.."Changes Introduced in V5.6-0" for node276.html ;..,......;....... 277/311:subsection:.."ChangesIntroduced in V5.6-1" for node277.html ;..,....;.... 278/311:subsection:.."Changes Introduced in V5.7-0" for node278.html ;..,.......;.... 279/311:subsection:.."Changes Introduced in V5.7-1" for node279.html ;..,....;....... 280/311:subsection:.."Changes Introduced in V5.7-2" for node280.html ;..,.........;........... 281/311:subsection:.."Changes Introduced in V6.0" for node281.html ;..,......;... 282/311:subsection:.."Changes Introduced in V6.0-1" for node282.html ;..,..,,..;.. 283/311:subsection:.."Changes Introduced in V7.0.0" for node283.html ;..,...;.. 284/311:subsection:.."Changes Introduced in V7.0.1" for node284.html ;..,..; 285/311:subsection:.."Changes Introduced in V7.0.2" for node285.html ;..,..;.. 286/311:subsection:.."Changes Introduced in V7.0.3" for node286.html ;..,......;..... 287/311:subsection:.."Changes Introduced in V7.0.4" for node287.html ;..,..; 288/311:subsection:.."Changes Introduced in V7.0.5" for node288.html ;..,..;.. 289/311:subsection:.."Changes Introduced in V7.0.6" for node289.html ;..,...;. 290/311:subsection:.."Changes Introduced in V7.1.0" for node290.html ;..,.....;......... 291/311:subsection:.."Changes Introduced in V7.1.1" for node291.html ;..,...;...... 292/311:subsection:.."Changes Introduced in V7.2.0" for node292.html ;..,..;.. 293/311:subsection:.."Changes Introduced in V7.3.0" for node293.html ;..,....;........ 294/311:subsection:.."Changes Introduced in V7.3.1" for node294.html ;..,..; 295/311:subsection:.."Changes Introduced in V7.3.2" for node295.html ;..,....;... 296/311:subsection:.."Changes Introduced in V7.3.3" for node296.html ;..,...;... 297/311:subsection:.."Changes Introduced in V7.3.4" for node297.html ;..,...;.. 298/311:subsection:.."Changes Introduced in V8.0.0" for node298.html ;..,.....;. 299/311:subsection:.."Changes Introduced in V8.0.1" for node299.html ;..,..;........ 300/311:subsection:.."Changes Introduced in V8.0.2" for node300.html ;.,.;.. 301/311:subsection:.."Changes Introduced in V8.0.3" for node301.html ;.,..;... 302/311:subsection:.."Changes Introduced in V8.0.4" for node302.html ;.,........;........... 303/311:subsection:.."Changes Introduced in V8.0.5" for node303.html ;.,....;...... 304/311:subsection:.."Changes Introduced in V8.1.0" for node304.html ;.,..; 305/311:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V8.2" for node305.html ;.,...;........ 306/311:subsection:.."Changes Introduced in V8.3" for node306.html ;.,...;... 307/311:subsection:.."Changes Introduced in V8.4" for node307.html ;.,..........;............ 308/311:subsection:.."Changes Introduced in V8.5" for node308.html ;.,.......;............... 309/311:subsection:.."Changes Introduced in V8.6.2" for node309.html ;.,.......;................. 310/311:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V8.6.3" for node310.html ;.,......;... 311/311:sectionstar:.."About this document ..." for node311.html ;;. . Doing footnotes ... Writing image file ... Translating images to PDF using pdflatex ... This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2019/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./images.tex LaTeX2e <2018-12-01> *** processing images *** I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. I/O Error: Couldn't open file 'images.pdf': No such file or directory. Error opening PDF file. Doing section links .................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. Copying navigation icons ... *** Adding document-specific styles *** *********** WARNINGS *********** No implementation found for style `starlink' Substitution of arg to newlabelxx delayed. ? brace missing for \oldcontentsline Unknown commands: stardoccopyright stardocversion htmladdnormallinkfoot sstitem startitlepic stardocdate scfrontmatter includegraphics sstnotes sstparameters htmlref sstexamplesubsection stardocsource sstexamples sstitemlist sstreturnedvalue sstdiylist stardoccategory cleardoublepage xref sstinvocation stardocauthors xlabel sstroutine stardoctitle sstsubsection sstdescription stardocinitials let sstdiytopic sstapplicability stardocnumber stardocmanual htmladdnormallink stardocabstract sstattributetype protected_at_file_at_percent Done. rm -f sun211/sun211.html sun211/WARNINGS make[2]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' dh_installdocs make[1]: Leaving directory '/build/starlink-ast-8.6.3+dfsg' dh_installdocs -Nlibstarlink-ast-doc dh_installchangelogs dh_perl dh_link dh_strip_nondeterminism dh_compress dh_fixperms dh_missing dh_strip dh_makeshlibs dh_shlibdeps dpkg-shlibdeps: warning: symbol astErrorPublic_ used by debian/libstarlink-ast-grf3d0/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: package could avoid a useless dependency if debian/libstarlink-ast-grf3d0/usr/lib/aarch64-linux-gnu/libstarlink_ast_grf3d.so.0.0.0 was not linked against libpthread.so.0 (it uses none of the library's symbols) dpkg-shlibdeps: warning: symbol astGetStatusPtr_ used by debian/libstarlink-ast-err0/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: package could avoid a useless dependency if debian/libstarlink-ast-err0/usr/lib/aarch64-linux-gnu/libstarlink_ast_err.so.0.0.0 was not linked against libpthread.so.0 (it uses none of the library's symbols) dpkg-shlibdeps: warning: symbol astGBBuf used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGCap used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astPutErr_ used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astG3DQch used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGText used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGTxExt used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGQch used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGEBuf used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astGAttr used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: symbol astG3DCap used by debian/libstarlink-ast0/usr/lib/aarch64-linux-gnu/libstarlink_ast.so.0.0.0 found in none of the libraries dpkg-shlibdeps: warning: 9 other similar warnings have been skipped (use -v to see them all) dh_installdeb dh_gencontrol dh_md5sums dh_builddeb dpkg-deb: building package 'libstarlink-ast0-dbgsym' in '../libstarlink-ast0-dbgsym_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast0' in '../libstarlink-ast0_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast-doc' in '../libstarlink-ast-doc_8.6.3+dfsg-1_all.deb'. dpkg-deb: building package 'libstarlink-ast-err0-dbgsym' in '../libstarlink-ast-err0-dbgsym_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast-dev' in '../libstarlink-ast-dev_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast-grf3d0-dbgsym' in '../libstarlink-ast-grf3d0-dbgsym_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast-err0' in '../libstarlink-ast-err0_8.6.3+dfsg-1_arm64.deb'. dpkg-deb: building package 'libstarlink-ast-grf3d0' in '../libstarlink-ast-grf3d0_8.6.3+dfsg-1_arm64.deb'. dpkg-genbuildinfo --build=binary dpkg-genchanges --build=binary >../starlink-ast_8.6.3+dfsg-1_arm64.changes dpkg-genchanges: info: binary-only upload (no source code included) dpkg-source --after-build . dpkg-buildpackage: info: binary-only upload (no source included) I: copying local configuration I: user script /srv/workspace/pbuilder/17241/tmp/hooks/B01_cleanup starting I: user script /srv/workspace/pbuilder/17241/tmp/hooks/B01_cleanup finished I: unmounting dev/ptmx filesystem I: unmounting dev/pts filesystem I: unmounting dev/shm filesystem I: unmounting proc filesystem I: unmounting sys filesystem I: cleaning the build env I: removing directory /srv/workspace/pbuilder/17241 and its subdirectories I: Current time: Fri Aug 14 00:14:34 +14 2020 I: pbuilder-time-stamp: 1597313674